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-engineered workflow skill: the phased pipeline with approval gates, feedback loops, and worked examples is exemplary, and progressive disclosure is genuinely implemented with three on-demand reference files. The main cost is length — repeated emphasis and inline Stitch detail make the body longer than an overview should be.
Suggestions
Trim repetition of the discovery-first principle (it appears in Core Principles, Phase 2's CRITICAL note, the intro, and 'What This Skill is NOT') — state it once and trust it.
Move Phase 4's manual Stitch workflow details (menu-step guidance like Variants/Edit Theme/Prototype instructions) into references/stitch-integration.md, keeping only the trigger conditions and prompt formula inline.
Condense or drop the 'What This Skill is NOT' section — the frontmatter description and Phase-1 principles already establish the boundaries.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body never explains concepts Claude already knows, but at ~460 lines it restates the discovery-first principle many times ('Never generate code without context', 'References are non-negotiable', 'Do not proceed to Phase 3 until...') and repeats Stitch menu guidance across Phase 4's manual workflow and the prompt-generation rules. This fits the score-3 anchor ('mostly efficient but includes some unnecessary explanation or could be tightened'); it is far from the severely-padded score-1/2 anchors but not the lean score-5. | 3 / 5 |
Actionability | Fully actionable for an instruction-only skill: copy-paste templates for the Design Direction Summary and Execution Plan, exact question phrasings to ask users, a concrete Stitch prompt formula with a worked example ('A data analytics dashboard for SaaS metrics...'), named MCP tool calls (create_project, generate_screen_from_text, generate_variants, edit_screens), and four worked example scenarios. Matches the score-5 anchor ('specific examples cover the common cases'). | 5 / 5 |
Workflow Clarity | The 7-phase pipeline is clearly sequenced with explicit validation gates: 'CRITICAL: Do not proceed to Phase 3 until you have at least ONE concrete visual reference', per-unit approval prompts ('Does this match your vision?'), an error-recovery feedback loop ('If the user requests changes, apply them to the CURRENT unit before moving forward. Never accumulate fix later items'), and scaling rules by project size. This is the score-5 anchor's 'explicit validation steps; feedback loops; checklists' pattern. | 5 / 5 |
Progressive Disclosure | Three real one-level-deep reference files (design-principles.md, collection-guide.md, stitch-integration.md), each well-signaled with the exact phase in which to load it, plus a Reference Files section stating 'Load them ON DEMAND, not upfront'. However, the SKILL.md itself runs ~460 lines and inlines detailed Stitch manual-workflow steps that belong in stitch-integration.md — the score-4 anchor ('good structure; most content appropriately placed; minor organization gaps') rather than the concise-overview score-5 pattern. | 4 / 5 |
Total | 17 / 20 Passed |