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".

62

Quality

73%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

SecuritybySnyk

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./skills/idea-refine/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

63%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

The body is well-structured with a clear three-phase workflow, concrete lenses, and a usable output template, but it is held back by redundant sections, motivational padding, and three referenced bundle files (frameworks.md, refinement-criteria.md, examples.md) that do not actually exist.

Suggestions

Create the missing referenced files (frameworks.md, refinement-criteria.md, examples.md) or remove the 'Read ...' pointers — broken references are a navigation failure that currently caps progressive_disclosure at 3.

De-duplicate the body: merge 'Red Flags' into 'Anti-patterns to Avoid' and collapse the 'How It Works' overview into the 'Process' section to remove padding and lift conciseness.

Trim the motivational aphorisms in 'Philosophy' and the personality coaching in 'Tone' down to the operative guidance, keeping only what changes Claude's behavior.

DimensionReasoningScore

Conciseness

Mostly efficient instructional content, but padded with motivational aphorisms ("Simplicity is the ultimate sophistication", "Show people the future — don't just give them better horses"), a personality-coaching Tone section, and clear redundancy ("Red Flags" largely duplicates "Anti-patterns to Avoid", and "How It Works" restates "Process"); not 4 because the redundancy is more than minor, not 2 because substantial genuine guidance remains.

3 / 5

Actionability

Provides concrete executable guidance — named ideation lenses (Inversion, Constraint removal, etc.), a specific 3-5 question budget, a copy-paste markdown output template, named tools (AskUserQuestion, Glob, Grep, Read), and a real init script; not 5 because the referenced detail files that hold 'additional frameworks' and 'the full evaluation rubric' are missing, so the complete actionable detail is not actually present.

4 / 5

Workflow Clarity

Three phases are clearly sequenced with explicit gating ("Do NOT proceed until you understand who this is for"), a defined transition ("After the user reacts..."), user-confirmation before saving, and a final Verification checklist; not 5 because there is no explicit error-recovery/feedback loop and the adaptive conversational nature makes checkpoints soft rather than rigidly validated.

4 / 5

Progressive Disclosure

References are well-signaled and one level deep in context ("Read frameworks.md... for additional ideation frameworks", "Read refinement-criteria.md... for the full evaluation rubric", "Read examples.md... for examples"), but none of these three files exist in the bundle (only scripts/idea-refine.sh is present), so navigation dead-ends; the signaling quality approaches 4 but the broken referenced paths drag it back to the 'could be better organized' level.

3 / 5

Total

14

/

20

Passed

Description

83%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A strong description that clearly states what the skill does and when to use it, with concrete natural-language triggers. It is held back from the top tier only by slightly abstract action verbs and minor overlap with generic planning skills.

DimensionReasoningScore

Specificity

Names the ideation domain plus several concrete actions ("Refines raw ideas into sharp, actionable concepts", "stress-test assumptions", "expand options before converging"), matching the 'several specific actions; minor gaps' anchor; not 5 because the actions stay abstract rather than crisply enumerated like the PDF examples, and not 3 because more than 1-2 concrete actions are given.

4 / 5

Completeness

Explicitly answers both 'what' ("Refines raw ideas into sharp, actionable concepts through structured divergent and convergent thinking") and 'when' ("Use when an idea is still vague... or when you want to expand options... Triggers on...") with concrete trigger phrases, matching the top anchor exactly; cannot exceed 5.

5 / 5

Trigger Term Quality

Includes natural phrases a user would say ("ideate", "refine this idea", "stress-test my plan", "stress-test assumptions", "expand options") with good coverage; not 5 because the explicit trigger set is limited to three phrases and lacks the synonym breadth of the top anchor, and not 3 because the terms are natural and varied rather than minimal.

4 / 5

Distinctiveness Conflict Risk

Ideation/refinement is a clear niche with distinct triggers, but "stress-test my plan" and the planning framing create minor overlap risk with general planning or review skills, placing it just below the minimal-conflict top anchor and above the 'could still overlap' midpoint.

4 / 5

Total

17

/

20

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.

Validation16 / 16 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.