Use when a BuildStream build fails, when diagnosing element errors, or when reading CI build logs to understand what went wrong
75
68%
Does it follow best practices?
Impact
Pending
No eval scenarios have been run
Advisory
Suggest reviewing before use
Optimize this skill with Tessl
npx tessl skill review --optimize ./.opencode/skills/debugging-bst-build-failures/SKILL.mdQuality
Discovery
37%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 description is essentially a 'Use when...' clause without the 'what it does' component. While it has strong trigger terms specific to BuildStream, it completely fails to describe the skill's actual capabilities, making it impossible for Claude to understand what actions this skill enables.
Suggestions
Add concrete actions the skill performs, e.g., 'Parses BuildStream build logs, identifies failure root causes, explains element dependency errors, and suggests fixes for common build issues.'
Restructure to lead with capabilities before the trigger clause: 'Analyzes BuildStream build failures, parses element logs, and diagnoses dependency issues. Use when...'
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | The description uses vague language like 'diagnosing element errors' and 'understand what went wrong' without listing concrete actions. It doesn't specify what the skill actually does (e.g., parse logs, identify error patterns, suggest fixes). | 1 / 3 |
Completeness | The description only addresses 'when' to use the skill but completely omits 'what' the skill actually does. There's no explanation of capabilities or actions performed. | 1 / 3 |
Trigger Term Quality | Contains good natural trigger terms users would say: 'BuildStream', 'build fails', 'element errors', 'CI build logs'. These are specific domain terms that users working with BuildStream would naturally use. | 3 / 3 |
Distinctiveness Conflict Risk | The BuildStream-specific terminology provides some distinctiveness, but 'CI build logs' and 'build fails' could overlap with other build system debugging skills. The lack of specific capabilities makes it harder to distinguish. | 2 / 3 |
Total | 7 / 12 Passed |
Implementation
100%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This is an excellent debugging skill that efficiently covers all BuildStream failure categories with actionable diagnostic commands and clear cause-fix mappings. The structure progresses logically from quick reference through detailed failure categories to CI-specific debugging, with appropriate cross-references to related skills.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The content is highly efficient with tables, quick reference commands, and categorized failure modes. No unnecessary explanations of concepts Claude would already know; every section provides actionable information. | 3 / 3 |
Actionability | Provides specific, executable commands throughout (e.g., `just bst artifact log <element>`, `just bst shell --build <element>`). Tables map symptoms directly to causes and fixes with concrete solutions. | 3 / 3 |
Workflow Clarity | The diagnostic flowchart provides clear sequencing, and the 'General Debugging Workflow' section gives explicit numbered steps with validation checkpoints (e.g., 'Clear cache if needed' before rebuilding). Each failure category includes debug commands as verification steps. | 3 / 3 |
Progressive Disclosure | Well-organized with quick reference table at top, categorized sections for different failure types, and clear references to related skills at the bottom. Content is appropriately structured without deep nesting. | 3 / 3 |
Total | 12 / 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.
f062bf8
Table of Contents
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.