This skill should be used when the user wants to sharpen, distill, or pressure-test an existing idea. Triggers include "refine this idea", "what's the core of this", "help me cut this down", "is this idea any good", "challenge this idea", "help me decide if this is worth pursuing", "strip this back", "what's essential here", or when an idea has too many features and needs focus.
From ideasnpx claudepluginhub aaronbassett/agent-foundry --plugin ideasThis skill uses the workspace's default tool permissions.
references/refinement-techniques.mdSearches, retrieves, and installs Agent Skills from prompts.chat registry using MCP tools like search_skills and get_skill. Activates for finding skills, browsing catalogs, or extending Claude.
Searches prompts.chat for AI prompt templates by keyword or category, retrieves by ID with variable handling, and improves prompts via AI. Use for discovering or enhancing prompts.
Guides agent creation for Claude Code plugins with file templates, frontmatter specs (name, description, model), triggering examples, system prompts, and best practices.
Strip ideas down to their irreducible core. Where ideation expands the possibility space, refinement contracts it - ruthlessly removing everything that isn't essential until only the idea's true heart remains. The output is a sharp, focused brief that captures what matters and explicitly discards what doesn't.
<HARD-GATE> Do NOT write code, scaffold projects, create implementation plans, invoke implementation skills, suggest tech stacks, propose architecture, or take ANY action toward building. This skill produces a refined brief. Implementation decisions happen later. </HARD-GATE>Match the refinement intensity to how the user frames their request. Detect the appropriate mode from their language:
Ruthless mode - Triggered by: "challenge this", "don't hold back", "tear this apart", "be brutal", "convince me this is bad"
Firm mode (default) - Triggered by: "help me refine", "sharpen this", "improve this idea", "cut the chaff"
Socratic mode - Triggered by: "help me decide", "I'm not sure about this", "is this worth it", "what do you think"
When uncertain, use AskUserQuestion to confirm:
question: "How hard should I push on this idea?"
options:
- label: "Be ruthless"
description: "Argue against everything - only what survives deserves to stay"
- label: "Be firm (Recommended)"
description: "Challenge me, but respect my conviction when I push back"
- label: "Help me think"
description: "Ask questions that help me find clarity myself"
Create a task for each item and complete in order:
docs/ideas/YYYY-MM-DD-<topic>-refined.mdEstablish what's being refined. Check for existing vision docs in
docs/ideas/. If one exists, read it. If not, ask the user to
describe the idea.
Use AskUserQuestion to establish the starting point:
question: "What are we refining today?"
options:
- label: "An existing vision doc"
description: "There's a document in docs/ideas/ from a previous ideation session"
- label: "An idea in my head"
description: "I'll describe it - no written docs yet"
- label: "A feature list that's too long"
description: "I have too many features and need to cut"
- label: "A concept I'm unsure about"
description: "I need help deciding if this is worth pursuing at all"
Force the idea into a single sentence. This is the hardest and most important step. If the idea cannot be expressed in one clear sentence, it is not yet understood.
Use AskUserQuestion to drive toward clarity:
question: "In one sentence, what is this idea?"
options:
- label: "It's [X] for [audience] that [value]"
description: "A product/service framing"
- label: "It solves [problem] by [approach]"
description: "A problem/solution framing"
- label: "I can't say it in one sentence"
description: "That's exactly what we need to fix"
If the user selects "I can't say it in one sentence," that is the most important signal. The refinement process begins there.
Techniques for finding the core:
Systematically challenge every element of the idea. Adapt approach to the detected intensity mode.
For each feature or element, use AskUserQuestion:
question: "Does [Feature X] survive the cut?"
options:
- label: "Essential - can't ship without it"
description: "Remove this and the core value proposition breaks"
- label: "Important but not essential"
description: "Adds real value but the idea works without it"
- label: "Nice to have"
description: "Would be great eventually but isn't the point"
- label: "Kill it"
description: "Doesn't belong - was scope creep or wishful thinking"
In ruthless mode: Argue against "essential" selections. Demand proof. "You said this is essential - what breaks without it? Be specific." If the answer is vague, downgrade it.
In firm mode: Accept "essential" when the user can articulate why in one sentence. Push back on "important but not essential" - challenge whether it should be killed entirely.
In socratic mode: Ask "What would happen if we removed this?" and let the user discover whether it matters. Follow up with "And would that be a problem?" to surface hidden assumptions.
Use multiSelect for batch prioritization:
question: "Pick ONLY the 3 features that matter most. Everything else gets cut."
multiSelect: true
options:
- label: "[Feature A]"
description: "Brief description"
- label: "[Feature B]"
description: "Brief description"
- label: "[Feature C]"
description: "Brief description"
- label: "[Feature D]"
description: "Brief description"
The constraint of "only 3" is deliberate. Expansion is the enemy. If the user tries to keep 4, push back: "Which of these four would you cut if forced?" Everyone is eventually forced - shipping forces it, budget forces it, time forces it. Better to choose now than have reality choose later.
After cutting, test whether the user believes in what remains.
question: "Look at what survived. Is THIS the idea you're excited about?"
options:
- label: "Yes - this is sharper and better"
description: "The cuts clarified what matters"
- label: "I cut too deep"
description: "Something essential got removed - let's revisit"
- label: "I'm not sure anymore"
description: "The refinement process has changed how I see the idea"
- label: "The idea isn't strong enough"
description: "What remains doesn't excite me - maybe this isn't the right idea"
"The idea isn't strong enough" is a valid and valuable outcome. Killing a weak idea early saves months of wasted effort. Treat this as a success, not a failure.
"I cut too deep" means return to Phase 3 and restore selectively. But challenge each restoration: "Why does this need to come back?"
Write the refined brief to
docs/ideas/YYYY-MM-DD-<topic>-refined.md:
# [Idea Name] - Refined Brief
## One Sentence
[The single sentence that captures the entire idea]
## The Core
[2-3 sentences expanding on the one sentence - what it is, who
it's for, why it matters]
## What Survived (and Why)
[Bulleted list of features/elements that earned their place,
with one-sentence justification for each]
## What Got Cut (and Why)
[Bulleted list of features/elements that were removed, with
one-sentence reason for each cut]
## Remaining Tensions
[Any unresolved conflicts or open questions from the refinement]
## Conviction Level
[Honest assessment: How strongly does the user believe in what
remains? What would increase conviction?]
If a vision doc from ideation exists, note which elements from the original vision survived refinement and which were cut.
For detailed refinement techniques and forcing functions:
references/refinement-techniques.md - Prioritization
frameworks, elimination exercises, conviction testing methods