Content
50%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
The body is well-structured and includes some genuinely actionable OpenSpec operational guidance, but it is verbose with recurring redundancy and leans heavily on stance philosophy over concrete instruction.
Suggestions
Consolidate the repeated stance guidance — merge 'What You Don't Have To Do', 'The Stance', and 'Guardrails' so 'don't implement' and the philosophy appear once.
Move the four long entry-point example dialogues into a reference file and keep only one representative example inline.
Tighten the OpenSpec Awareness section into the concrete command, file paths, and capture table, trimming the surrounding prose.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | It avoids explaining concepts Claude already knows, but it is ~280 lines with notable redundancy — 'don't implement' and the stance philosophy recur across the IMPORTANT note, 'The Stance', 'Guardrails', and 'What You Don't Have To Do'. | 2 / 3 |
Actionability | Concrete operational guidance exists (the `openspec list --json` command, specific artifact paths, and the insight-to-artifact capture table), but the bulk is stance philosophy rather than executable instruction. | 2 / 3 |
Workflow Clarity | The 'When a change exists' section gives a clear numbered 1-4 sequence and there is an explicit context check, but the skill deliberately has no fixed workflow and offers no validation checkpoints for its sub-processes. | 2 / 3 |
Progressive Disclosure | It is a single self-contained file with clear section headers and no external references, but at ~280 lines the lengthy example-dialogue blocks are inline content that could be separated, so it is not fully lean. | 2 / 3 |
Total | 8 / 12 Passed |