Refines raw ideas into sharp, actionable concepts through structured divergent and convergent thinking. Use when an idea is still vague, when you need to stress-test assumptions before committing to a plan, or when you want to expand options before converging on one. Triggers on "ideate", "refine this idea", or "stress-test my plan".
66
79%
Does it follow best practices?
Impact
—
No eval scenarios have been run
Passed
No known issues
Optimize this skill with Tessl
npx tessl skill review --optimize ./skills/idea-refine/SKILL.mdQuality
Discovery
82%Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.
This is a solid description that clearly communicates both purpose and trigger conditions. Its main strength is the explicit 'Use when...' clause with natural trigger terms. Its weakness is that the core capability description is somewhat abstract ('refines raw ideas into sharp, actionable concepts') rather than listing multiple concrete discrete actions, and the domain could overlap with adjacent brainstorming or planning skills.
Suggestions
Add more specific concrete actions to increase specificity, e.g., 'generates alternative approaches, identifies hidden assumptions, ranks options by feasibility, and produces a focused action plan'
Differentiate more clearly from adjacent skills like brainstorming or strategic planning by specifying what makes this skill's structured divergent/convergent approach unique
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | The description names a domain (idea refinement) and mentions 'structured divergent and convergent thinking' as a method, but the concrete actions are somewhat abstract—'refines raw ideas into sharp, actionable concepts' is more of a high-level outcome than a list of specific concrete actions like the score-3 examples show. | 2 / 3 |
Completeness | Clearly answers both 'what' (refines raw ideas through structured divergent/convergent thinking) and 'when' (explicit 'Use when...' clause with multiple trigger scenarios plus explicit trigger phrases). Both components are well-articulated. | 3 / 3 |
Trigger Term Quality | Includes natural trigger terms users would actually say: 'ideate', 'refine this idea', 'stress-test my plan', 'vague idea', 'expand options', 'assumptions'. These cover multiple natural phrasings a user might employ when needing this skill. | 3 / 3 |
Distinctiveness Conflict Risk | While 'ideation' and 'stress-test' are somewhat distinctive, the broader concept of 'refining ideas' and 'expanding options' could overlap with brainstorming skills, strategic planning skills, or general problem-solving skills. The niche is moderately clear but not as sharply defined as a file-format-specific skill. | 2 / 3 |
Total | 10 / 12 Passed |
Implementation
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 weakness is moderate verbosity — the philosophy section, duplicated anti-patterns/red flags, and motivational asides add tokens without proportional value. The progressive disclosure design references supporting files appropriately but the main file itself could be trimmed.
Suggestions
Consolidate the 'Anti-patterns to Avoid' and 'Red Flags' sections into one — they significantly overlap (e.g., both mention generating 20+ ideas, skipping 'who is this for', and yes-machining).
Move the Philosophy section into a supporting file or trim it to 2-3 bullet points — lines like 'The parts you can't see should be as beautiful as the parts you can' don't add actionable guidance for Claude.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill is reasonably well-written but includes some unnecessary verbosity. The philosophy section with Apple-esque platitudes ('Say no to 1,000 things', 'The parts you can't see should be as beautiful as the parts you can') adds flavor but not actionable value. The anti-patterns section partially duplicates the red flags section. Some instructions like 'This is where most ideation fails. Don't skip it.' are motivational padding rather than actionable guidance. | 2 / 3 |
Actionability | The skill provides highly concrete, specific guidance: exact sharpening questions to ask, specific ideation lenses (inversion, constraint removal, etc.), a complete markdown template for the output artifact, specific tool names to use (AskUserQuestion, Glob, Grep, Read), and clear criteria for stress-testing. The process is prescriptive enough to follow 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 and what success looks like', 'After the user reacts to Phase 1... shift to convergent mode', 'Ask the user if they'd like to save... Only save if they confirm'). The verification checklist at the end provides validation. The red flags section serves as an additional error-detection mechanism. | 3 / 3 |
Progressive Disclosure | The skill references external files (frameworks.md, refinement-criteria.md, examples.md) for deeper content, which is good progressive disclosure design. However, no bundle files were provided, so these references are unverifiable. The main SKILL.md itself is quite long (~150+ lines of instructional content) and some sections (philosophy, anti-patterns, red flags) could potentially be moved to supporting files to keep the main file leaner. | 2 / 3 |
Total | 10 / 12 Passed |
Validation
100%Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.
Validation — 11 / 11 Passed
Validation for skill structure
No warnings or errors.
f17c6e8
Table of Contents
If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.