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 body is a well-structured, self-contained stance skill with genuinely actionable elements (a context command, artifact paths, and a capture mapping table) and clear navigation. Its weaknesses are verbosity from repeated principles and four elaborate ASCII example dialogues, and behavioral guidance that is not always concretely executable.
Suggestions
Dedupe the overlapping principles across "The Stance", "What You Don't Have To Do", and "Guardrails" into a single list to reclaim token budget.
Trim the four full ASCII-dialogue examples to two representative ones; the stance is conveyed without all four.
Consider moving the extended example dialogues into a separate references file (e.g., EXAMPLES.md) so the main body stays a lean overview, which would also lift progressive_disclosure toward anchor 5.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | It assumes Claude's intelligence (no concept explanations) and the ASCII diagrams demonstrate the core visualization stance, but four elaborate example dialogues plus principles repeated across "The Stance", "What You Don't Have To Do", and "Guardrails" are padding that could be tightened, matching anchor 3. | 3 / 5 |
Actionability | Provides concrete executable elements (`openspec list --json`, specific artifact paths like `openspec/changes/<name>/proposal.md`, and an insight-type-to-artifact capture table), but much of the guidance is behavioral ("challenge assumptions", "be curious") rather than fully executable, fitting anchor 4. | 4 / 5 |
Workflow Clarity | A clear overall flow (check context → no-change / change-exists branch → numbered read/reference/capture/decide steps → ending discovery) is present; the skill is non-destructive so no validation checkpoints are required, but it is a multi-section stance rather than a single unambiguous action, keeping it at anchor 4. | 4 / 5 |
Progressive Disclosure | Well-organized with clear section headers, self-contained with no nested or buried references and easy navigation; minor organization gaps (principle repetition across sections, four large inline dialogues) prevent it from reaching anchor 5. | 4 / 5 |
Total | 15 / 20 Passed |