CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

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

Quality

80%

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

66%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 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.

DimensionReasoningScore

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

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: third-person, concrete about actions, with an explicit 'Use when' clause and literal trigger phrases that fully satisfy the completeness anchor. The only gaps are a few missing natural synonyms and the absence of a stated niche boundary or named deliverable.

DimensionReasoningScore

Specificity

Lists several specific actions ('Refines raw ideas into sharp, actionable concepts', 'stress-test assumptions before committing to a plan', 'expand options before converging on one') tied to a named method (structured divergent and convergent thinking). Falls short of 5 because the concrete deliverable (the markdown one-pager) is never mentioned and 'sharp, actionable concepts' leans slightly abstract; clearly above the 3 anchor's '1-2 concrete actions'.

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, when you need to stress-test assumptions before committing to a plan, or when you want to expand options'), with literal trigger phrases appended. This matches the 5 anchor exactly and uses third-person voice as required.

5 / 5

Trigger Term Quality

Natural phrases users would actually say are present: 'ideate', 'refine this idea', 'stress-test my plan', plus conditions like 'when an idea is still vague' and 'expand options'. Missing common synonyms such as 'brainstorm', 'flesh out this idea', or 'explore options', which matches the 4 anchor (good coverage, a few natural terms missing) rather than comprehensive 5.

4 / 5

Distinctiveness Conflict Risk

The idea-refinement niche and triggers ('ideate', 'refine this idea', 'stress-test my plan') are distinctive, but the description carries no boundary statement excluding adjacent brainstorm/planning skills, leaving minor overlap risk with closely related ideation skills — the 4 anchor, not the 5 anchor's 'minimal conflict risk'.

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.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

addyosmani/agent-skills

Path

skills/idea-refine/SKILL.md

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.