Content
88%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 an exceptionally well-crafted instruction-only skill: a clearly sequenced conversational workflow with explicit validation checkpoints (playback corrections, builder check, approval gate), concrete scripts and examples throughout, and tight, jargon-free prose. Its weaknesses are minor — a small amount of duplicated guidance and a motivational opener that could be trimmed — leaving the content efficient and highly actionable.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and assumes Claude's competence — it never explains concepts Claude already knows, and the guidance is concrete throughout ('about 200-300 words', a sizing table, an exact offer message). Minor trimming opportunities exist: the guidance against jargon is stated twice ('Use plain language... never use process jargon' then 'Avoid jargon' four lines later at 'Be clear and concise. Lead with what matters. Avoid jargon.'), and the two-paragraph motivational opener ('You are very good at building...') is padding by the rubric's standard. This matches anchor 4: efficient with minor instances of over-explanation. | 4 / 5 |
Actionability | For an instruction-only skill the guidance is highly concrete: exact scripts to send ('This might be easier if I show you. Want me to open a browser tab with some mockups?'), example questions ('Walk me through the last time...'), a specific output path ('docs/superpowers/specs/YYYY-MM-DD-<topic>-design.md'), a three-pile triage for builder questions, and a hard gate with enumerated exceptions. The gap that keeps it from 5: it instructs the reader to 'read visual-companion.md in this directory before starting the server' and to 'dispatch a fresh subagent with builder-check-prompt.md in this directory', but neither file exists in the bundle — those steps cannot be executed as written, and the scripts/ directory (start-server.sh, server.cjs, etc.) is never named. | 4 / 5 |
Workflow Clarity | The multi-step process is clearly sequenced — know-check, first message, conversation (ground to cover, recon, spikes), playback, sizing, written design, builder check, then the HARD-GATE — with explicit validation checkpoints and feedback loops throughout: 'End each chunk by asking what's wrong or missing', the builder check before handover ('Don't hand over the document until the check is back'), approval required before building, and mid-task escalation ('If it grows mid-task, stop, say so, and step up a size'). The Red Flags table adds error-recovery guidance for predictable failure modes. This matches anchor 5: clear sequence, explicit validation, feedback loops. | 5 / 5 |
Progressive Disclosure | The SKILL.md is a well-organized overview that appropriately defers detail to per-topic files ('read visual-companion.md in this directory', 'builder-check-prompt.md'), keeps those references one level deep and clearly signaled at point of use, and holds its own content at overview altitude. The one organizational gap: the referenced paths are said to be 'in this directory' but the bundle's actual support files live in scripts/ (start-server.sh, stop-server.sh, server.cjs, helper.js, frame-template.html) and are never named from the body, so the server workflow's entry point is not directly navigable. This is a minor organization gap against anchor 5, matching anchor 4 ('most content appropriately placed; references mostly clear; minor organization gaps'). | 4 / 5 |
Total | 17 / 20 Passed |