idea-refine

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

Updated Jul 1, 2026
One-click install
npx skills add https://github.com/raishoemi/traffic-sim-v2 --skill idea-refine-raishoemi
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: idea-refine
Source: https://github.com/raishoemi/traffic-sim-v2/tree/main/.github/skills/idea-refine
Command: npx skills add https://github.com/raishoemi/traffic-sim-v2 --skill idea-refine-raishoemi

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. This Skill turns a rough concept into a sharp, validated direction by guiding you through structured ideation, stress-testing, and scoping before you commit to building anything. ## Core Features & Use Cases - Divergent Ideation: Restates your idea as a "How Might We" problem statement, asks sharpening questions, and generates 5-8 variations using lenses like inversion, constraint removal, and audience shift. - Convergent Evaluation: Clusters ideas into distinct directions and stress-tests them against user value, feasibility, and differentiation, explicitly surfacing hidden assumptions. - Actionable Output: Produces a markdown one-pager with problem statement, recommended direction, assumptions to validate, MVP scope, and a "Not Doing" list, saved to docs/ideas/ after your confirmation. - Use Case: You have a vague startup idea like "help local restaurants compete with delivery apps." Invoke the skill and it guides you to a focused concept — a regulars-only SMS reordering tool — with validated assumptions and explicit scope cuts. ## Quick Start Ask the agent to help you refine or stress-test your idea, for example by saying "Help me refine this idea: a tool that helps freelancers track unpaid invoices."

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 startup or product idea?

Invoke the skill with your raw idea and it guides you through three phases: expanding the idea into 5-8 variations, stress-testing the strongest directions against value and feasibility, and producing a concrete one-pager with MVP scope and assumptions to validate.

How to stress-test assumptions before building a product?

The skill's Phase 2 explicitly surfaces hidden assumptions for each direction, categorizing what must be true, what could kill the idea, and what you are choosing to ignore. Each assumption gets paired with a validation strategy in the final output.

What ideation frameworks does this skill use?

It draws selectively from SCAMPER, How Might We reframing, first principles thinking, Jobs to Be Done, constraint-based ideation, pre-mortem analysis, and analogous inspiration. Frameworks are chosen to fit the idea rather than applied mechanically.

Can this skill work inside an existing codebase?

Yes. When run inside a project, it scans the codebase for existing architecture, patterns, and constraints, then grounds idea variations in what actually exists. It references specific files and patterns when generating directions.

What output does an ideation session produce?

The session ends with a markdown one-pager containing a problem statement, recommended direction, key assumptions with validation tests, MVP scope, a Not Doing list, and open questions. It is saved to docs/ideas/ only after you confirm.

When should I not use structured ideation?

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 skill is designed for the fuzzy front end, not for implementation planning.