bazel-build-optimization
Optimize Bazel builds for large-scale monorepos. Use when configuring Bazel, implementing remote execution, or optimizing build performance for enterprise codebases.
Install with Tessl CLI
npx tessl i github:wshobson/agents --skill bazel-build-optimization80
Does it follow best practices?
If you maintain this skill, you can automatically optimize it using the tessl CLI to improve its score:
npx tessl skill review --optimize ./path/to/skillAgent success when using this skill
Validation for skill structure
Discovery
89%Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.
This is a well-structured skill description with explicit 'Use when' triggers and good keyword coverage for Bazel-specific terminology. The main weakness is that the capability list could be more specific about concrete actions (e.g., writing BUILD files, configuring remote caching, setting up CI integration) rather than general optimization language.
Suggestions
Expand the capabilities with more specific actions like 'write BUILD files', 'configure remote caching', 'set up sandboxed execution', or 'debug dependency graphs'
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Names the domain (Bazel builds, monorepos) and some actions (configuring, implementing remote execution, optimizing), but lacks comprehensive specific actions like 'write BUILD files', 'configure caching', or 'set up sandboxing'. | 2 / 3 |
Completeness | Clearly answers both what ('Optimize Bazel builds for large-scale monorepos') and when ('Use when configuring Bazel, implementing remote execution, or optimizing build performance') with explicit trigger guidance. | 3 / 3 |
Trigger Term Quality | Includes natural keywords users would say: 'Bazel', 'monorepo', 'remote execution', 'build performance', 'enterprise codebases'. These are terms developers naturally use when seeking Bazel help. | 3 / 3 |
Distinctiveness Conflict Risk | Highly distinctive with clear niche - Bazel is a specific build system, and the combination of 'monorepo', 'remote execution', and 'enterprise codebases' creates a unique trigger profile unlikely to conflict with other build tools. | 3 / 3 |
Total | 11 / 12 Passed |
Implementation
64%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This skill provides comprehensive, actionable Bazel templates that are production-ready and cover the major use cases well. However, it's overly long for a SKILL.md overview, includes some basic concept explanations Claude doesn't need, and lacks validation workflows for complex multi-step operations like remote execution setup.
Suggestions
Remove the 'Key Concepts' table and 'When to Use This Skill' section - Claude knows Bazel fundamentals and the description already covers use cases
Add validation checkpoints to templates, especially for remote execution setup (e.g., 'Verify connection: bazel build --config=remote-cache //... --dry_run')
Split advanced templates (custom rules, remote execution) into separate reference files and link from a concise overview
Add a troubleshooting section with common error patterns and fixes for remote caching/execution failures
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill includes useful templates but has some unnecessary verbosity like the 'Core Concepts' table explaining basic Bazel terminology Claude already knows, and the 'When to Use This Skill' section that duplicates the description. | 2 / 3 |
Actionability | Provides fully executable, copy-paste ready code templates for WORKSPACE, .bazelrc, BUILD files, custom rules, and query commands. All examples are complete and production-ready. | 3 / 3 |
Workflow Clarity | Templates are well-organized but lack explicit validation checkpoints. For complex operations like remote execution setup or custom rule creation, there are no verification steps or error recovery guidance. | 2 / 3 |
Progressive Disclosure | Content is reasonably structured with clear sections, but it's a monolithic document with 300+ lines. Advanced topics like custom rules and remote execution could be split into separate reference files with links from the main skill. | 2 / 3 |
Total | 9 / 12 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 — 11 / 11 Passed
Validation for skill structure
No warnings or errors.
- 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.