CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

bazel-build-optimization

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

53

Quality

67%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./plugins/developer-essentials/skills/bazel-build-optimization/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

43%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.

Well-structured progressive disclosure with a genuinely useful reference bundle, but the SKILL.md body itself explains Bazel basics Claude already knows while providing no executable commands, flags, or workflows for its six claimed use cases. The real substance is deferred entirely to references/details.md, leaving the top-level file descriptive rather than instructive.

Suggestions

Replace the Key Concepts table and directory tree with one concrete, copy-paste artifact — e.g. a starter .bazelrc with remote-cache flags (`--remote_cache=grpc://...`, `--experimental_remote_downloader`) or a minimal WORKSPACE/BUILD snippet — so the body is actionable on its own.

Add at least one sequenced workflow with a validation checkpoint for the primary use case, e.g. 1. run `bazel profile //...` / analyze-profile, 2. identify the hotspot, 3. apply the fix, 4. re-measure and compare.

Trim the 'Debugging build issues' and 'Migrating to Bazel' bullets or back them with actual steps in the body or a second reference file, since neither currently has any supporting content.

DimensionReasoningScore

Conciseness

The body is short but spends its budget on concepts Claude already knows: a Key Concepts table defining 'Target', 'Package', 'Label', 'Rule', and 'Aspect', plus a generic directory tree of WORKSPACE/BUILD files. This matches anchor 3 (mostly efficient but includes unnecessary explanation) — not anchor 4, because those sections are textbook Bazel fundamentals rather than minor trimming.

3 / 5

Actionability

The body contains no executable code, commands, or config flags — the Do's/Don'ts are high-level hints ('Enable remote caching', 'Use fine-grained targets') without the steps or flags to execute them, matching anchor 2 (minimal concrete guidance, missing specifics). It is not anchor 3, since even pseudocode-level specifics are absent from the body; the concrete templates exist only in references/details.md.

2 / 5

Workflow Clarity

The skill claims six task areas (setup, remote caching/execution, optimization, custom rules, debugging, migration) but sequences none of them — there is no ordered procedure anywhere in the body. This matches anchor 2 (rough shape present via section topics, many gaps, no sequence); the simple-skill exception does not apply because the skill covers multiple claimed processes, not one unambiguous action.

2 / 5

Progressive Disclosure

The body is a lean overview with a single, clearly signaled, one-level-deep reference — 'Full template library and detailed worked examples live in references/details.md. Read that file when you need the concrete templates' — and that file exists and contains complete WORKSPACE/config templates. This matches anchor 5 (clear overview, well-signaled one-level-deep references, appropriate split).

5 / 5

Total

12

/

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 description with an explicit 'Use when...' clause, third-person voice, and distinct Bazel-specific triggers. Its main weakness is thin capability coverage — the 'what' is a single broad action and common trigger terms like 'remote caching' and 'build times' are absent.

Suggestions

Enumerate concrete capabilities in the 'what' clause, e.g. 'Configure remote caching and execution, write custom rules, and tune build times for large-scale Bazel monorepos.'

Add the common trigger terms 'remote caching', 'build times', and 'BUILD/WORKSPACE files' to the 'Use when' clause to match how users actually phrase these requests.

DimensionReasoningScore

Specificity

The description names the domain ('Bazel builds', 'large-scale monorepos') and offers roughly two concrete actions — 'Optimize Bazel builds' and 'implementing remote execution' — but does not enumerate the full capability set (remote caching, custom rules, migration). It matches anchor 3 (domain plus 1-2 concrete actions, not comprehensive) better than anchor 4, which expects several specific listed actions.

3 / 5

Completeness

Both parts are explicit: the 'what' is 'Optimize Bazel builds for large-scale monorepos' and the 'when' is 'Use when configuring Bazel, implementing remote execution, or optimizing build performance for enterprise codebases'. This satisfies anchor 4; it falls short of anchor 5 because the 'what' is a single broad phrase without the multiple concrete trigger-capable actions the top anchor requires.

4 / 5

Trigger Term Quality

Natural phrases users would say are present: 'configuring Bazel', 'implementing remote execution', 'optimizing build performance', 'large-scale monorepos', 'enterprise codebases'. A few common terms are missing — notably 'remote caching' (only 'remote execution' appears), 'BUILD files', and 'build times' — matching anchor 4 (good coverage, a few natural terms missing) rather than anchor 5's comprehensive synonym coverage.

4 / 5

Distinctiveness Conflict Risk

Bazel is a clear niche and every trigger phrase names it explicitly ('configuring Bazel', 'Bazel builds'), so the risk of firing for the wrong skill is minimal — matching anchor 5. It does not sit at anchor 4, since even the most generic phrase ('optimizing build performance') is anchored to 'enterprise codebases' within a Bazel-labeled description.

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

wshobson/agents

Path

plugins/developer-essentials/skills/bazel-build-optimization/SKILL.md

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.