idea-refine

Refines raw ideas into actionable one-pagers through structured divergent and convergent thinking.

1|Updated Sep 4, 2026
One-click install
npx skills add https://github.com/SanHsien/agent-skills --skill idea-refine-sanhsien
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: idea-refine
Source: https://github.com/SanHsien/agent-skills/tree/main/skills/idea-refine
Command: npx skills add https://github.com/SanHsien/agent-skills --skill idea-refine-sanhsien

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve? Raw ideas are often vague, untested, and overloaded with hidden assumptions, leading teams to commit to plans before validating whether the idea is worth building. This Skill guides a structured ideation dialogue that sharpens fuzzy concepts into concrete, validated directions. ## Core Features & Use Cases - Three-Phase Ideation Process: Divergent expansion (restate the idea as a How Might We statement, ask sharpening questions, generate 5-8 variations), convergent evaluation (cluster, stress-test against user value, feasibility, and differentiation), and sharpening into a final artifact. - Assumption Auditing: Explicitly surfaces dealbreaker, important, and nice-to-have assumptions with validation strategies before any commitment. - Concrete Output Artifact: Produces a markdown one-pager saved to docs/ideas/ containing a problem statement, recommended direction, MVP scope, and a Not Doing list. - Use Case: A founder with a vague startup concept invokes the skill, gets pushed through sharpening questions and idea variations, receives honest pushback on weak directions, and walks away with a scoped MVP plan and explicit trade-offs. ## Quick Start Ask the agent to help you refine or stress-test your idea by describing the concept you want to explore.

Frequently Asked Questions about idea-refine

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I refine a vague idea into an actionable plan?

Invoke the skill with your raw idea and it guides you through three phases: expanding the idea into 5-8 variations using lenses like inversion and simplification, stress-testing directions against user value and feasibility, then producing a markdown one-pager with MVP scope and explicit trade-offs.

How to stress-test assumptions before committing to a product idea?

The skill's Phase 2 explicitly surfaces hidden assumptions in three tiers: dealbreakers that kill the idea if wrong, important assumptions affecting approach, and nice-to-haves. Each assumption gets a validation strategy before any building begins.

What output does the idea refinement process produce?

The final output is a markdown one-pager saved to docs/ideas/ after your confirmation. It contains a How Might We problem statement, recommended direction, key assumptions to validate, MVP scope, a Not Doing list, and open questions.

Does idea refinement work inside an existing codebase?

Yes. When run inside a project, the skill scans the codebase using Glob, Grep, and Read to ground idea variations in existing architecture, patterns, and constraints, referencing specific files when relevant.

When should I not use structured ideation for an idea?

Skip it when the idea is already well-defined with validated assumptions and a clear user, or when you need immediate execution rather than exploration. The process is designed for vague concepts, not finalized specs.