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 exceptionally tight, high-agency skill body: a clear five-step workflow with a built-in validation feedback loop, concrete named artifacts and section requirements, and a well-signaled one-level-deep reference that actually exists. The only meaningful gap is the absence of a worked template for the generated skill's own content.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and dense with instruction: every sentence directs behavior ('Answer these from the codebase and only ask the user what you cannot observe', 'Never kill by process name; kill what you started') and nothing explains concepts Claude already knows. Rationale phrases are punchy and earn their place ('A generated skill that was never executed is a draft, not a deliverable'). Not anchor 4 because there is no padding to trim. | 5 / 5 |
Actionability | Concrete, actionable guidance throughout: exact paths ('.cursor/skills/verify-<app>/SKILL.md', 'features/README.md'), required frontmatter fields, six named generated-skill sections with their content requirements, and four named H2s for feature files. Falls short of anchor 5 because, for an instruction-only generator skill, there is no fill-in template or worked snippet for the generated SKILL.md — the agent must compose each section from the descriptions, and helpers are specified only by requirement. | 4 / 5 |
Workflow Clarity | Five numbered sections in a coherent sequence (interview → generate → seed map → prove → offer maintenance), with explicit validation and a feedback loop in section 4: 'Run its own instructions end to end once... Fix what fails, and run the generated cleanup after every failed iteration too', plus a pre-flight gate ('If the checkout doesn't build or start as-is, fix that first'). This matches the anchor-5 pattern (validate → fix → retry). | 5 / 5 |
Progressive Disclosure | The body is under 50 lines with well-organized sections, and its single external reference ([references/feature-map-example/]) is real (README.md, create-note.md, search.md all present), clearly signaled as a markdown link, and exactly one level deep. Per the guidelines, this meets anchor 5. | 5 / 5 |
Total | 19 / 20 Passed |