Content
67%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.
The content delivers concrete, actionable OpenSpec-aware guidance with a clear sequenced branch and strong section organization. Its chief weakness is conciseness: the large illustrative dialogues and overlapping sections inflate a skill that is conceptually a lightweight stance.
Suggestions
Trim or collapse the four full ASCII worked examples in "Handling Different Entry Points" into a single compact example plus one-line sketches — they demonstrate a stance Claude already knows how to perform.
Merge "What You Might Do" and "Handling Different Entry Points" since both enumerate the same kinds of exploratory moves, to remove overlap.
Move the insight-to-file capture table and artifact path reference into a short "Reference" section near the top so the stance prose stays lean.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is well-organized but ~290 lines for a skill that declares itself "a stance, not a workflow"; the four large ASCII worked examples and overlapping sections ("What You Might Do" vs "Handling Different Entry Points") are padding that could be trimmed without losing clarity. | 3 / 5 |
Actionability | Provides concrete executable guidance — `openspec list --json`, specific artifact paths, the insight-to-file capture table, and transition commands (`/opsx:new`, `/opsx:ff`) — with only minor gaps in the softer stance directives. | 4 / 5 |
Workflow Clarity | By design non-workflow, but the "When a change exists" branch is a clear 4-step sequence and the capture table acts as a checklist; no destructive or batch operations so the validation cap does not apply. | 4 / 5 |
Progressive Disclosure | No bundle files exist and no external references are used; the body is divided into clearly labeled, `---`-separated sections that are easy to navigate, with only minor organization gaps given the length. | 4 / 5 |
Total | 15 / 20 Passed |