Content
85%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
An actionable, well-structured workflow skill with concrete commands and clear validation loops. Its main weakness is redundancy between the intro, the description, and the closing guidelines section, which costs some token efficiency.
Suggestions
Remove the opening paragraph (lines 12-19) since it restates the frontmatter description and the artifact list is covered later; let the Steps section carry the workflow.
Merge the "Artifact Creation Guidelines" section into step 4a or delete it, as it duplicates the context/rules/dependency/template guidance already specified there.
Drop the standalone "When ready to implement, run /opsx:apply" line and the mid-document horizontal rule, keeping only the final Output prompt that already mentions /opsx:apply.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Mostly efficient procedural guidance, but the opening paragraph ("Propose a new change - create the change and generate all artifacts in one step. I'll create a change with artifacts:...") repeats the frontmatter description, and the "Artifact Creation Guidelines" section re-states the context/rules/dependency notes already given in step 4a. | 2 / 3 |
Actionability | Fully executable commands throughout — `openspec new change`, `openspec status --change --json`, `openspec instructions <artifact-id> --change --json` — plus the specific JSON fields to parse, making the guidance copy-paste ready. | 3 / 3 |
Workflow Clarity | A clearly sequenced five-step process with an explicit feedback loop (re-run `openspec status --json` after each artifact) and validation checkpoints ("Verify each artifact file exists after writing before proceeding to next", check all applyRequires are done). | 3 / 3 |
Progressive Disclosure | No bundle files exist and none are referenced; the body is a single self-contained doc organized into well-signaled sections (Input, Steps, Output, Artifact Creation Guidelines, Guardrails) with no nested references, which is appropriate for this skill. | 3 / 3 |
Total | 11 / 12 Passed |