Content
85%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
A well-structured interactive skill with concrete commands, a sequenced workflow including validation checkpoints, and clean single-level progressive disclosure. Its main weakness is moderate redundancy across the 'What is covered', 'When to use', and 'Constraints' sections relative to the Workflow.
Suggestions
Collapse the 'What is covered in this Skill?' bullet list, since its items are already represented in the Constraints and Workflow sections, to remove the main source of redundancy.
Trim 'When to use this skill' to only trigger phrasings not already present in the frontmatter description, or remove it and rely on the description's triggers to avoid duplication.
Consolidate the MUST/MUST NOT 'Constraints' list so each constraint maps to a specific Workflow step, reducing overlap between the constraints and the step descriptions.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is mostly efficient and assumes Claude's competence (no explaining of what OpenSpec or ADRs are), but the 'What is covered in this Skill?' list, 'When to use this skill', and parts of 'Constraints' restate content already conveyed by the Workflow steps, so it could be tightened. | 2 / 3 |
Actionability | Provides concrete executable commands ('openspec --version', 'openspec init', 'openspec validate --all') and specific artifact names (proposal, design, specification deltas, tasks.md), giving copy-paste-ready guidance. | 3 / 3 |
Workflow Clarity | Six clearly sequenced steps with an explicit validation checkpoint in step 6 ('Run openspec validate --all', archive only after validation and approval) and explicit user-decision handling for conflicts in step 5. | 3 / 3 |
Progressive Disclosure | The body is a concise overview with a single clearly signaled one-level-deep reference to references/042-planning-openspec.md, which exists as a real bundle file, so content is appropriately split and easy to navigate. | 3 / 3 |
Total | 11 / 12 Passed |