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 excellent instruction-only skill body: a tight five-phase workflow with built-in validation and feedback loops, concrete file paths and section specs, and a verified, well-signaled reference example. The only meaningful gap is that all sample content lives in the reference bundle rather than inline, so a reader gets no inline glimpse of the generated output's tone.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Lean and dense throughout: every line carries instructions or non-obvious judgment ("Never kill by process name; kill what you started", "a cleanup that eats the proof fails this step") and nothing explains concepts Claude already knows. Not 4 because there is no identifiable over-explanation to trim — brief rationale clauses all inform decisions. | 5 / 5 |
Actionability | Highly actionable for an instruction-only generator skill: exact paths (`.cursor/skills/verify-<app>/SKILL.md`, `features/README.md`), six named sections with required content, the exact four H2 titles, generic drive recipes (browser/CDP, tmux/PTY, plain HTTP), and a worked example bundle to follow. Not 5 because no inline sample of the generated output is shown and a few steps (e.g., what a minimal Doctor check looks like) remain abstract, leaving minor gaps. | 4 / 5 |
Workflow Clarity | Five clearly sequenced phases (interview → generate → seed → prove → maintenance) with explicit validation and feedback loops: "Fix what fails", "After cleanup, confirm the evidence still exists at the named location", and "run the generated cleanup after every failed iteration". The destructive-operation cap does not apply since verification/validation is the core of step 4. | 5 / 5 |
Progressive Disclosure | Well-organized numbered sections at ~36 lines, with a single one-level-deep reference (`references/feature-map-example/`) that is clearly signaled by link, verified to exist, and whose structure (README index plus one file per feature with the named H2s) matches exactly what the body describes. | 5 / 5 |
Total | 19 / 20 Passed |