CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

debugging

Investigate and safely fix an active, observable software failure, error, regression, or unexpected behavior using reproduction and evidence. Use for the proximate technical cause and remediation. Do not use for a systemic incident postmortem or general performance tuning without a failure.

Quality

86%

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

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.

An unusually strong instruction-only skill: an explicitly gated eight-phase workflow with real validation and feedback loops, concrete per-artifact and per-tool guidance, a worked example, and a well-signaled one-level-deep reference bundle. The two deductions are motivational padding that could be trimmed and ten shared/ policy links that resolve to no files in the bundle.

Suggestions

Fix or remove the 10 dead links to shared/base/*.md and shared/workflow-contract.md — either package those files or inline the one-line effect of each policy so nothing referenced is missing.

Trim the rhetorical padding in 'The prime directive' and Core Principle 1 ('This skill exists to prevent that', 'masks symptoms, burns trust') — the rules are already stated imperatively and don't need the motivation.

The inline output-format block (~25 lines) duplicates the 'full output template' said to live in references/workflow.md — keep only the abbreviated skeleton in the body and point to the reference for the full version.

DimensionReasoningScore

Conciseness

The body is dense with non-obvious, actionable guidance and teaches no basic concepts (no 'what a stack trace is' padding), but it carries motivational over-explanation that could be trimmed — e.g. 'This skill exists to prevent that', 'A plausible-looking fix applied to an unverified cause is worse than no fix — it masks symptoms, burns trust', and the prime-directive section restating the evidence-first rule that Core Principles then repeats. That is the anchor-4 profile: efficient with minor instances of over-explanation, not the every-token-earns-its-place anchor 5.

4 / 5

Actionability

Guidance is fully concrete for an instruction-only skill: specific commands and tools per situation ('git bisect', 'EXPLAIN ANALYZE', 'kubectl describe', 'docker logs'), explicit per-artifact first moves ('read the lines before the error', 'find the first frame in our code'), a complete worked example carrying an end-to-end investigation, and a copy-paste output template with a concrete confidence rubric. Specific examples cover the common cases, matching anchor 5.

5 / 5

Workflow Clarity

The eight phases are explicitly sequenced with phases 1–4 marked mandatory and 5–7 gated by bug domain, and the workflow has explicit validation gates and feedback loops: 'Never propose a code change until the evidence identifies the cause', hypotheses ranked with the cheapest way to confirm or kill each, 'If the top hypothesis is only MEDIUM, the honest deliverable is ... the one check that would confirm it', and Phase 4 requiring why the other hypotheses are ruled out. This matches the anchor-5 checklist-with-explicit-validation-and-recovery pattern; anchor 4's 'minor validation gaps' does not apply.

5 / 5

Progressive Disclosure

Structure is good: a 'Read | When' reference map, on-demand loading instructions ('read the reference file when its phase begins'), and all 8 references/*.md files exist and link only one level deep (sibling cross-references, no nesting chains). The gap: the body's 'Required packaged policies' section links 9 shared/base/*.md files plus shared/workflow-contract.md, none of which exist in the bundle — 10 dead reference paths — which is more than a trivial organization issue and keeps this below anchor 5's 'easy navigation'.

4 / 5

Total

18

/

20

Passed

Description

78%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: concrete domain language, an explicit use/do-not-use boundary, and good natural keywords. The main gaps are the missing everyday trigger words ('bug', 'crash', 'failing test') and an abstractly framed when-clause that could name the user situations that should invoke it.

Suggestions

Add the most natural user vocabulary — 'bug', 'crash', 'failing test', 'broken' — to the trigger coverage, e.g. 'Use when the user reports a bug, error, crash, failing test, or unexpected behavior'.

Ground the when-clause in observable user situations rather than the abstract 'proximate technical cause and remediation' framing, so skill selection can match on what the user actually says.

Consider mentioning reproduction artifacts users bring (stack trace, logs) since these are the most common entry points for a debugging request.

DimensionReasoningScore

Specificity

The description names the domain concretely ('active, observable software failure, error, regression, or unexpected behavior') and specifies the method ('using reproduction and evidence') plus the action pair 'Investigate and safely fix'. It lists several specific elements but the action vocabulary is limited to investigate/fix, leaving minor gaps versus the comprehensive multi-action anchor 5.

4 / 5

Completeness

Both 'what' ('Investigate and safely fix an active, observable software failure... using reproduction and evidence') and 'when' ('Use for the proximate technical cause and remediation. Do not use for a systemic incident postmortem or general performance tuning') are explicitly present, and the do-not-use clause adds useful disambiguation. The when-clause is framed abstractly ('proximate technical cause and remediation') instead of concrete user situations like 'use when the user reports a bug, crash, or failing test', so it sits at anchor 4 rather than the concrete-trigger-phrases anchor 5.

4 / 5

Trigger Term Quality

Natural user-facing terms like 'failure', 'error', 'regression', 'unexpected behavior', and 'fix' are present, giving good keyword coverage. A few of the most common phrases a user would actually say — 'bug', 'crash', 'failing test', 'broken' — are missing, which is exactly the anchor-4 condition ('a few natural terms missing') rather than the comprehensive synonym coverage of anchor 5.

4 / 5

Distinctiveness Conflict Risk

The scope is narrowed to 'active, observable' failures and the explicit 'Do not use for a systemic incident postmortem or general performance tuning without a failure' clause cleanly separates this from adjacent skills (root-cause-analysis, performance-optimization). This is a clear niche with distinct triggers and minimal conflict risk, matching anchor 5.

5 / 5

Total

17

/

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

relative_links

Relative link issues: 10 missing, 9 deeper-than-1-level

Warning

Total

15

/

16

Passed

Repository

Noorkhalel/saas-ai-skills

Path

skills/debugging/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.