Overview
idea-refine is an open-source testing skill for Claude Code and compatible agents, published by addyosmani. Its author describes it as: “Refines raw ideas into sharp, actionable concepts through structured divergent and convergent thinking. Use when an idea is still vague, when you need to stress-test assumptions before committing to a plan, or when yo…”. The project has 98k stars on GitHub and is available under the MIT license. Add it to your setup with `/plugin marketplace add addyosmani/agent-skills`.
What idea-refine does
Refines raw ideas into sharp, actionable concepts worth building through structured divergent and convergent thinking.
What’s inside
The SKILL.md for idea-refine is organised into these sections:
- How It Works
- Usage
- Output
- Detailed Instructions
- Philosophy
- Process
- Anti-patterns to Avoid
- Tone
- Red Flags
- Verification
Installation
Add idea-refine to your agent with:
/plugin marketplace add addyosmani/agent-skillsReview a skill’s source before installing it — skills can instruct your agent to run commands. This command comes from the skill’s public repository, which is the source of truth for setup steps. New to skills? Read how to install Claude Code skills.
Supported agents
- Claude Code — ships a claude code plugin marketplace
- Codex — declared in the repository topics
- Cursor — declared in the repository topics
- Antigravity — declared in the repository topics
License
idea-refine is published under the MIT license.
Strengths
- Clear MIT license — safe to read and adapt within its terms
- Ships in addyosmani/agent-skills, an established project with 97,992 GitHub stars
- Works with Claude Code, Codex, Cursor, Antigravity
- Actively maintained — repository updated in the last 30 days
- Its repository gained 16,916 GitHub stars over the last 52 days
Author
Topics
Frequently asked questions
- What does idea-refine do?
- Refines raw ideas into sharp, actionable concepts through structured divergent and convergent thinking. Use when an idea is still vague, when you need to stress-test assumptions before committing to a plan, or when you want to expand options before converging on one. Triggers on "ideate", "refine this idea", or "stress-test my plan".
- How do I install idea-refine?
- Run /plugin marketplace add addyosmani/agent-skills in your agent, then reload your skills. Review the source at https://github.com/addyosmani/agent-skills before installing.
- Is idea-refine free to use?
- Yes. idea-refine is free and open source under the MIT license, so you can read, run, and adapt it within that license's terms.
- Which agents does idea-refine work with?
- idea-refine lists Claude Code, Codex, Cursor, and Antigravity — named in its SKILL.md, its plugin marketplace or its repository topics. Skills use the portable SKILL.md format, so other agents that read that format may load it too.
- Where does idea-refine come from?
- idea-refine ships inside addyosmani/agent-skills, a repository that contains 26 catalogued skills in total. The repository's 97,992 GitHub stars apply to that whole collection, not to this skill on its own.
