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

Securityby

Passed

No findings from the security scan

Fix and improve this skill with Tessl

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

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

Quality

Content

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

The content is highly actionable with extensive executable examples, but it violates progressive disclosure by inlining what should be reference files into SKILL.md, and lacks sequenced validation workflows for operations that warrant them. Conciseness suffers from restating Bazel basics Claude already knows.

Suggestions

Move the seven code templates into separate reference files under references/ and keep SKILL.md as a concise overview with one-level-deep links, following the '## Quick start / ## Advanced features → See X.md' pattern.

Create the referenced resources/implementation-playbook.md (or fix the path) so the one progressive-disclosure pointer actually resolves to a real file.

Add a concrete sequenced workflow with validation checkpoints for risky operations like remote execution setup and custom rule authoring (e.g., build → query → profile → verify), instead of the generic 'Clarify goals / Apply best practices' bullet list.

Trim the Bazel Architecture tree and Key Concepts table, which restate knowledge Claude already has, to recover token budget.

Dimension	Reasoning	Score
Conciseness	The body is noticeably verbose for a SKILL.md: it inlines seven full code templates (WORKSPACE, .bazelrc, BUILD files, custom rules, query commands, remote execution) that assume little of Claude's existing Bazel knowledge, and includes a concepts table and architecture tree that largely restate what Claude already knows.	2 / 5
Actionability	Provides fully executable, copy-paste-ready code and commands across WORKSPACE config, .bazelrc flags, BUILD files, custom rule implementation, and bazel query invocations, covering the common cases comprehensively.	5 / 5
Workflow Clarity	The 'Instructions' section lists generic steps ('Clarify goals', 'Apply best practices') without a sequenced workflow, and despite covering batch/destructive-adjacent operations (remote execution, custom build rules) there are no validation checkpoints or feedback loops; this caps the score at 3 per the rubric.	3 / 5
Progressive Disclosure	The skill is essentially monolithic — hundreds of lines of templates and references inlined into SKILL.md with no bundle files present, and the one referenced file ('resources/implementation-playbook.md') does not exist in the bundle, leaving content that clearly belongs in separate files inlined.	2 / 5
	Total	12 / 20 Passed

Description

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

The description is well-crafted: it states a clear capability and pairs it with an explicit, trigger-rich 'Use when' clause in third person. It is mostly distinct and specific, with only minor room to broaden trigger synonyms.

Dimension	Reasoning	Score
Specificity	Names the domain and lists several concrete actions — 'configuring Bazel', 'implementing remote execution', 'optimizing build performance' — with only minor coverage gaps (e.g., custom rules mentioned in body but not description).	4 / 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') with concrete trigger phrases.	5 / 5
Trigger Term Quality	Includes natural phrases users would say ('configuring Bazel', 'remote execution', 'optimizing build performance', 'enterprise codebases') with good coverage, though missing common synonyms like 'build times' or 'monorepo builds' in the trigger clause.	4 / 5
Distinctiveness Conflict Risk	Targets a clear niche (Bazel build optimization for large-scale monorepos) with distinct triggers and minimal conflict risk with other skills.	5 / 5
	Total	18 / 20 Passed

Validation

93%

Warnings & errors only

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

Criteria	Description	Result
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-claude/skills/bazel-build-optimization/SKILL.md
Commit: 57c135b

Reviewed: 23 hours ago

Table of Contents

Discovery Implementation Validation

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.