CtrlK
BlogDocsLog inGet started
Tessl Logo

idea-refine

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

Quality

79%

Does it follow best practices?

Impact

No eval scenarios have been run

SecuritybySnyk

Passed

No known issues

Optimize this skill with Tessl

npx tessl skill review --optimize ./skills/idea-refine/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

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

DimensionReasoningScore

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.

DimensionReasoningScore

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.

Validation11 / 11 Passed

Validation for skill structure

No warnings or errors.

Repository
addyosmani/agent-skills
Reviewed

Table of Contents

Is this your skill?

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.