Content
85%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, actionable 7-phase workflow with explicit gates, validation, and on-demand reference loading. Its only weaknesses are minor verbosity in the framing sections and HTML-preview guidance that leans procedural rather than copy-paste ready.
Suggestions
Trim the duplicated communication rules in the <role> block (language rules already implied by the trigger phrasing) to improve conciseness.
Add a small copy-paste HTML scaffold for the Phase 5 preview (DOCTYPE, tailwind CDN script, tailwind.config stub) so the preview step is fully executable rather than described.
Condense the 'Be transparent' parenthetical asides into a single fallback note to reduce token overhead.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is mostly efficient — terse tables, bullet lists, and a quick-reference grid assume Claude's competence without explaining basics like 'what is a wireframe' — but a few sections (the repeated communication rules in the role block, the parenthetical 'Be transparent: *...*' asides) could be trimmed. Not a 5 because minor over-explanation remains. | 4 / 5 |
Actionability | Concrete, executable guidance dominates: explicit glob paths ('frontend/src/components/ui/*.tsx', 'frontend/src/features/{domain}/components/**/*.tsx'), 'xdg-open /tmp/ux-preview-{timestamp}.html', the Tailwind CDN snippet, and exact UI-SPEC write paths. It falls just short of 5 because the HTML-preview steps are procedural prose rather than copy-paste-ready code and a few phases lean on guidance over commands. | 4 / 5 |
Workflow Clarity | A clear 7-phase sequence carries explicit validation checkpoints and feedback loops: the Phase 1 gate ('Do NOT proceed to Phase 2 without answers to at least questions 1 and 2'), Phase 7's 'Verify real component names against codebase' glob before writing, the decisions_log iteration loop, and the navigation-support table for re-entering earlier phases. This matches the anchor requiring explicit validation steps and error-recovery feedback loops. | 5 / 5 |
Progressive Disclosure | SKILL.md functions as a true overview with well-signaled, one-level-deep references: all five bundle files (design-system-inventory, proposal-format, ascii-mockup-guide, ui-spec-template, research-prompts) exist and are loaded on demand at the specific phase that needs them, with no nested-reference chains. | 5 / 5 |
Total | 18 / 20 Passed |