CtrlK
BlogDocsLog inGet started
Tessl Logo

bazel-build-optimization

Optimize Bazel builds for large-scale monorepos. Use when configuring Bazel, implementing remote execution, or optimizing build performance for enterprise codebases.

76

1.34x
Quality

65%

Does it follow best practices?

Impact

94%

1.34x

Average score across 3 eval scenarios

SecuritybySnyk

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./tests/ext_conformance/artifacts/agents-wshobson/developer-essentials/skills/bazel-build-optimization/SKILL.md

The canonical home for this skill is bazel-build-optimization in wshobson/agents

SKILL.md
Quality
Evals
Security

Quality

Content

57%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

A strong, concrete reference for Bazel setup and optimization with highly specific templates, but it reads as a cookbook rather than a skill: it re-explains basics Claude knows, pins volatile version numbers inline, and provides no sequenced workflow or validation steps for the multi-step tasks it claims to cover (migration, debugging, performance tuning). Moving the bulk of the templates into reference files would substantially improve both token efficiency and progressive disclosure.

Suggestions

Replace the Key Concepts table and directory-tree section with a one-line orientation; Claude already knows what Bazel targets, labels, and packages are.

Move the seven templates into references/ files (e.g. references/workspace-setup.md, references/remote-execution.md, references/custom-rules.md) and keep SKILL.md as a concise overview with clearly signaled one-level-deep links.

Add sequenced workflows with validation checkpoints for the promised tasks — e.g. performance tuning: profile with --profile → analyze-profile → fix the top slow actions → re-profile to confirm improvement; migration: start with one package → verify builds green → expand.

DimensionReasoningScore

Conciseness

Mostly efficient template/reference material, but it spends tokens on concepts Claude already knows (the Key Concepts table defining Target/Package/Label/Rule/Aspect, the standard directory tree) and pins time-sensitive versions inline (rules_js-1.34.0, node 20.9.0, rules_python-0.27.0) outside any deprecation section. This fits anchor 3 — some unnecessary explanation that could be trimmed — rather than 4, given the guideline penalty on version numbers and re-explained basics.

3 / 5

Actionability

Seven concrete, mostly executable templates (WORKSPACE, .bazelrc, BUILD files, custom rule, query commands, platform/toolchain defs) with minor gaps: sha256 = "..." placeholders, and Template 3 loads @aspect_rules_ts which Template 1 never declares. That keeps it at anchor 4 (mostly executable, minor gaps) rather than 5 (fully copy-paste ready), and well above anchor 3's pseudocode level.

4 / 5

Workflow Clarity

The skill is organized as a template cookbook rather than a sequenced process: tasks promised in "When to Use" (migration, debugging build issues, optimizing build times) have no ordered steps, and the Performance section lists profiling commands without a profile → diagnose → fix → re-measure loop or any validation checkpoints (e.g. verifying cache hit rates or that a config change didn't break the build). Anchor 3 fits — material is structured but checkpoints and explicit sequences are missing; not 2 because each template is internally coherent and self-contained.

3 / 5

Progressive Disclosure

There is no bundle (no references/, scripts/, or assets/ directories) and roughly 300 lines of templates are inlined in SKILL.md, where the rubric expects them split into one-level-deep reference files. Section headers exist and navigation within the file is reasonable, so this is anchor 3 (some structure, but content that should be separate is inline) rather than 2 (minimal structure) — the sections are clearly labeled and each template is easy to locate.

3 / 5

Total

13

/

20

Passed

Description

73%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A solid, third-person description with a clear what and an explicit "Use when" clause anchored to a well-defined niche. The main weakness is that the capability statement is a single action, leaving concrete skills covered by the body (caching setup, custom rules, migration, dependency analysis) unmentioned as triggers or capabilities.

Suggestions

Expand the capability statement to enumerate concrete actions, e.g. "Configure remote caching/execution, write custom rules, analyze dependency graphs, and profile slow builds."

Add natural trigger variations to the when-clause that the body covers but the description omits: writing custom Bazel rules, migrating a repo to Bazel, and debugging slow or failing builds.

Include user-natural phrases like "build times" or "speed up builds" alongside the formal "optimizing build performance".

DimensionReasoningScore

Specificity

The only stated capability is "Optimize Bazel builds for large-scale monorepos" — one concrete action on a named domain. The "Use when" clause lists scenarios (configuring, remote execution) rather than additional capabilities, so coverage is not comprehensive (no caching, custom rules, or migration mentioned), matching anchor 3; not 4 because it does not list several distinct actions, and not 2 because the domain and action are concrete rather than generic.

3 / 5

Completeness

Explicitly answers both: what ("Optimize Bazel builds for large-scale monorepos") and when ("Use when configuring Bazel, implementing remote execution, or optimizing build performance"). The when-clause is present but partly redundant with the what and omits triggers the body itself covers (custom rules, migration, debugging), so it fits anchor 4 rather than 5, and well above anchor 3 (which requires a missing or only implied when).

4 / 5

Trigger Term Quality

Includes natural terms users would say — "Bazel", "build performance", "remote execution", "monorepos", "enterprise codebases". A few common variations are missing ("build times", "slow builds", "remote caching", "CI"), matching anchor 4 rather than 5, and clearly above anchor 3's partial keyword coverage.

4 / 5

Distinctiveness Conflict Risk

"Bazel" carves out a clear niche with distinct, tool-specific triggers (remote execution, monorepo builds); it is unlikely to fire for non-Bazel build tools or other skills, matching anchor 5.

5 / 5

Total

16

/

20

Passed

Validation

100%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository
Dicklesworthstone/pi_agent_rust
Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.