idea-refine
A skill from Addy Osmani's agent-skills collection that turns a rough idea into a one-page plan in three phases.
What the skill teaches
A skill from Addy Osmani's agent-skills collection that turns a rough idea into a one-page plan in three phases. First the agent restates the idea as a 'how might we' problem, asks three to five sharpening questions about users, success, constraints and timing, and produces five to eight variations using lenses such as inversion or a different audience, reading the codebase for context when there is one. Next it groups the stronger ideas into two or three directions and tests each for user value, feasibility and difference, listing hidden assumptions and risks. Finally it writes a markdown one-pager with the chosen direction, MVP scope, a not-doing list and open questions, saved only after the user agrees.
Capabilities
- Ask sharpening questions about an idea
- Generate variations of an idea
- Compare directions for value and feasibility
- Write a one-page plan with MVP scope
About
- Publisher
- Addy Osmani
- Tool
- Reasoning
Install
The project doesn't document install steps that we could confirm. See the project's own instructions
What's inside
- examples.md
- frameworks.md
- refinement-criteria.md
- scripts/idea-refine.sh
MCP servers and skills can run code on your computer and act on your data. Review the source before installing.
This skill includes scripts that your agent may run.
Details
| Fact | Value | Source |
|---|---|---|
| Type | Skill | |
| Tool | Reasoning | |
| Publisher | Addy Osmani | source |
| Official status | Not stated in its documentation | |
| Needs an API key or sign-in | Not stated in its documentation | |
| Includes scripts | Yes | source |
| Platforms | Not stated in its documentation | |
| AI clients | Not stated in its documentation | |
| Licence | MIT | source |
| Pricing | Not stated in its documentation | |
| Activity | Last commit Nov 1, 2026115,373 GitHub starsDownload data not available (not on npm or PyPI) | source |
| Links | Repository Website |
Other copies of this skill (8)
These differ from this skill's text. They may be adapted copies or older versions.
- idea-refinenota-america/forgecat-agent-profiles
- idea-refinenota-america/forgecat-agent-profiles
- idea-refinenota-america/forgecat-agent-profiles
- idea-refineborhen68/skillengine
- idea-refinepeterblazejewicz/claude-plugins
- idea-refinesatishkc7/claude-config
- idea-refinedanielvogler/agent-harness-config
- idea-refinetimur99/pdf2text
More from Addy Osmani
25 skills
- ci-cd-and-automation (Skill)
- api-and-interface-design (Skill)
- browser-testing-with-devtools (Skill)
- code-simplification (Skill)
- constraint-driven-development (Skill)
- using-agent-skills (Skill)
Also listed under: Reasoning
Sources
- Skill file (SKILL.md)github.com/addyosmani/agent-skills · Backs: Includes scriptsNov 10, 2026
- GitHub repositorygithub.com/addyosmani/agent-skills · Backs: Licence, Publisher, ActivityNov 11, 2026
- Folder in the repository (idea-refine)github.com/addyosmani/agent-skills · Backs: Includes scriptsNov 10, 2026