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.

1.27x
Quality

69%

Does it follow best practices?

Impact

97%

1.27x

Average score across 3 eval scenarios

SecuritybySnyk

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./plugins/AI-Agents-Safe-Coding-Skills/skills/bazel-build-optimization/SKILL.md

The canonical home for this skill is bazel-build-optimization in sickn33/agentic-awesome-skills

SKILL.md
Quality
Evals
Security

Quality

Content

47%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 template-rich body with genuinely useful, mostly executable Bazel configurations, but it functions as an inlined reference dump rather than a skill. It lacks any sequenced optimization workflow with validation checkpoints, inlines hundreds of lines that belong in reference files, defers to a nonexistent playbook file, and pads token budget with filler sections and knowledge Claude already has.

Suggestions

Replace the generic Instructions section with a concrete optimization workflow with validation checkpoints, e.g.: 1. Profile: `bazel build //... --profile=profile.json && bazel analyze-profile profile.json` 2. Identify slow actions via `--execution_log_json_file` 3. Apply the relevant fix (caching flags, remote execution, finer-grained targets) 4. Re-profile and confirm the critical path improved.

Move the seven large templates into separate reference files under references/ (e.g. references/workspace-config.md, references/remote-execution.md) and keep a lean overview in SKILL.md; fix or remove the dangling resources/implementation-playbook.md reference, since that file does not exist in the bundle.

Delete the filler 'Do not use this skill when' and 'Key Concepts' sections that restate what Claude already knows, and un-pin or clearly mark time-sensitive version numbers (rules_js 1.34.0, rules_python 0.27.0, node 20.9.0).

DimensionReasoningScore

Conciseness

The bulk is dense, useful code, but several sections restate knowledge Claude already has or are pure filler: the Key Concepts table (Target/Package/Label/Rule/Aspect), the tautological 'Do not use this skill when' section ('The task is unrelated to bazel build optimization'), and the generic Instructions boilerplate ('Clarify goals, constraints, and required inputs'). Pinned time-sensitive version numbers (rules_js 1.34.0, rules_python 0.27.0, node 20.9.0) are not isolated in a deprecation section, which the guidelines say should penalize conciseness, ruling out anchor 4.

3 / 5

Actionability

Mostly executable, concrete guidance: a complete .bazelrc, full BUILD files, a complete custom rule implementation, runnable query commands, and platform/toolchain definitions. Minor gaps keep it from anchor 5: the WORKSPACE template uses placeholder sha256 = "..." (not copy-paste runnable), and several cross-references are dangling (//data:training_data, //:tsconfig.json, //tools/docker:builder, //platforms:linux_x86_64 are used but never defined).

4 / 5

Workflow Clarity

No domain workflow is actually sequenced. The only 'sequence' is the generic Instructions filler ('Clarify goals... Apply relevant best practices and validate outcomes... Provide actionable steps and verification'), which matches anchor 2's 'rough sequence present but many gaps; steps poorly defined; validation absent' — the validation mention carries no concrete checkpoint. The Performance Optimization section lists profiling commands but never orders them into a diagnose -> fix -> re-profile loop, so anchor 3's 'steps listed' for a real process does not apply.

2 / 5

Progressive Disclosure

Roughly 330 lines of templates are inlined in SKILL.md — content that clearly belongs in separate reference files — and the skill's single deferred reference, 'open resources/implementation-playbook.md', points to a file that does not exist anywhere in the bundle (no references/, scripts/, or assets/ directories are present), so the detailed material it defers to is simply missing. This matches anchor 2 ('content that clearly belongs in separate files is inlined'); the section headers prevent a score of 1, but the one reference is broken rather than merely buried, preventing anchor 3.

2 / 5

Total

11

/

20

Passed

Description

78%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 strong description with a clear what, an explicit and concrete 'Use when' clause, third-person voice, and good natural trigger terms. The main weakness is that the capability statement covers only one action directly, leaving several of the skill's stated uses (custom rules, debugging, migration) unrepresented.

Suggestions

Expand the what-clause to enumerate the skill's concrete capabilities, e.g. 'Configure Bazel for large-scale monorepos, set up remote caching and execution, write custom rules, and optimize build performance.'

Add commonly used trigger phrases such as 'build times', 'slow builds', 'remote caching', and 'BUILD files' to the when-clause to broaden natural-term coverage.

DimensionReasoningScore

Specificity

The capability statement is a single concrete action — "Optimize Bazel builds for large-scale monorepos" — while "configuring Bazel, implementing remote execution, or optimizing build performance" are framed as trigger conditions rather than a direct capability enumeration (cf. the anchor-4 example 'Extracts text from PDF files, fills forms, converts pages to images'). It names the domain plus 1-2 concrete actions and is not comprehensive: custom rules, debugging, and migration — core uses the skill body itself lists — are absent, which is more than a 'minor gap', keeping it below anchor 4.

3 / 5

Completeness

It clearly and explicitly answers both questions with concrete trigger phrases: what = "Optimize Bazel builds for large-scale monorepos"; when = "Use when configuring Bazel, implementing remote execution, or optimizing build performance for enterprise codebases". This structurally matches the anchor-5 example ('...Use when working with PDF files or when the user mentions PDFs, forms, or document extraction'); the when-clause is explicit and specific, so anchor 4's 'when could be more explicit' does not apply.

5 / 5

Trigger Term Quality

Good natural keyword coverage: "Bazel", "builds", "monorepos", "remote execution", "build performance", "enterprise codebases", "configuring Bazel" — terms users would plausibly say. A few natural terms are missing ("build times", "slow builds", "remote caching", "BUILD files", "CI"), and there are no synonyms or file extensions, so it does not reach anchor 5's comprehensiveness.

4 / 5

Distinctiveness Conflict Risk

Mostly distinct: Bazel is a specific tool and the niche is clear. Minor overlap risk remains because two when-clauses drop the Bazel qualifier — "implementing remote execution" and "optimizing build performance for enterprise codebases" could also match general remote-execution or build-optimization skills. Not anchor 5, since its example keeps the tool name in every trigger.

4 / 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

administrakt0r/AI-Agents-Safe-Coding-Skills

Path

plugins/AI-Agents-Safe-Coding-Skills/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.