{"id":"46270625-87a3-43f9-8331-e3d6a6e48098","shortId":"ZMK59V","kind":"skill","title":"Idea Refine","tagline":"Agent Skills skill by Addyosmani","description":"# Idea Refine\n\nRefines raw ideas into sharp, actionable concepts worth building through structured divergent and convergent thinking.\n\n## How It Works\n\n1.  **Understand & Expand (Divergent):** Restate the idea, ask sharpening questions, and generate variations.\n2.  **Evaluate & Converge:** Cluster ideas, stress-test them, and surface hidden assumptions.\n3.  **Sharpen & Ship:** Produce a concrete markdown one-pager moving work forward.\n\n## Usage\n\nThis skill is primarily an interactive dialogue. Invoke it with an idea, and the agent will guide you through the process.\n\n```bash\n# Optional: Initialize the ideas directory\nbash /mnt/skills/user/idea-refine/scripts/idea-refine.sh\n```\n\n**Trigger Phrases:**\n- \"Help me refine this idea\"\n- \"Ideate on [concept]\"\n- \"Stress-test my plan\"\n\n## Output\n\nThe final output is a markdown one-pager saved to `docs/ideas/[idea-name].md` (after user confirmation), containing:\n- Problem Statement\n- Recommended Direction\n- Key Assumptions\n- MVP Scope\n- Not Doing list\n\n## Detailed Instructions\n\nYou are an ideation partner. Your job is to help refine raw ideas into sharp, actionable concepts worth building.\n\n### Philosophy\n\n- Simplicity is the ultimate sophistication. Push toward the simplest version that still solves the real problem.\n- Start with the user experience, work backwards to technology.\n- Say no to 1,000 things. Focus beats breadth.\n- Challenge every assumption. \"How it's usually done\" is not a reason.\n- Show people the future — don't just give them better horses.\n- The parts you can't see should be as beautiful as the parts you can.\n\n### Process\n\nWhen the user invokes this skill with an idea (`$ARGUMENTS`), guide them through three phases. Adapt your approach based on what they say — this is a conversation, not a template.\n\n#### Phase 1: Understand & Expand (Divergent)\n\n**Goal:** Take the raw idea and open it up.\n\n1. **Restate the idea** as a crisp \"How Might We\" problem statement. This forces clarity on what's actually being solved.\n\n2. **Ask 3-5 sharpening questions** — no more. Focus on:\n   - Who is this for, specifically?\n   - What does success look like?\n   - What are the real constraints (time, tech, resources)?\n   - What's been tried before?\n   - Why now?\n\n   Use the `AskUserQuestion` tool to gather this input. Do NOT proceed until you understand who this is for and what success looks like.\n\n3. **Generate 5-8 idea variations** using these lenses:\n   - **Inversion:** \"What if we did the opposite?\"\n   - **Constraint removal:** \"What if budget/time/tech weren't factors?\"\n   - **Audience shift:** \"What if this were for [different user]?\"\n   - **Combination:** \"What if we merged this with [adjacent idea]?\"\n   - **Simplification:** \"What's the version that's 10x simpler?\"\n   - **10x version:** \"What would this look like at massive scale?\"\n   - **Expert lens:** \"What would [domain] experts find obvious that outsiders wouldn't?\"\n\n   Push beyond what the user initially asked for. Create products people don't know they need yet.\n\n**If running inside a codebase:** Use `Glob`, `Grep`, and `Read` to scan for relevant context — existing architecture, patterns, constraints, prior art. Ground your variations in what actually exists. Reference specific files and patterns when relevant.\n\nRead `frameworks.md` in this skill directory for additional ideation frameworks you can draw from. Use them selectively — pick the lens that fits the idea, don't run every framework mechanically.\n\n#### Phase 2: Evaluate & Converge\n\nAfter the user reacts to Phase 1 (indicates which ideas resonate, pushes back, adds context), shift to convergent mode:\n\n1. **Cluster** the ideas that resonated into 2-3 distinct directions. Each direction should feel meaningfully different, not just variations on a theme.\n\n2. **Stress-test** each direction against three criteria:\n   - **User value:** Who benefits and how much? Is this a painkiller or a vitamin?\n   - **Feasibility:** What's the technical and resource cost? What's the hardest part?\n   - **Differentiation:** What makes this genuinely different? Would someone switch from their current solution?\n\n   Read `refinement-criteria.md` in this skill directory for the full evaluation rubric.\n\n3. **Surface hidden assumptions.** For each direction, explicitly name:\n   - What you're betting is true (but haven't validated)\n   - What could kill this idea\n   - What you're choosing to ignore (and why that's okay for now)\n\n   This is where most ideation fails. Don't skip it.\n\n**Be honest, not supportive.** If an idea is weak, say so with kindness. A good ideation partner is not a yes-machine. Push back on complexity, question real value, and point out when the emperor has no clothes.\n\n#### Phase 3: Sharpen & Ship\n\nProduce a concrete artifact — a markdown one-pager that moves work forward:\n\n```markdown\n# [Idea Name]\n\n## Problem Statement\n[One-sentence \"How Might We\" framing]\n\n## Recommended Direction\n[The chosen direction and why — 2-3 paragraphs max]\n\n## Key Assumptions to Validate\n- [ ] [Assumption 1 — how to test it]\n- [ ] [Assumption 2 — how to test it]\n- [ ] [Assumption 3 — how to test it]\n\n## MVP Scope\n[The minimum version that tests the core assumption. What's in, what's out.]\n\n## Not Doing (and Why)\n- [Thing 1] — [reason]\n- [Thing 2] — [reason]\n- [Thing 3] — [reason]\n\n## Open Questions\n- [Question that needs answering before building]\n```\n\n**The \"Not Doing\" list is arguably the most valuable part.** Focus is about saying no to good ideas. Make the trade-offs explicit.\n\nAsk the user if they'd like to save this to `docs/ideas/[idea-name].md` (or a location of their choosing). Only save if they confirm.\n\n### Anti-patterns to Avoid\n\n- **Don't generate 20+ ideas.** Quality over quantity. 5-8 well-considered variations beat 20 shallow ones.\n- **Don't be a yes-machine.** Push back on weak ideas with specificity and kindness.\n- **Don't skip \"who is this for.\"** Every good idea starts with a person and their problem.\n- **Don't produce a plan without surfacing assumptions.** Untested assumptions are the #1 killer of good ideas.\n- **Don't over-engineer the process.** Three phases, each doing one thing well. Resist adding steps.\n- **Don't just list ideas — tell a story.** Each variation should have a reason it exists, not just be a bullet point.\n- **Don't ignore the codebase.** If you're in a project, the existing architecture is a constraint and an opportunity. Use it.\n\n### Tone\n\nDirect, thoughtful, slightly provocative. You're a sharp thinking partner, not a facilitator reading from a script. Channel the energy of \"that's interesting, but what if...\" -- always pushing one step further without being exhausting.\n\nRead `examples.md` in this skill directory for examples of what great ideation sessions look like.\n\n## Red Flags\n\n- Generating 20+ shallow variations instead of 5-8 considered ones\n- Skipping the \"who is this for\" question\n- No assumptions surfaced before committing to a direction\n- Yes-machining weak ideas instead of pushing back with specificity\n- Producing a plan without a \"Not Doing\" list\n- Ignoring existing codebase constraints when ideating inside a project\n- Jumping straight to Phase 3 output without running Phases 1 and 2\n\n## Verification\n\nAfter completing an ideation session:\n\n- [ ] A clear \"How Might We\" problem statement exists\n- [ ] The target user and success criteria are defined\n- [ ] Multiple directions were explored, not just the first idea\n- [ ] Hidden assumptions are explicitly listed with validation strategies\n- [ ] A \"Not Doing\" list makes trade-offs explicit\n- [ ] The output is a concrete artifact (markdown one-pager), not just conversation\n- [ ] The user confirmed the final direction before any implementation work","tags":["idea","refine","agent","skills","addyosmani"],"capabilities":["skill","source-addyosmani","category-agent-skills"],"categories":["agent-skills"],"synonyms":[],"warnings":[],"endpointUrl":"https://skills.sh/addyosmani/agent-skills/idea-refine","protocol":"skill","transport":"skills-sh","auth":{"type":"none","details":{"install_from":"skills.sh"}},"qualityScore":"0.300","qualityRationale":"deterministic score 0.30 from registry signals: · indexed on skills.sh · published under addyosmani/agent-skills","verified":false,"liveness":"unknown","lastLivenessCheck":null,"agentReviews":{"count":0,"score_avg":null,"cost_usd_avg":null,"success_rate":null,"latency_p50_ms":null,"narrative_summary":null,"summary_updated_at":null},"enrichmentModel":"deterministic:skill:v1","enrichmentVersion":1,"enrichedAt":"2026-04-22T11:40:30.659Z","embedding":null,"createdAt":"2026-04-18T20:31:42.038Z","updatedAt":"2026-04-22T11:40:30.659Z","lastSeenAt":"2026-04-22T11:40:30.659Z","tsv":"'-3':548,746 '-5':307 '-8':365,873,1053 '/mnt/skills/user/idea-refine/scripts/idea-refine.sh':96 '000':195 '1':28,194,270,283,527,540,754,792,927,1108 '10x':411,413 '2':41,304,518,547,563,745,760,795,1110 '20':867,879,1047 '3':54,306,362,623,710,766,798,1103 '5':364,872,1052 'action':15,161 'actual':301,478 'ad':947 'adapt':254 'add':534 'addit':494 'addyosmani':7 'adjac':402 'agent':3,82 'alway':1021 'answer':805 'anti':860 'anti-pattern':859 'approach':256 'architectur':468,984 'arguabl':813 'argument':248 'art':472 'artifact':716,1164 'ask':35,305,441,832 'askuserquest':341 'assumpt':53,138,202,626,750,753,759,765,780,922,924,1064,1143 'audienc':386 'avoid':863 'back':533,694,890,1079 'backward':188 'base':257 'bash':89,95 'beat':198,878 'beauti':232 'benefit':575 'bet':635 'better':221 'beyond':436 'breadth':199 'budget/time/tech':382 'build':18,164,807 'bullet':969 'category-agent-skills' 'challeng':200 'channel':1011 'choos':650,853 'chosen':741 'clariti':297 'clear':1118 'cloth':708 'cluster':44,541 'codebas':456,975,1092 'combin':395 'commit':1067 'complet':1113 'complex':696 'concept':16,106,162 'concret':59,715,1163 'confirm':131,858,1174 'consid':876,1054 'constraint':328,378,470,987,1093 'contain':132 'context':466,535 'converg':23,43,520,538 'convers':265,1171 'core':779 'cost':593 'could':643 'creat':443 'crisp':289 'criteria':571,1130 'current':610 'd':837 'defin':1132 'detail':144 'dialogu':74 'differ':393,556,604 'differenti':599 'direct':136,550,552,568,629,739,742,994,1070,1134,1177 'directori':94,492,617,1034 'distinct':549 'diverg':21,31,273 'docs/ideas':124,843 'domain':427 'done':207 'draw':499 'emperor':705 'energi':1013 'engin':936 'evalu':42,519,621 'everi':201,514,905 'exampl':1036 'examples.md':1030 'exhaust':1028 'exist':467,479,964,983,1091,1124 'expand':30,272 'experi':186 'expert':423,428 'explicit':630,831,1145,1158 'explor':1136 'facilit':1006 'factor':385 'fail':665 'feasibl':586 'feel':554 'file':482 'final':114,1176 'find':429 'first':1140 'fit':508 'flag':1045 'focus':197,312,818 'forc':296 'forward':66,725 'frame':737 'framework':496,515 'frameworks.md':488 'full':620 'futur':215 'gather':344 'generat':39,363,866,1046 'genuin':603 'give':219 'glob':458 'goal':274 'good':684,824,906,930 'great':1039 'grep':459 'ground':473 'guid':84,249 'hardest':597 'haven':639 'help':99,155 'hidden':52,625,1142 'honest':671 'hors':222 'idea':1,8,12,34,45,79,93,103,126,158,247,278,286,366,403,510,530,543,646,676,727,825,845,868,893,907,931,953,1075,1141 'idea-nam':125,844 'ideat':104,149,495,664,685,1040,1095,1115 'ignor':652,973,1090 'implement':1180 'indic':528 'initi':91,440 'input':346 'insid':454,1096 'instead':1050,1076 'instruct':145 'interact':73 'interest':1017 'invers':371 'invok':75,242 'job':152 'jump':1099 'key':137,749 'kill':644 'killer':928 'kind':682,897 'know':448 'len':424,506 'lens':370 'like':323,361,419,838,1043 'list':143,811,952,1089,1146,1153 'locat':850 'look':322,360,418,1042 'machin':692,888,1073 'make':601,826,1154 'markdown':60,118,718,726,1165 'massiv':421 'max':748 'md':128,847 'meaning':555 'mechan':516 'merg':399 'might':291,735,1120 'minimum':774 'mode':539 'move':64,723 'much':578 'multipl':1133 'mvp':139,771 'name':127,631,728,846 'need':450,804 'obvious':430 'off':830,1157 'okay':657 'one':62,120,720,732,881,943,1023,1055,1167 'one-pag':61,119,719,1166 'one-sent':731 'open':280,800 'opportun':990 'opposit':377 'option':90 'output':112,115,1104,1160 'outsid':432 'over-engin':934 'pager':63,121,721,1168 'painkil':582 'paragraph':747 'part':224,235,598,817 'partner':150,686,1003 'pattern':469,484,861 'peopl':213,445 'person':911 'phase':253,269,517,526,709,940,1102,1107 'philosophi':165 'phrase':98 'pick':504 'plan':111,919,1084 'point':701,970 'primarili':71 'prior':471 'problem':133,181,293,729,914,1122 'proceed':349 'process':88,238,938 'produc':57,713,917,1082 'product':444 'project':981,1098 'provoc':997 'push':171,435,532,693,889,1022,1078 'qualiti':869 'quantiti':871 'question':37,309,697,801,802,1062 'raw':11,157,277 're':634,649,978,999 'react':524 'read':461,487,612,1007,1029 'real':180,327,698 'reason':211,793,796,799,962 'recommend':135,738 'red':1044 'refer':480 'refin':2,9,10,101,156 'refinement-criteria.md':613 'relev':465,486 'remov':379 'resist':946 'reson':531,545 'resourc':331,592 'restat':32,284 'rubric':622 'run':453,513,1106 'save':122,840,855 'say':191,261,679,821 'scale':422 'scan':463 'scope':140,772 'script':1010 'see':228 'select':503 'sentenc':733 'session':1041,1116 'shallow':880,1048 'sharp':14,160,1001 'sharpen':36,55,308,711 'shift':387,536 'ship':56,712 'show':212 'simpler':412 'simplest':174 'simplic':166 'simplif':404 'skill':4,5,69,244,491,616,1033 'skip':668,900,1056 'slight':996 'solut':611 'solv':178,303 'someon':606 'sophist':170 'source-addyosmani' 'specif':318,481,895,1081 'start':182,908 'statement':134,294,730,1123 'step':948,1024 'still':177 'stori':956 'straight':1100 'strategi':1149 'stress':47,108,565 'stress-test':46,107,564 'structur':20 'success':321,359,1129 'support':673 'surfac':51,624,921,1065 'switch':607 'take':275 'target':1126 'tech':330 'technic':590 'technolog':190 'tell':954 'templat':268 'test':48,109,566,757,763,769,777 'theme':562 'thing':196,791,794,797,944 'think':24,1002 'thought':995 'three':252,570,939 'time':329 'tone':993 'tool':342 'toward':172 'trade':829,1156 'trade-off':828,1155 'tri':335 'trigger':97 'true':637 'ultim':169 'understand':29,271,352 'untest':923 'usag':67 'use':339,368,457,501,991 'user':130,185,241,394,439,523,572,834,1127,1173 'usual':206 'valid':641,752,1148 'valu':573,699 'valuabl':816 'variat':40,367,475,559,877,958,1049 'verif':1111 'version':175,408,414,775 'vitamin':585 'weak':678,892,1074 'well':875,945 'well-consid':874 'weren':383 'without':920,1026,1085,1105 'work':27,65,187,724,1181 'worth':17,163 'would':416,426,605 'wouldn':433 'yes':691,887,1072 'yes-machin':690,886,1071 'yet':451","prices":[{"id":"2085046a-6821-4519-9cbe-82dd16ba8682","listingId":"46270625-87a3-43f9-8331-e3d6a6e48098","amountUsd":"0","unit":"free","nativeCurrency":null,"nativeAmount":null,"chain":null,"payTo":null,"paymentMethod":"skill-free","isPrimary":true,"details":{"org":"addyosmani","category":"agent-skills","install_from":"skills.sh"},"createdAt":"2026-04-18T20:31:42.038Z"}],"sources":[{"listingId":"46270625-87a3-43f9-8331-e3d6a6e48098","source":"github","sourceId":"addyosmani/agent-skills/idea-refine","sourceUrl":"https://github.com/addyosmani/agent-skills/tree/main/skills/idea-refine","isPrimary":false,"firstSeenAt":"2026-04-18T21:53:01.140Z","lastSeenAt":"2026-04-22T06:52:42.393Z"},{"listingId":"46270625-87a3-43f9-8331-e3d6a6e48098","source":"skills_sh","sourceId":"addyosmani/agent-skills/idea-refine","sourceUrl":"https://skills.sh/addyosmani/agent-skills/idea-refine","isPrimary":true,"firstSeenAt":"2026-04-18T20:31:42.038Z","lastSeenAt":"2026-04-22T11:40:30.659Z"}],"details":{"listingId":"46270625-87a3-43f9-8331-e3d6a6e48098","quickStartSnippet":null,"exampleRequest":null,"exampleResponse":null,"schema":null,"openapiUrl":null,"agentsTxtUrl":null,"citations":[],"useCases":[],"bestFor":[],"notFor":[],"kindDetails":{"org":"addyosmani","slug":"idea-refine","source":"skills_sh","category":"agent-skills","skills_sh_url":"https://skills.sh/addyosmani/agent-skills/idea-refine"},"updatedAt":"2026-04-22T11:40:30.659Z"}}