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.

Quality

69%

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 ./skills/bazel-build-optimization/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

51%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 content-rich reference with strong, mostly executable templates, but it reads as a catalog rather than a skill: there is no ordered workflow with validation checkpoints for its risky operations, and significant reference material plus boilerplate sections are inlined into one long file. Conciseness suffers from filler sections and stale pinned versions.

Suggestions

Add a sequenced workflow with explicit validation checkpoints for the skill's main use cases (e.g., migrating to Bazel or optimizing build times): profile with --profile/analyze-profile, record cold/warm cache state and equivalent targets before claiming speedup, then iterate — including a validate-and-retry loop for remote execution changes.

Move the seven templates (WORKSPACE, .bazelrc, BUILD files, custom rule, remote-execution platform setup) into references/ files and keep SKILL.md as a concise overview that links to each, replacing the inline catalog.

Delete the padding: the Key Concepts table defining Target/Package/Label/Rule, the generic "Instructions" bullets, and the "Do not use this skill when" section add tokens without adding information Claude doesn't already have.

DimensionReasoningScore

Conciseness

The bulk is substantive (executable templates, profiling commands), but several sections are padding Claude doesn't need: a Key Concepts table defining Target/Package/Label/Rule, generic "Instructions" boilerplate ("Clarify goals, constraints, and required inputs"), a filler "Do not use this skill when" section, and pinned time-sensitive versions (rules_js-1.34.0, node 20.9.0). Mostly efficient but noticeably loose — fits anchor 3 rather than the noticeably padded anchor 2 since the code content itself earns its place.

3 / 5

Actionability

Concrete, complete code throughout (WORKSPACE, .bazelrc, BUILD files, a full custom rule, query and profiling commands), which is mostly executable guidance with minor gaps. Not anchor 5 because it is not copy-paste ready: sha256 = "..." placeholders, example.com endpoints, and the body's own admission that "Templates are historical fragments, not a runnable workspace" requiring verified checksums and toolchains.

4 / 5

Workflow Clarity

No sequenced multi-step workflow exists anywhere — "Instructions" is unordered generic bullets and the rest is a template catalog — and validation appears only as scattered requirements ("Record cold/warm cache state and equivalent targets before claiming speedup") with no validate→fix→retry loop for risky operations like remote execution. There is some validation guidance, keeping it above anchor 1, but the missing sequence and absent checkpoints place it below anchor 3.

2 / 5

Progressive Disclosure

The body is well-sectioned with clear headers, but ~400 lines inline seven full templates (WORKSPACE, .bazelrc, BUILD files, custom rule, remote-execution setup) that belong in references/ files, and no one-level-deep reference files exist at all. Good structure with content that should be separate inline — matching anchor 3; not anchor 2 because structure is far from minimal.

3 / 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 well-formed description with an explicit 'Use when...' clause, natural Bazel-specific triggers, and low conflict risk. Its main weakness is a thin 'what' — a single generic verb ("optimize") with only a couple of concrete capabilities rather than a comprehensive action list.

DimensionReasoningScore

Specificity

"Optimize Bazel builds" is a single generic action and the concrete named activities ("configuring Bazel", "implementing remote execution") number only about two, partly restating the 'what' rather than covering it comprehensively — matching the anchor for 1-2 concrete actions, not the several specific actions of the level above.

3 / 5

Completeness

Both are answered: what ("Optimize Bazel builds for large-scale monorepos") and an explicit "Use when configuring Bazel, implementing remote execution, or optimizing build performance" with concrete triggers. The 'what' is a single thin action rather than multiple concrete capabilities, so it fits anchor 4 ('when' present but what-side could be more comprehensive) better than anchor 5.

4 / 5

Trigger Term Quality

Natural terms users would say are present — "Bazel", "remote execution", "build performance", "monorepos", "enterprise codebases" — giving good keyword coverage, though a few natural variations ("remote caching", "build times", ".bazelrc") are missing, so it falls short of the comprehensive synonym/extension coverage of anchor 5.

4 / 5

Distinctiveness Conflict Risk

"Bazel" is a distinctly named niche tool and every trigger (configuring Bazel, remote execution for Bazel) is anchored to it, giving a clear niche with minimal conflict risk; only "optimizing build performance for enterprise codebases" is mildly generic, which is not enough overlap to drop to anchor 4.

5 / 5

Total

16

/

20

Passed

Validation

93%

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

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

15

/

16

Passed

Repository

sickn33/agentic-awesome-skills

Path

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.