Content
81%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.
A well-structured orchestration skill: the 6-step workflow is clearly sequenced with explicit approval and review gates, bounded repair loops, and stop conditions, and the guidance is largely concrete (paths, flags, metadata fields). Its weaknesses are minor — some duplicated load instructions and a couple of abstract spots in the research-dispatch section.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense, imperative instruction with no tutorial padding about concepts Claude already knows; template and rule-file paths are repeated between Steps 1 and 4 and occasional meta-commentary ("Critical: This phase ensures design is based on complete, accurate information.") could be trimmed. Fits anchor 4 ("Efficient; minor instances of over-explanation that could be trimmed"); not 5 due to the duplication and not 3 because the padding is minor. | 4 / 5 |
Actionability | Concrete file paths, flags ($1, $2, -y), JSON metadata fields to set (phase, approvals.design.generated, updated_at), and a feature-type decision table make the guidance mostly executable. Minor gaps keep it from 5: sub-agent decomposition is left abstract ("the agent should decide the optimal decomposition") and "quick pattern check" is vague. | 4 / 5 |
Workflow Clarity | A clear 6-step sequence with explicit validation checkpoints (requirements approval gate in Step 1, design review gate in Step 5) and explicit feedback loops: repair-and-re-review bounded to at most 2 passes, and a stop-and-return-to-requirements path when a real spec gap is found. This matches anchor 5 (clear sequence, explicit validation, feedback loops for error recovery). | 5 / 5 |
Progressive Disclosure | Five rule files (design-principles.md, design-discovery-full.md, design-discovery-light.md, design-synthesis.md, design-review-gate.md) are each clearly signaled with when to read them, one level deep; no bundle files exist to verify beyond these references. The inlined 200-line workflow is the appropriate core content, with minor organization gaps (repeated load instructions, Safety & Fallback detail that could be tightened) keeping it at anchor 4 rather than 5. | 4 / 5 |
Total | 17 / 20 Passed |