CtrlK
BlogDocsLog inGet started
Tessl Logo

debugging-bst-build-failures

Use when a BuildStream build fails, when diagnosing element errors, or when reading CI build logs to understand what went wrong

75

Quality

68%

Does it follow best practices?

Impact

Pending

No eval scenarios have been run

SecuritybySnyk

Advisory

Suggest reviewing before use

Optimize this skill with Tessl

npx tessl skill review --optimize ./.opencode/skills/debugging-bst-build-failures/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

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...'

DimensionReasoningScore

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.

DimensionReasoningScore

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.

Validation11 / 11 Passed

Validation for skill structure

No warnings or errors.

Repository
projectbluefin/dakota
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.