Content
92%Weight 40%Scale 1-5Reviews 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.
| Dimension | Reasoning | Score |
|---|---|---|
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 |