CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

vibe-debug

Diagnose and fix a reproducible failure in an existing project. Use for crashes, broken behavior, or failing checks, not greenfield planning.

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

92%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 exemplary compact process skill: an efficient, well-sequenced debugging workflow with real validation checkpoints, an escalation feedback loop, safety guardrails, and an anti-prompt-injection note. The only weakness is a handful of steps whose execution mechanism (baseline/checkpoint recording, where launch commands live) is left unspecified.

DimensionReasoningScore

Conciseness

The ~200-word body is lean and fully imperative with no explanation of concepts Claude already knows; every sentence adds a constraint or instruction the model would not infer on its own (e.g., "After two failed attempts... stop speculative edits", "never invent researched results"). This matches the lean-and-efficient anchor exactly.

5 / 5

Actionability

For an instruction-only skill the guidance is largely executable: concrete thresholds ("After two failed attempts", "3–5 plausible fixes"), a defined record format ("input, expected result, actual result, and environment"), a named log location (MEMORY.md), and a closing report checklist ("Changed, Checked, Not checked, Next decision, Recovery"). However, several mechanisms stay abstract — "recorded launch/check commands" (where recorded?) and "record the baseline and a real recovery checkpoint" (how?) leave minor gaps, matching anchor 4 rather than the fully copy-paste-ready anchor 5.

4 / 5

Workflow Clarity

A clear five-step sequence with explicit validation checkpoints (reproduce the smallest failing case in step 2, re-run the original reproduction and applicable checks in step 5) and a genuine error-recovery feedback loop (step 4 escalation after two failed attempts). Destructive operations are guarded ("Do not reset, clean, or replace unrelated files"; "Do not replace dependencies or rewrite architecture without evidence and scope agreement"), matching the anchor for explicit validation with feedback loops.

5 / 5

Progressive Disclosure

The skill is under 50 lines with no bundle files and no content that belongs in separate references; the numbered workflow plus two closing note paragraphs is well-organized, meeting the simple-skill exception for a top score. The one external pointer, "use `../vibe-verify/SKILL.md`", is a clearly signaled one-level-deep cross-skill handoff rather than a buried or nested reference.

5 / 5

Total

19

/

20

Passed

Description

82%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: third-person imperative, concise, with an explicit "Use for" trigger clause and a negative boundary that sharply delimits its scope. The main gap is capability breadth — only two actions are named — and a few common debug synonyms (bug, error) are absent from the trigger list.

DimensionReasoningScore

Specificity

The description names the domain ("a reproducible failure in an existing project") and exactly two actions ("Diagnose and fix"), matching the anchor for 1-2 concrete actions without comprehensive coverage. It does not list several distinct capabilities, so it falls below anchor 4.

3 / 5

Completeness

Both halves are explicit: the what is "Diagnose and fix a reproducible failure in an existing project" and the when is an explicit "Use for" clause with concrete trigger phrases ("crashes, broken behavior, or failing checks"). This clearly matches the anchor requiring both what and when with concrete triggers; it is not merely a weak or implied when (anchor 4).

5 / 5

Trigger Term Quality

"Use for crashes, broken behavior, or failing checks" provides natural phrases users would actually say, giving good keyword coverage. Common variations such as "bug", "error", or "stack trace" are missing, so it does not reach the comprehensive-synonyms anchor of 5.

4 / 5

Distinctiveness Conflict Risk

The description carves a clear niche (diagnosing reproducible failures in existing projects) with distinct triggers, and "not greenfield planning" explicitly separates it from planning/generation skills. Conflict risk with other skills is minimal, matching anchor 5; it is more distinct than the minor-overlap case of anchor 4.

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

allowed_tools_field

'allowed-tools' contains unusual tool name(s)

Warning

Total

15

/

16

Passed

Repository

KhazP/vibe-coding-prompt-template

Path

workflow/skills/vibe-debug/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.