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

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.

DimensionReasoningScore

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

Description

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 what the skill does and when to use it, with explicit trigger terms. Its main weakness is that the capability description leans toward abstract outcomes rather than listing multiple concrete actions, and the domain of 'idea refinement' could potentially overlap with adjacent skills like brainstorming or strategic planning.

Suggestions

Add more specific concrete actions to boost specificity, e.g., 'generates alternative approaches, identifies hidden assumptions, ranks options by feasibility, and produces a final refined concept.'

Differentiate more clearly from adjacent skills (brainstorming, planning, strategy) by specifying what makes this skill's structured approach unique or what it explicitly does NOT cover.

DimensionReasoningScore

Specificity

It names the domain (idea refinement) and mentions 'structured divergent and convergent thinking' and 'stress-test assumptions,' 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 and convergent thinking) and 'when' (explicit 'Use when...' clause with multiple trigger scenarios and specific trigger terms).

3 / 3

Trigger Term Quality

Includes natural trigger terms users would say: 'ideate', 'refine this idea', 'stress-test my plan', plus contextual phrases like 'idea is still vague' and 'expand options before converging.' These are realistic phrases a user would naturally use.

3 / 3

Distinctiveness Conflict Risk

While 'ideate' and 'stress-test' are somewhat distinctive, the broader concept of refining ideas and expanding options could overlap with brainstorming, planning, or strategy skills. The description is specific enough to reduce major conflicts but not entirely niche.

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.