Content
61%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-organized, deliberately anti-workflow stance skill with genuinely concrete anchors (a real CLI command, artifact paths, a capture table) woven into intentionally open-ended guidance. Its main weaknesses are redundancy — multiple sections restate the same guardrails — and long inline example dialogues that pad the token budget without adding proportional guidance.
Suggestions
Merge 'What You Don't Have To Do', the opening IMPORTANT block, and 'Guardrails' into a single non-duplicative section to cut redundant tokens.
Move the four 'Handling Different Entry Points' example dialogues (or keep only one exemplar) into a separate reference file to shorten the main body.
Trim the meta 'Visualize' ASCII box — one short instruction line plus a single illustrative diagram elsewhere already conveys the point.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Sections like 'What You Don't Have To Do' and 'Guardrails' largely restate the opening IMPORTANT block and the stance list, and the four full example dialogues plus the self-demonstrating ASCII box ('Use ASCII diagrams liberally' drawn inside a diagram) add noticeable padding — mostly efficient, but several sections could be tightened, matching the 3 anchor rather than the minor-trim 4. | 3 / 5 |
Actionability | Concrete anchors exist — the executable 'openspec list --json' command, specific artifact paths ('openspec/changes/<name>/proposal.md', 'design.md', 'tasks.md'), a capture-destination table, and sample conversational phrasings — though much of the guidance is intentionally open-ended stance direction, leaving minor gaps versus fully copy-paste-ready instruction. | 4 / 5 |
Workflow Clarity | There is an initial context check ('openspec list --json') and a numbered 4-step sequence under 'When a change exists', but the skill explicitly disclaims fixed steps ('no fixed steps, no required sequence, no mandatory outputs') and includes no checkpoints or feedback loops; steps are present but implicit and unvalidated, fitting the 3 anchor. No destructive or batch operations exist, so the validation cap does not apply. | 3 / 5 |
Progressive Disclosure | The body is a single self-contained file with no bundle references and clear, well-signposted section headers, so there is no reference nesting or burial; however, at ~295 lines the four example dialogues are inline content that could reasonably live in a separate file, which is a minor organization gap keeping it below 5. | 4 / 5 |
Total | 14 / 20 Passed |