Content
77%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This is a well-structured ideation skill with strong actionability and clear workflow sequencing. Its main weaknesses are moderate verbosity (overlapping anti-patterns/red flags sections, unnecessary philosophy aphorisms) and unverifiable external file references. The concrete output template, explicit phase gates, and verification checklist are particular strengths.
Suggestions
Consolidate the 'Anti-patterns to Avoid' and 'Red Flags' sections — they repeat the same points (e.g., generating 20+ ideas, skipping 'who is this for', no assumptions surfaced) and could be merged into a single concise list.
Trim the Philosophy section to 1-2 actionable principles rather than 6 inspirational aphorisms — Claude doesn't need motivational framing to execute well.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill is reasonably well-written but includes some unnecessary verbosity. The philosophy section with Apple-esque aphorisms ('Say no to 1,000 things', 'The parts you can't see should be as beautiful as the parts you can') is padding that Claude doesn't need. The anti-patterns and red flags sections significantly overlap, repeating the same points. The tone instruction is useful but could be tighter. | 2 / 3 |
Actionability | The skill provides highly concrete, actionable guidance: specific phases with clear steps, exact output format with a complete markdown template, specific ideation lenses to apply (inversion, constraint removal, etc.), explicit tool usage (AskUserQuestion, Glob, Grep, Read), and a concrete bash command for initialization. The guidance is specific enough to execute without ambiguity. | 3 / 3 |
Workflow Clarity | The three-phase workflow is clearly sequenced with explicit gates between phases (e.g., 'Do NOT proceed until you understand who this is for'). The verification checklist at the end serves as a validation checkpoint. The process includes a confirmation step before saving output. The interactive nature means validation is built into the conversation flow itself. | 3 / 3 |
Progressive Disclosure | The skill references external files (frameworks.md, refinement-criteria.md, examples.md) which is good progressive disclosure design, but no bundle files are provided, making it impossible to verify these references exist. The SKILL.md itself is quite long (~150+ lines of detailed instructions) and some content (like the full philosophy section or the overlapping anti-patterns/red flags) could be moved to supporting files. The structure within the file is well-organized with clear headers. | 2 / 3 |
Total | 10 / 12 Passed |