CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

bug-trace

Find the root cause of a reported bug: take in the report (GitHub issue, Jira ticket, file, or pasted text), trace the failing path hop by hop with each hop's runtime precondition, find the recent change that broke it, and rule out rival explanations. Use for any bug investigation where the cause is not yet known.

Quality

93%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Low

Low-risk findings worth noting

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.

The body is an exemplary instruction-style skill: lean and concrete, with a fully specified intake command, a well-sequenced tracing methodology containing its own validation loops, and a clean split between the overview and a real one-level-deep reference file. No dimension shows a meaningful gap.

DimensionReasoningScore

Conciseness

The ~45-line body contains no filler and no explanation of concepts Claude already knows; every sentence carries skill-specific information (intake command, symptom-splitting policy, sub-agent delegation warning, output contract). It matches the score-5 anchor 'every token earns its place' — the score-4 anchor would require identifiable over-explanation to trim, and none is present.

5 / 5

Actionability

The intake command is copy-paste ready with all flags and value forms (`--issue <N|url> | --jira <KEY|url> | --file <path> | --text "<report>"`), the trace steps name concrete tools with arguments (system-history `analyze.ts --focus` with every path file, `pr.ts --pr N --file <path>` in the reference), and the output section specifies exact enumerated fields and an evidence-level enum (`reproduced`, `traced`, `inferred`). This covers the common cases fully per the score-5 anchor.

5 / 5

Workflow Clarity

A clear numbered sequence (intake → split symptoms → trace → output) with explicit validation checkpoints baked into the method: "Check every precondition against today's code", "Hold at least two explanations, and run the check that separates them", and "Reproduce in the branch browser" are feedback loops, and the evidence-level gate plus the output checklist close the loop. This matches the score-5 anchor; the tracing work is read-only, so the destructive/batch validation cap does not apply.

5 / 5

Progressive Disclosure

Verified against the actual bundle: `references/bug-investigation.md` exists and is well-signaled ("Follow `references/bug-investigation.md`") one level deep with no nested reference chains, and `scripts/bug-intake.ts` exists and is invoked by exact path. The split is appropriate — overview and step summary in SKILL.md, the full investigation brief in the reference, the executable script in scripts/ — matching the score-5 anchor's clear overview with well-signaled one-level-deep references.

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 enumerates the full workflow concretely, includes an explicit and well-scoped 'Use when' trigger clause, and stays lean without padding. The only weakness is modest trigger-term coverage — common synonyms like 'debug' and 'regression' are missing.

DimensionReasoningScore

Specificity

The description lists four concrete, distinct actions — "take in the report (GitHub issue, Jira ticket, file, or pasted text)", "trace the failing path hop by hop with each hop's runtime precondition", "find the recent change that broke it", and "rule out rival explanations" — which comprehensively covers the bug-tracing workflow with no gaps, matching the top anchor. It exceeds the score-4 anchor because there is no missing slice of coverage for this task domain.

5 / 5

Completeness

It explicitly answers both questions: the 'what' is the four concrete actions, and the 'when' is the explicit trigger clause "Use for any bug investigation where the cause is not yet known", which even scopes the trigger (cause unknown). This clearly matches the score-5 anchor with concrete trigger phrases rather than the score-4 anchor's 'when could be more explicit'.

5 / 5

Trigger Term Quality

Natural user phrasings present include "bug", "root cause", "GitHub issue", "Jira ticket", and "bug investigation", giving good keyword coverage. It falls short of the score-5 anchor because common synonyms users would naturally say — "debug", "regression", "error", "crash" — are absent, and only the 'regression' idea is indirectly implied via "the recent change that broke it".

4 / 5

Distinctiveness Conflict Risk

The niche is clear (root-cause tracing of a reported bug, cause not yet known) and the "cause is not yet known" qualifier separates it from fix-oriented sibling skills. It sits at the score-4 anchor rather than 5 because "bug investigation" and "find the root cause" remain broad triggers that a general debugging or bug-fixing skill could also claim, leaving minor overlap risk with closely related skills.

4 / 5

Total

18

/

20

Passed

Validation

81%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 13 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

metadata_version

'metadata.version' is missing

Warning

metadata_field

'metadata' should map string keys to string values

Warning

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

13

/

16

Passed

Repository

BuilderIO/agent-native

Path

.agents/skills/bug-trace/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.