Content
66%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 skill's process design is excellent — clear phased workflow with gates, precise counts, and a ready-to-use output template — but the bundle is broken: all three markdown files the body instructs the agent to read are missing, and the body carries redundant sections that inflate its token cost without adding guidance.
Suggestions
Create the referenced bundle files (frameworks.md, refinement-criteria.md, examples.md) or remove the 'Read X in this skill directory' lines — currently every markdown reference in the body is a dead path.
Merge 'Anti-patterns to Avoid', 'Common Rationalizations', and 'Red Flags' into a single section; they restate the same five points three times and account for significant wasted tokens.
Trim the 'Philosophy' section to the two or three lines that actually change agent behavior, or fold them into the Tone section.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Most sections are instructive, but the 'Philosophy' section is inspirational filler ('Simplicity is the ultimate sophistication', 'Say no to 1,000 things') and three sections — 'Anti-patterns to Avoid', 'Common Rationalizations', and 'Red Flags' — repeat the same five points nearly verbatim, so the body could be tightened considerably. Not a 2 because the core process guidance genuinely instructs rather than pads. | 3 / 5 |
Actionability | Highly actionable for an instruction-only skill: exact counts ('3-5 sharpening questions', '5-8 idea variations', '2-3 distinct directions'), seven named ideation lenses with sample phrasings, named tools (AskUserQuestion, Glob, Grep, Read), a concrete save path, and a copy-paste one-pager template. Held below 5 because the body directs the agent to read frameworks.md, refinement-criteria.md ('the full evaluation rubric'), and examples.md — none of which exist in the bundle, so promised guidance is missing. | 4 / 5 |
Workflow Clarity | Three phases are explicitly sequenced with hard gates ('Do NOT proceed until you understand who this is for and what success looks like'), a defined phase transition ('After the user reacts to Phase 1'), confirmation before saving ('Only save if they confirm'), and a final Verification checklist — matching the 5 anchor's explicit checkpoints and checklists. No destructive or batch operations, so no cap applies. | 5 / 5 |
Progressive Disclosure | Scored against the actual bundle: only scripts/idea-refine.sh exists; the three files referenced in the body (frameworks.md, refinement-criteria.md, examples.md) are absent, so navigation to them fails outright. Additionally, ~40 lines of triple-redundant anti-pattern/rationalization/red-flag content is inlined where it should be consolidated or split out. This fits the 2 anchor (content that belongs in separate files inlined, references effectively unusable) better than 3's 'references present but not clearly signaled'. | 2 / 5 |
Total | 14 / 20 Passed |