CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

root-cause-tracing

Systematically trace bugs backward through call stack to find original trigger. Use when errors occur deep in execution and you need to trace back to find the original trigger.

Quality

72%

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

Fix and improve this skill with Tessl

tessl review fix ./plugins/root-cause-tracing/skills/root-cause-tracing/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

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

The body teaches a clear, actionable five-step backward-tracing method with executable instrumentation code and a worked example, but it repeats its core example and principle across several sections and includes session-log padding. The 'bisection script' section references a nonexistent script and mischaracterizes the command it shows.

Suggestions

Consolidate redundant sections: fold 'Key Principle' into the Overview, merge 'Real Example' with 'The Tracing Process' (they cover the same git-init case), and drop the session-specific 'Real-World Impact' numbers.

Fix the 'Finding Which Test Causes Pollution' section: either provide an actual bisection script in scripts/ or correct the description to match `bun test --run --bail` behavior.

Add an explicit verification step to the process (e.g., 're-run the full test suite and confirm the pollution is gone') after applying the fix at the source.

DimensionReasoningScore

Conciseness

The language is tight and free of explaining known concepts, but several sections restate earlier material: "Key Principle" repeats the Overview's core principle, "Real Example: Empty projectDir" re-walks the same git-init scenario from "The Tracing Process", and "Real-World Impact" ("1847 tests passed, zero pollution") is session-specific padding. Not a 2 because no section explains concepts Claude already knows and the code earns its place.

3 / 5

Actionability

Concrete, executable guidance throughout: a copy-ready TypeScript instrumentation snippet ("const stack = new Error().stack; console.error('DEBUG git init:', {...})") and runnable commands ("bun test 2>&1 | grep 'DEBUG git init'", "bun test --run --bail | tee test-output.log"). Not a 5 because "Use the bisection script" references a script that does not exist in the bundle, and `bun test --run --bail` does not actually run tests one-by-one as claimed ("Runs tests one-by-one, stops at first polluter").

4 / 5

Workflow Clarity

The five-step sequence (Observe the Symptom → Find Immediate Cause → Ask: What Called this? → Keep Tracing Up → Find Original Trigger) is clearly ordered, with capture/analysis checkpoints (grep the debug output, tee the test log, analyze stacks for test names and line numbers). Not a 5 because the process lacks an explicit verify-the-fix step and the bisection section's description mismatches its command; not a 3 because the sequence is coherent and checkpoints like 'Run and capture' are explicit.

4 / 5

Progressive Disclosure

A single, well-sectioned SKILL.md with clear headers and no bundle files (no references/, scripts/, or assets/ exist), and no nested or buried references — nothing needs external splitting for a single-process debugging skill. Not a 5 because at ~130 lines it exceeds the simple-skill case (under 50 lines), and sections like "Real Example" and "Real-World Impact" could live in a reference file; not a 3 because the structure is unambiguous and easy to navigate.

4 / 5

Total

15

/

20

Passed

Description

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

The description answers both what and when with an explicit 'Use when' clause, but describes essentially one action and misses natural trigger synonyms like 'root cause' and 'stack trace'. It is concise and reasonably distinct from other skills.

Suggestions

Add common trigger synonyms such as 'root cause', 'stack trace', and 'deep in the call stack' to broaden natural keyword coverage.

Enumerate one or two more concrete capabilities (e.g., 'add stack-trace instrumentation' or 'identify which test triggers pollution') to raise specificity.

Expand the 'when' clause with concrete trigger situations (e.g., 'stack trace shows a long call chain', 'unclear where invalid data originated') instead of restating the core action.

DimensionReasoningScore

Specificity

"Systematically trace bugs backward through call stack to find original trigger" names the domain (bug tracing) and one concrete action, but offers no broader set of specific actions (e.g., instrumenting code, analyzing stack traces). It sits above the generic 'Processes PDF files' level but below the 'several specific actions' anchor.

3 / 5

Completeness

Both parts are present: the 'what' ("Systematically trace bugs backward through call stack") and an explicit 'when' ("Use when errors occur deep in execution"). Not a 5 because the 'when' clause is partly circular ("you need to trace back to find the original trigger") and lists few concrete trigger situations; not a 3 because the 'when' is explicit, not merely implied.

4 / 5

Trigger Term Quality

Relevant phrases like "call stack", "errors occur deep in execution", and "trace back" exist, but common natural synonyms users would say — "root cause", "stack trace", "debug" — are missing. Coverage is partial rather than good (4) or comprehensive (5).

3 / 5

Distinctiveness Conflict Risk

Root-cause/backward tracing occupies a clear niche ("trace bugs backward through call stack") with triggers tied to deep execution errors, so it is mostly distinct. Minor overlap risk with general debugging skills keeps it below a 5.

4 / 5

Total

14

/

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

secondsky/claude-skills

Path

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