CtrlK
BlogDocsLog inGet started
Tessl Logo

debugging

Enforces systematic root-cause investigation before any fix attempt, using a four-phase process (investigate, analyze patterns, hypothesize, implement). Use when encountering bugs, test failures, build errors, unexpected behavior, performance problems, or integration issues — especially when under pressure, when a "quick fix" seems obvious, or when previous fix attempts have failed. DO NOT TRIGGER for new feature development or refactoring without a known defect.

72

Quality

88%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

SecuritybySnyk

Passed

No known issues

SKILL.md
Quality
Evals
Security

Quality

Content

77%

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

A well-structured debugging process with strong workflow gating and concrete executable examples, but it carries motivational padding and unverifiable stats that hurt conciseness, and it references bundle files that do not exist.

Suggestions

Trim motivational exhortation and the 'Real-World Impact' stats block, and remove the redundant 'When to Use' section since the frontmatter description already states the triggers.

Create the referenced bundle files (root-cause-tracing.md, defense-in-depth.md, condition-based-waiting.md) or remove the references so readers are not pointed at missing files.

DimensionReasoningScore

Conciseness

The core four-phase process is concrete, but the body is padded with motivational exhortation Claude already knows ('Random fixes waste time and create new bugs', 'Violating the letter of this process is violating the spirit of debugging'), an unverifiable 'Real-World Impact' stats section, and a 'When to Use' block that duplicates the description. Not a 3 because substantial trimming would preserve clarity; not a 1 because the procedural core earns its tokens.

2 / 3

Actionability

Provides concrete numbered phase steps and a copy-paste-ready bash instrumentation block (e.g. 'security list-keychains', 'codesign --sign "$IDENTITY" --verbose=4'), giving specific executable guidance for an instruction-style skill.

3 / 3

Workflow Clarity

The four phases are explicitly gated ('You MUST complete each phase before proceeding to the next') with validation checkpoints (failing test case first, verify fix, count failed attempts) and clear feedback loops back to Phase 1 when a hypothesis fails.

3 / 3

Progressive Disclosure

References to root-cause-tracing.md, defense-in-depth.md, and condition-based-waiting.md are clearly signaled and one level deep, but none of those files exist in the bundle, so navigation is broken. Not a 3 because well-signaled references are undercut by missing targets; not a 1 because the SKILL.md is itself a reasonable overview with clean sectioning rather than a monolithic wall.

2 / 3

Total

10

/

12

Passed

Description

100%

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 states both what it does and when to use it, with natural trigger terms and an explicit negative trigger that sharply reduces conflict risk with adjacent skills.

DimensionReasoningScore

Specificity

Lists multiple concrete actions via the 'four-phase process (investigate, analyze patterns, hypothesize, implement)', matching the anchor for naming several specific concrete actions rather than vague language.

3 / 3

Completeness

Explicitly answers what it does ('Enforces systematic root-cause investigation before any fix attempt, using a four-phase process...') and when to use it ('Use when encountering bugs, test failures...') with explicit triggers.

3 / 3

Trigger Term Quality

Covers natural terms users would say ('bugs, test failures, build errors, unexpected behavior, performance problems, or integration issues') plus situational triggers ('under pressure', 'quick fix seems obvious', 'previous fix attempts have failed').

3 / 3

Distinctiveness Conflict Risk

Occupies a clear debugging/root-cause niche with distinct triggers and an explicit negative trigger ('DO NOT TRIGGER for new feature development or refactoring without a known defect') that prevents misfiring. Not the level below because it is clearly distinguished from generic code skills rather than merely 'somewhat specific'.

3 / 3

Total

12

/

12

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.

Validation16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository
shousper/claude-kit
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.