CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

arn-code-bug-spec

This skill should be used when the user says "bug spec", "arness code bug spec", "investigate this bug", "help me debug", "trace this bug", "diagnose this issue", "I found a bug", "something is broken", "why is X not working", "fix this bug", "debug this", "why is this not working", or wants to iteratively investigate a bug through guided conversation with diagnostic analysis. Bridges the gap between a bug report and either a direct fix or a structured bug specification for the Arness pipeline.

Quality

87%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

SKILL.md
Quality
Evals
Security

Quality

Content

92%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 well-structured conversational workflow skill: every step is executable with exact commands, agent dispatch conventions, checkpoints, and comprehensive error-recovery paths, while heavy detail is properly offloaded to real, clearly-signaled one-level-deep reference files. The only flaw is avoidable verbatim repetition of the dispatch parenthetical, the diagnosis-flow pointer, and the intro's project-folder description.

DimensionReasoningScore

Conciseness

The body is dense and imperative — no explanation of concepts Claude already knows, and details are pushed to reference files. It is not 5 because of verbatim repetition: the model-dispatch parenthetical "passing the model from `.arness/agent-models/code.md` as the `model` parameter (see … 'Dispatch convention' for fallback)" appears three times, the blockquote "Read …/references/diagnosis-flow.md for the full diagnosis and fix procedure" appears three times, and the opening paragraphs repeat the project-folder and simple/complex-path points.

4 / 5

Actionability

Fully concrete, executable guidance throughout: exact commands (`mkdir -p <plans-dir>/BUGFIX_<name>/reports`, `mkdir -p <specs-dir>/`), named agents with the exact context fields to pass ("Bug description", "Codebase context", "Specific hypothesis"), exact questions to ask, a 6-item result-presentation structure, and ready-to-use user-facing scripts ("I'll create a bug investigation project called `BUGFIX_<name>`. Good?"). As an instruction-only conversational skill, its guidance is copy-paste actionable; nothing remains abstract.

5 / 5

Workflow Clarity

Steps 0–7 are clearly sequenced with explicit validation checkpoints: user confirmation before folder creation ("Good?"), a convergence check in Step 4 ("root cause confirmed + architect validated"), a branching decision point in Step 5, and a dedicated Error Handling section covering inconclusive results, multiple root causes, fixer failure after 3 attempts, user cancellation, vague architect guidance, and spec-write failures with a print-it-manually fallback — feedback loops and error recovery matching the top anchor.

5 / 5

Progressive Disclosure

SKILL.md is a clear overview with four one-level-deep reference files (agent-invocation-guide.md, diagnosis-flow.md, bugfix-plan-template.md, bug-spec-template.md), all verified to exist, each cited in place with well-signaled blockquote pointers ("> Read … for the full diagnosis and fix procedure") and catalogued in a References section with descriptions. Reference files do not nest further, and complexity-assessment details are appropriately deferred to diagnosis-flow.md.

5 / 5

Total

19

/

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 an excellent explicit 'use when' clause and comprehensive natural trigger phrases, written in third person without padding. Its main weakness is that the 'what' is stated as a process summary rather than a list of concrete capabilities, and it misses a few common debugging terms (error, crash, regression).

Suggestions

State the core capabilities as concrete actions rather than a process summary — e.g., 'Investigates reported bugs through iterative agent-assisted diagnosis, validates the fix against system architecture, applies simple fixes directly, and writes a structured bug specification for complex fixes.'

Add a few common debugging trigger phrases such as 'I'm getting an error', 'it crashes', 'regression', or 'stack trace' to broaden natural-term coverage.

Consider trimming near-duplicate triggers ('why is X not working' / 'why is this not working', 'debug this' / 'help me debug') to reduce verbosity without losing coverage.

DimensionReasoningScore

Specificity

"Bridges the gap between a bug report and either a direct fix or a structured bug specification" names the domain plus 1-2 concrete outcomes, but the capability is described processually ("iteratively investigate a bug through guided conversation with diagnostic analysis") rather than as a list of multiple specific concrete actions. It sits at the 'names domain and 1-2 concrete actions' anchor, not 4, because it does not enumerate several distinct actions with only minor gaps.

3 / 5

Completeness

Both questions are answered explicitly: 'when' via "This skill should be used when the user says 'bug spec'…" with a dozen concrete trigger phrases, and 'what' via "iteratively investigate a bug through guided conversation with diagnostic analysis" producing "a direct fix or a structured bug specification for the Arness pipeline". This matches the top anchor ('clearly and explicitly answers both what AND when with concrete trigger phrases'); 4 would require the 'when' to be less explicit than it is.

5 / 5

Trigger Term Quality

"investigate this bug", "help me debug", "trace this bug", "diagnose this issue", "I found a bug", "something is broken", "why is X not working", "fix this bug" — extensive natural synonyms and phrasing variations users would actually say. Not 5 because common debugging terms like "error", "crash", "regression", or "stack trace" are missing, which the 5 anchor's 'comprehensive coverage including synonyms' would expect.

4 / 5

Distinctiveness Conflict Risk

The skill carves a clear niche (Arness bug-spec pipeline: "arness code bug spec", "bug spec") with a distinct artifact outcome, so it is 'mostly distinct' as in the 4 anchor. Not 5 because very generic phrases like "something is broken", "why is this not working", and "help me debug" overlap with any general debugging skill; not 3 because the structured-spec framing and named pipeline keep it well above 'somewhat specific'.

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

AppsVortex/arness

Path

plugins/arn-code/skills/arn-code-bug-spec/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.