Agent skill · Testing & QA

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

addyosmanigithub.com/addyosmaniGitHub ↗
claude-codecodexcursorships scriptsMIT
Install
npx skills add addyosmani/agent-skills --skill idea-refine --agent claude-code

Same command for any agent — swap --agent for codex, cursor, copilot.

Facts
Files in the skill folder: 5
SKILL.md size: 8 KB
Bundled scripts: yes
Path: skills/idea-refine/SKILL.md
Open the folder on GitHub →
Where it comes from
Stars: 81,574
Language: JavaScript
Read our review of the source →

Weekly change comes from our own snapshots, not the repository page — it measures attention, not adoption.

From the SKILL.md

# Idea Refine Refines raw ideas into sharp, actionable concepts worth building through structured divergent and convergent thinking. ## How It Works 1. **Understand & Expand (Divergent):** Restate the idea, ask sharpening questions, and generate variations. 2. **Evaluate & Converge:** Cluster ideas, stress-test them, and surface hidden assumptions. 3. **Sharpen & Ship:** Produce a concrete markdown one-pager moving work forward. ## Usage This skill is primarily an interactive dialogue. Invoke it with an idea, and the agent will guide you through the process. ```bash # Optional: Initialize the ideas directory bash skills/idea-refine/scripts/idea-refine.sh ``` **Trigger Phrases:** - "Help me refine this idea" - "Ideate on [concept]" - "Stress-test my plan" ## Output The final output is a markdown one-pager saved to `docs/ideas/[idea-name].md` (after user confirmation), containing: - Problem Statement - Recommended Direction - Key Assumptions - MVP Scope - Not Doing list ## Detailed Instructions You are an ideation partner. Your job is to help refine raw ideas into sharp, actionable concepts worth building. ### Philosophy - Simplicity is the ultimate sophistication. Push toward the si

What's inside
Steps it walks through
  1. How It Works
  2. Usage
  3. Output
  4. Detailed Instructions
  5. Philosophy
  6. Process
  7. Anti-patterns to Avoid
  8. Tone
  9. Red Flags
  10. Verification
Ships with 4 files
  • examples.md
  • frameworks.md
  • refinement-criteria.md
  • scripts/idea-refine.sh
Commands it runs
bash skills/idea-refine/scripts/idea-refine.sh
More from agent-skills
All skills →
About this skill
What does the idea-refine skill do?

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

How do I install it?

Run `npx skills add addyosmani/agent-skills --skill idea-refine --agent claude-code` — it drops the skill into your project so the agent can pick it up. Swap the --agent value for codex, cursor or copilot if you use one of those.

Where does this skill come from?

From addyosmani/agent-skills, a repository with 81,574 stars. We read it straight from the repository tree rather than a submitted listing, so what you see here is what is actually published.

Is a popular skill a good skill?

Not necessarily. Stars measure attention, not adoption — a repository can trend for a week and be abandoned. That is why we show the weekly change from our own snapshots next to the total, instead of a single flattering number.

Keep going