Content
81%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.
A well-crafted generator skill: tight imperative prose, a concrete contract for the artifact it produces, a full validation loop, and an exemplary referenced example directory. Its only structural defect is two links that do not resolve within the bundle being evaluated.
Suggestions
Fix or remove the dangling links: NOTICE.md is absent from the bundle and ../../../maps/README.md points outside it — against the actual bundle structure both are dead references.
Merge the two consecutive 'For Paperclip' paragraphs in section 3 (and consider moving that repo-specific guidance to a reference file) to tighten the body and keep the section's generic path uncluttered.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense, imperative, and assumes Claude's competence (e.g., 'Prefer the repo's own documented dev command (package scripts, Makefile, README quickstart)'); it never explains concepts Claude already knows. Minor trimming is possible — section 3 splits its Paperclip guidance across two consecutive 'For Paperclip' paragraphs, and a few long clauses could be tightened — so it sits at 'efficient; minor instances that could be trimmed' rather than 'every token earns its place'. | 4 / 5 |
Actionability | Concrete, specific instructions throughout: exact output paths ('.agents/skills/verify-<app>/SKILL.md'), the required frontmatter, six named sections with their content contracts, the exact four H2s for feature files, and a runnable check ('node scripts/check-maps.mjs'). As an instruction-only generator skill the absence of literal code is justified — the commands depend on each repo — and the real, high-quality references/feature-map-example/ bundle makes the target shape concrete. It stops short of copy-paste-ready commands, capping it below 5. | 4 / 5 |
Workflow Clarity | A clear five-step sequence (interview → generate → seed map → prove → offer maintenance) with explicit validation and feedback loops: 'If the checkout doesn't build or start as-is, fix that first... before generating', step 4's end-to-end trial run, 'Fix what fails, and run the generated cleanup after every failed iteration too, so broken attempts don't strand processes and ports', and the post-cleanup check that evidence survived. This matches the top anchor: sequenced steps with explicit validation and error-recovery loops. | 5 / 5 |
Progressive Disclosure | Good structure: a ~58-line overview body with the detailed material correctly split into references/feature-map-example/ (README plus two feature files), clearly signaled one level deep via '[references/feature-map-example/](references/feature-map-example/)' — a real directory whose contents match the promised shape (four ordered H2s, README index). Scored against the actual bundle, two referenced paths dangle: NOTICE.md is not present in the bundle, and ../../../maps/README.md resolves outside it, leaving minor organization gaps that hold this below a 5. | 4 / 5 |
Total | 17 / 20 Passed |