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, highly actionable workflow skill with clear sequencing, validation checkpoints, and good organization. The main weakness is minor redundancy between the Steps and the later Guardrails/Guidelines sections.
Suggestions
Remove the redundancy between Step 3's 'STOP after creating ONE artifact' and the Guardrails 'Create ONE artifact per invocation' by consolidating the constraint in one place.
Trim overlap between the 'Artifact Creation Guidelines' schema patterns and Step 3's instruction-field handling so each section earns its tokens.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body avoids concept-explanation padding, but 'Guardrails' re-states 'Create ONE artifact per invocation' already covered in Step 3, and the 'Artifact Creation Guidelines' overlap with Step 3, so it could be tightened. | 2 / 3 |
Actionability | It provides concrete, executable CLI commands (openspec list/status/instructions with --json) and enumerates the exact JSON fields to parse, making guidance copy-paste ready. | 3 / 3 |
Workflow Clarity | A clear numbered sequence with status-based branching, explicit STOP checkpoints, and a verification step ('Verify the artifact file exists after writing before marking progress') provides strong workflow clarity. | 3 / 3 |
Progressive Disclosure | No bundle files exist and the body is a self-contained, well-sectioned workflow with no nested references; per the simple-skill scoring note, well-organized sections with no need for external references score 3. | 3 / 3 |
Total | 11 / 12 Passed |