CtrlK
BlogDocsLog inGet started
Tessl Logo

skill-debug

Debug issues methodically — use when stuck on errors, test failures, or unexpected behavior

56

Quality

65%

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 ./.claude/skills/skill-debug/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

62%

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

The body offers a clearly sequenced debugging workflow with strong validation and feedback checkpoints, but it is verbose with heavy repetition of the same motivational message and lacks progressive disclosure for a 365-line skill.

Suggestions

Collapse the repeated anti-guessing sections (Iron Law, Red Flags, Common Rationalizations, Bottom Line) into a single concise checklist to cut token waste.

Move the WTF self-regulation score table, octopus integration, and auto-freeze details into reference files and keep the body a concise overview.

Replace illustrative echo instrumentation with a single concrete, copy-paste-ready diagnostic snippet.

DimensionReasoningScore

Conciseness

The ~365-line body restates the anti-guessing message repeatedly across MANDATORY COMPLIANCE, Iron Law, Red Flags, Common Rationalizations, and The Bottom Line, padding it with motivational reinforcement Claude does not need.

2 / 3

Actionability

It supplies concrete commands (git diff, orchestrate.sh, freeze-mode bash) and clear per-phase steps, but some 'instrumentation' examples are illustrative echo shells rather than fully executable routines.

2 / 3

Workflow Clarity

A clear four-phase sequence with a hypothesis-result decision table, explicit Verify/Validate checkpoints, and feedback loops (wrong hypothesis -> Phase 3.1, unclear -> Phase 1) plus a 3-strike rule table.

3 / 3

Progressive Disclosure

Well-organized into headed sections, but it is a single 365-line file with inline content (WTF scoring, octopus integration, auto-freeze) that could be split out and references external non-bundled paths rather than local reference files.

2 / 3

Total

9

/

12

Passed

Description

67%

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 clearly conveys the debugging purpose and includes an explicit 'use when' trigger, but it is light on enumerated concrete actions and only moderately distinctive from adjacent coding skills.

Suggestions

List 2-3 concrete debugging actions (e.g., 'reproduce, isolate root cause, form and test a hypothesis') to raise specificity.

Add common natural-language variations ('X is broken', 'why is X failing', 'fix this bug') to broaden trigger-term coverage within the description.

Sharpen the niche framing so it is less likely to collide with general SWE or test-writing skills.

DimensionReasoningScore

Specificity

Names the debugging domain and the action 'Debug issues methodically' but does not enumerate multiple concrete debugging actions (reproduce, isolate, hypothesize), matching the 'names domain and some actions, but not comprehensive' anchor.

2 / 3

Completeness

Explicitly answers both what ('Debug issues methodically') and when via the 'use when stuck on errors, test failures, or unexpected behavior' clause, satisfying the both what-and-when anchor.

3 / 3

Trigger Term Quality

Phrases like 'stuck on errors, test failures, or unexpected behavior' are natural user terms, but coverage misses common variations ('X is broken', 'why is X failing', 'bug') within the description itself.

2 / 3

Distinctiveness Conflict Risk

'Debug issues methodically' is a recognizable niche, but debugging is broad and could still overlap with general coding, test, and software-engineering skills.

2 / 3

Total

9

/

12

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.

Validation15 / 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
nyldn/claude-octopus
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.