CtrlK
BlogDocsLog inGet started
Tessl Logo

structured-debugging

Hypothesis-driven debugging methodology for hard bugs. Use this skill whenever you're investigating non-trivial bugs, unexpected behavior, flaky tests, or tracing issues through complex systems. Activate proactively when debugging requires more than a quick glance — especially when the first attempt at a fix didn't work, when behavior seems "impossible", or when you're tempted to blame an external system (model, API, library) without evidence.

72

Quality

89%

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

SKILL.md
Quality
Evals
Security

Quality

Content

88%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 high-quality, well-structured methodology with clear sequencing, explicit validation/feedback loops, and concrete templates. Conciseness is good but has some trimmable motivating prose, and the dangling reference to a non-existent examples file is the main progressive-disclosure gap.

Suggestions

Either create the referenced examples file (examples/headless-bg-agent-empty-stdout.md) or remove the Worked examples pointer so navigation is not broken.

Trim motivating prose in the intro and failure-mode intros (e.g. "This fails more often than it works...", "Worse, after several failed attempts...") to tighten conciseness toward a 5.

DimensionReasoningScore

Conciseness

It is largely efficient and assumes Claude's competence (no explanation of what a debugger or console.log is), but includes some motivating prose that could be trimmed (e.g. "This fails more often than it works...", "Worse, after several failed attempts you lose track..."). It sits above anchor 3 but not fully lean enough for 5.

4 / 5

Actionability

Concrete, actionable guidance throughout — a bad/good hypothesis rewrite, a named side-note investigation journal, the values-over-presence-checks rule, a data-collection traps checklist, and a copy-paste exit template (Root cause / Evidence / Fix). As an instruction-only skill, the absence of code is not penalized because the guidance is specific and covers common cases.

5 / 5

Workflow Clarity

A clearly sequenced six-step cycle (Hypothesize → Design Instrumentation → Verify Data Collection → Run and Observe → Document Findings → Iterate) with explicit validation checkpoints ("believe the data" when it contradicts the hypothesis, exit only with confirming evidence) and feedback loops (iterate, step back after 3 rounds), matching the 5 anchor.

5 / 5

Progressive Disclosure

Well-organized with clear section headers and a self-contained body, but it signals a worked-examples reference (`examples/headless-bg-agent-empty-stdout.md`) that is not present in the bundle, a minor navigation gap that keeps it below 5.

4 / 5

Total

18

/

20

Passed

Description

90%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, trigger-rich description that clearly answers what and when and is highly distinctive. The only weakness is second-person voice, which costs a specificity point per the rubric guideline.

DimensionReasoningScore

Specificity

It names the domain and the core method ("Hypothesis-driven debugging methodology for hard bugs") but does not enumerate multiple discrete concrete actions; it leans more on when-to-use than on a list of capabilities. The second-person voice ("whenever you're investigating") triggers the −1 specificity penalty, holding it at 3 rather than 4.

3 / 5

Completeness

It explicitly states both the what ("Hypothesis-driven debugging methodology for hard bugs") and the when ("Use this skill whenever... Activate proactively when...") with concrete trigger phrases, matching the 5 anchor.

5 / 5

Trigger Term Quality

It covers a comprehensive, natural set of trigger phrases users actually say — "non-trivial bugs", "unexpected behavior", "flaky tests", "tracing issues", "first attempt at a fix didn't work", "behavior seems 'impossible'" — including synonyms and variations.

5 / 5

Distinctiveness Conflict Risk

The narrow framing (hard bugs, failed-first-fix, "impossible" behavior, blaming external systems) carves a clear niche with distinct triggers and minimal overlap with other skills.

5 / 5

Total

18

/

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.

Validation16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository
QwenLM/qwen-code
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.