idea-refine

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

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve? Vague ideas often jump straight to planning without stress-testing assumptions, exploring alternatives, or defining who the idea is actually for. This Skill guides a structured ideation dialogue that expands options, evaluates them honestly, and produces a concrete markdown one-pager with explicit assumptions and a Not Doing list. ## Core Features & Use Cases - Three-Phase Ideation Process: Runs divergent expansion (How Might We framing, sharpening questions, 5-8 idea variations), convergent evaluation (clustering, stress-testing against user value, feasibility, and differentiation), and sharpening into a final artifact. - Assumption Surfacing: Explicitly names dealbreaker assumptions, hidden risks, and what could kill each direction before any commitment is made. - Codebase-Aware Ideation: When run inside a project, scans existing architecture and constraints to ground idea variations in what actually exists. - Use Case: A founder has a rough concept like "help local restaurants compete with delivery platforms." The Skill reframes the problem, generates six distinct directions, stress-tests the strongest ones, and outputs a one-pager with MVP scope, validation tests, and an explicit Not Doing list saved to docs/ideas/. ## 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 small restaurants keep their regular customers ordering directly."

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 product idea before building it?

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 the strongest directions against user value and feasibility, then producing a markdown one-pager with MVP scope and assumptions to validate.

What is the output of an idea refinement session?

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

Can 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. It references specific files when generating and evaluating directions.

When should I not use structured ideation?

Skip it when the idea is already well-defined with a clear user and validated assumptions, or when you need execution rather than exploration. The skill is designed for the fuzzy front end before specs and plans exist, not for refining already-approved work.

How does the skill avoid generating shallow idea lists?

It caps variations at 5-8 considered options, each generated through a named lens like inversion, constraint removal, or audience shift with a reason it exists. It also pushes back on weak ideas with specificity rather than acting as a yes-machine.