CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

bug-hunter

Systematically finds and fixes bugs using proven debugging techniques. Traces from symptoms to root cause, implements fixes, and prevents regression.

Quality

71%

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 ./skills/bug-hunter/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

63%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, actionable debugging playbook with a genuinely useful 8-step methodology, dragged down by inline reference-style catalogs of basic bug patterns and tooling basics Claude already knows, and no progressive-disclosure split into reference files. Trimming the known-concept sections (or moving them to references/) and adding explicit validation gates would meaningfully raise quality.

Suggestions

Remove or drastically trim the "Common Bug Patterns" and "Debugging Tools" sections — off-by-one errors, `===` vs `==`, unawaited promises, and DevTools/`node --inspect` basics are knowledge Claude already has; keep only patterns specific to the user's codebase.

Move catalog content (bug patterns, tool setup) into a references/ file and keep SKILL.md as the process overview, enabling one-level-deep progressive disclosure.

Frame validation as explicit gates, e.g., "Do not proceed past step 5 until the root cause is confirmed by a passing/failing test" and "If the fix fails, return to step 3 with the new evidence."

DimensionReasoningScore

Conciseness

The core 8-step process and technique sections are tight and example-driven, but roughly a quarter of the body teaches concepts Claude already knows — "Common Bug Patterns" (off-by-one, `==` vs `===`, unawaited promises), the "Debugging Tools" section (DevTools tabs, `node --inspect`, a stock launch.json), and rubber-duck/walk-away advice. That fits "mostly efficient but includes some unnecessary explanation"; it is not a 2 because the majority of the document is lean, actionable methodology rather than padded explanation.

3 / 5

Actionability

Most guidance is executable: concrete bash (git bisect, tail, journalctl), a runnable regression test, a copy-paste launch.json, and specific good-fix vs bad-fix code. Not a 5 because some examples are placeholder fragments (CHECKPOINT inserts, mock data) and the doc-template and logging snippets are illustrative rather than covering the concrete common cases end-to-end.

4 / 5

Workflow Clarity

The 8-step sequence (reproduce → gather evidence → hypothesize → test → root cause → fix → test fix → prevent regression) is clearly ordered, with step 7 acting as a validation checkpoint and "When You're Stuck" providing recovery guidance. Not a 5 because validation is not framed as an explicit gate (e.g., "only proceed when reproduction is confirmed") and there is no stated loop back to an earlier step when a hypothesis is disproven.

4 / 5

Progressive Disclosure

The single SKILL.md is well-sectioned with clear headers and no buried or nested references (none exist), but ~100 lines of catalog content (Common Bug Patterns, Debugging Tools) that would naturally live in reference files is fully inlined, and no bundle files are used to split detail from overview. This matches "some structure but content that should be separate is inline"; it is not a 2 because the structure and navigation within the file are good.

3 / 5

Total

14

/

20

Passed

Description

66%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 solid description with concrete, specific actions and good natural trigger terms, but it lacks any explicit "Use when..." trigger guidance, which caps completeness and leaves a gap between the description and the body's well-written "When to Use This Skill" section. Adding that trigger clause with common user phrases would lift it into the top tier.

Suggestions

Append an explicit trigger clause such as "Use when the user reports a bug, an error, unexpected behavior, or says 'debug this' or 'fix this issue'."

Include common trigger synonyms (error, not working, broken, troubleshoot) so the skill surfaces for the full range of natural user phrasings.

Trim the filler phrase "using proven debugging techniques" in favor of one more concrete capability, e.g., reproducing failures systematically.

DimensionReasoningScore

Specificity

The description lists several concrete actions — "Traces from symptoms to root cause, implements fixes, and prevents regression" — matching the anchor for several specific actions with minor coverage gaps. It is not a 5 because coverage is generic rather than comprehensive (e.g., reproduction and hypothesis testing are absent), and the padding phrase "using proven debugging techniques" adds no concrete capability.

4 / 5

Completeness

The "what" is clear (trace symptoms to root cause, implement fixes, prevent regression), but there is no "Use when..." clause or equivalent explicit trigger guidance, which the judging guidelines cap at 3. It is not a 2 because the "what" is specific rather than vague; it cannot be a 4+ without any explicit "when".

3 / 5

Trigger Term Quality

Natural terms users would say are present: "finds and fixes bugs", "debugging", "root cause", "regression". It falls short of anchor 5 because common variations users actually say — "error", "not working", "troubleshoot", "broken" — are missing, leaving a few natural terms uncovered.

4 / 5

Distinctiveness Conflict Risk

The debugging methodology framing (root-cause tracing, regression prevention) carves a mostly distinct niche with only minor overlap risk against closely related debugging/testing skills. Not 5 because "finds and fixes bugs" is broad enough to compete with any general bug-fix or debugging skill.

4 / 5

Total

15

/

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

administrakt0r/AI-Agents-Safe-Coding-Skills

Path

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