CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

fix-root-cause

Find the true root cause of a reproduced bug by tracing the full data and control path, asking why until reaching the decision that created the bad state, and checking history. Use after reproducing and before planning any fix.

76

Quality

95%

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

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

An exemplary lean, single-purpose skill: a tightly sequenced procedure with concrete commands, an explicit output contract, a failure-recovery rule, and clear exit criteria, all in under 20 lines with no filler. Nothing scores below the top anchor on any dimension.

DimensionReasoningScore

Conciseness

Every line is instruction ('Mark each trust boundary crossed', 'Write one sentence with file:line and confidence') with zero concept explanations or padding; the skill assumes Claude's competence throughout. It is not score 4 because there is nothing that could be trimmed without losing information.

5 / 5

Actionability

The body gives concrete commands ('git log -L / git blame'), an explicit trace path (UI event → request → handler → data write → response → render), a classification taxonomy, an exact output format (file:line with CONFIRMED/SUSPECTED confidence), and a numeric stop rule (3 theories). Though instruction-only, the guidance is fully executable; it is not score 4 because no key execution detail is missing.

5 / 5

Workflow Clarity

A clearly sequenced 7-step procedure with an error-recovery feedback loop (step 7: stop after 3 failed theories and request more evidence), a verification standard (CONFIRMED requires a trace), and an Exit Criteria checklist. Not score 4: validation checkpoints are explicit, not implicit, and the operation is neither destructive nor batch so no cap applies.

5 / 5

Progressive Disclosure

The skill is under 50 lines with a single task and no external references needed, and content is organized into clear sections (Procedure, Exit criteria), satisfying the simple-skill exception. The 'fix-data-repair' and 'qa-recon-risk-map' mentions are cross-skill pointers, not buried or nested references, so there is no navigation burden.

5 / 5

Total

20

/

20

Passed

Description

88%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: it names the domain, three concrete actions, an explicit workflow-position trigger, and a distinct niche in the fix lifecycle. The only weaknesses are a few missing natural trigger synonyms and residual overlap with general debugging vocabulary.

Suggestions

Add one or two natural user phrasings as triggers (e.g., 'when the user asks why a bug happens or wants a diagnosis') to broaden trigger-term coverage.

Sharpen distinctiveness by naming what this skill excludes (e.g., 'not general debugging or reproducing the bug itself') to reduce overlap with debugging skills.

DimensionReasoningScore

Specificity

The description lists three concrete actions — 'tracing the full data and control path', 'asking why until reaching the decision that created the bad state', and 'checking history' — which comprehensively cover the root-cause task. It is not score 4 because there are no meaningful coverage gaps in the actions named.

5 / 5

Completeness

It explicitly answers both what ('Find the true root cause of a reproduced bug by tracing...') and when ('Use after reproducing and before planning any fix') with a concrete, checkable trigger condition. It is not score 4 because the when-clause is already explicit and specific to its workflow position, leaving nothing implicit.

5 / 5

Trigger Term Quality

Natural terms like 'root cause', 'bug', 'reproduced', and 'fix' are present and would be said by users needing this skill, but common variations such as 'debug', 'diagnose', 'regression', or 'why is this happening' are missing. It exceeds score 3 because keyword coverage is good, not merely partial.

4 / 5

Distinctiveness Conflict Risk

The niche — root-causing a reproduced bug after reproduction and before fix planning — is well-delineated and unlikely to fire for unrelated skills. It falls short of score 5 because 'bug' and 'root cause' are common debugging vocabulary, leaving minor overlap risk with closely related debugging/diagnosis skills.

4 / 5

Total

18

/

20

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 — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

itsablabla/qa-bug-agent-skills

Path

skills/fix-root-cause/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.