Content
96%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 exceptionally tight, highly actionable instruction skill: exact file layouts, named sections, explicit validation and cleanup feedback loops, and a genuine one-level reference example. The only structural weakness is the out-of-bundle reference to ../../docs/harness/claude-code.md, which dangles relative to the skill directory.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The ~45-line body is dense directive prose with zero concept explanations aimed at what Claude already knows — every sentence adds a rule, a criterion, or a repo-specific instruction (e.g., "Never kill by process name; kill what you started"). Brief rationale asides like "a cleanup that eats the proof fails this step" encode norms rather than pad, so it sits at anchor 5 rather than anchor 4's 'minor instances of over-explanation'. | 5 / 5 |
Actionability | As an instruction-only skill it gives fully concrete guidance: exact paths (".cursor/skills/verify-<app>/SKILL.md", "features/README.md"), exact required sections (Launch, Doctor, Drive, Evidence, Cleanup, Helpers), exact feature-file H2 headings, real tool candidates (Playwright/Cypress specs, expect scripts, PTY helpers, CDP), and a worked reference example to follow. There are no pseudocode gaps or vague directives, matching anchor 5 under the instruction-skill scoring note. | 5 / 5 |
Workflow Clarity | The five numbered sections form a clear generate-then-verify sequence with explicit validation checkpoints and feedback loops: "Run its own instructions end to end once", "Fix what fails, and run the generated cleanup after every failed iteration too", and "After cleanup, confirm the evidence still exists at the named location". Gate conditions ("If the checkout doesn't build or start as-is, fix that first... before generating") place it at anchor 5. | 5 / 5 |
Progressive Disclosure | The body is a well-sectioned overview that appropriately pushes the feature-map template into a real one-level-deep reference (references/feature-map-example/ with README.md, create-note.md, search.md, matching the shape described in section 3). It stops short of anchor 5 because the body's other link, "../../docs/harness/claude-code.md", resolves outside the skill bundle and cannot be navigated from the skill as shipped — a minor organization gap characteristic of anchor 4. | 4 / 5 |
Total | 19 / 20 Passed |