Turns vague ideas into something you can actually build by walking you through structured divergent and convergent thinking. You drop in a rough concept, it asks sharpening questions about who it's for and what success looks like, then generates 5-8 variations using lenses like inversion, constraint removal, and simplification. The real value is in phase two where it stress tests directions against user value, feasibility, and differentiation, then surfaces the hidden assumptions that usually kill ideas. Outputs a markdown one-pager with an MVP scope and a "Not Doing" list that makes trade-offs explicit. Best when you have something half-baked and need to either sharpen it or realize it's not worth building.

install copies · 90 days. Times the install command was copied on this site in the last 90 days, bots filtered.
8
skills.sh installs
68.3K
GitHub stars
114.6K
last updated
Aug 21, 2026

Install

$ npx -y skills add addyosmani/agent-skills --skill idea-refine --agent claude-code

Installs into .claude/skills of the current project.

Files

Idea Refine

Overview

Refines raw ideas into sharp, actionable concepts worth building through structured divergent and convergent thinking.

When to Use

  • Use when an idea is still vague and needs shaping before it can become a plan
  • Use when you need to stress-test assumptions before committing to a direction
  • Use when you want to expand options before converging on one
  • Trigger phrases: "Help me refine this idea", "Ideate on [concept]", "Stress-test my plan"
  • Not for: a user who is unsure what they want at all (use interview-me), or a direction already chosen that needs a spec (use spec-driven-development)

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.

Sponsors

Details

Repository
github.com/addyosmani/agent-skills
Categories
Testing & QA, AI & Agent Building, Productivity & Planning
First seen
Apr 16, 2026

More from addyosmani/agent-skills

All 25
1addyosmani avatarinterview-meaddyosmani/agent-skillsExtracts what the user actually wants instead of what they think they should want. Achieves this through one-question-at-a-time interview until ~95% confidence 66.4Kskills.sh installs
2msmps avataropentuimsmps/opentui-skillOpenTUI skill for building terminal user interfaces with the Core, React, or Solid APIs. Use for any TUI task including components, layout, keyboard and keymap 64.5Kskills.sh installs
3coreyhaines31 avatarpublic-relationscoreyhaines31/marketingskillsWhen the user wants help with public relations, earned media, press coverage, journalist outreach, or media strategy (not pull requests). Also use when the user62.5Kskills.sh installs
4heygen-com avatarchangelog-videoheygen-com/hyperframesTurn a weekly changelog .md into a finished branded changelog video (square 1080, ~45-60s, Annie VO, animated brand background, mock-UI visualizations, lowkey c60.6Kskills.sh installs
5useosint avataris-this-photo-realuseosint/skillsVerify whether an image or video is authentic, original and correctly captioned — provenance checks, error level analysis, noise and JPEG compression analysis, 58.3Kskills.sh installs
6coreyhaines31 avataranalytics-trackingcoreyhaines31/marketingskillsWhen the user wants to set up, improve, or audit analytics tracking and measurement. Also use when the user mentions "set up tracking," "GA4," "Google Analytics57.8Kskills.sh installs