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 highly actionable, well-sequenced workflow with real validation checkpoints before the destructive archive move and a clear success-output template. Its only deductions are minor redundancy in the Guardrails section and the under-specified delta-spec comparison step.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and assumes competence (no concept explanations), but the Guardrails section partially restates earlier steps (e.g. 'Always prompt for change selection if not provided' duplicates Step 1's IMPORTANT note; 'Show clear summary of what happened' duplicates Step 6). Not 5: these repetitions could be trimmed. | 4 / 5 |
Actionability | Concrete, copy-paste-ready commands throughout ('openspec list --json', 'openspec status --change "<name>" --json', 'mkdir -p openspec/changes/archive', 'mv openspec/changes/<name> ...'), exact JSON fields to parse, exact paths, and ready-made prompt option strings. Not 5: Step 4's 'Compare each delta spec with its corresponding main spec... Determine what changes would be applied' offers no concrete comparison method and defers entirely to another skill. | 4 / 5 |
Workflow Clarity | A clearly sequenced six-step process with explicit validation checkpoints before the destructive move (artifact status check, task count check, delta-sync assessment, target-exists check with fail-and-suggest behavior) and confirmation loops via AskUserQuestion. The destructive-operation cap does not apply because validation steps are present. | 5 / 5 |
Progressive Disclosure | A single well-sectioned file (Input / Steps / Output On Success / Guardrails) with no bundle files to organize; the one external dependency (the openspec-sync-specs skill) is clearly signaled and one level deep. Not 5: the body inlines the full instruction set with no reference structure, which is acceptable here but leaves nothing rewarded at the top anchor. | 4 / 5 |
Total | 17 / 20 Passed |