Idea Refinement
addyosmani/agent-skills
Guides a conversation that takes a vague idea through divergent and convergent thinking and ends in a markdown one-pager covering scope and assumptions.
Guided discovery of a product idea by mining what the founder already knows or already does — covers source selection (business vs.
$ npx skills add BuildGreatProducts/builder-os --skill idea-generator -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install BuildGreatProducts/builder-os idea-generator --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/BuildGreatProducts/builder-os.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/idea-generator .claude/skills/idea-generator && rm -rf skills-srcUse ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.
Claude Code skills documentation · loads skills from .claude/skills/
Install the "idea-generator" agent skill from https://github.com/BuildGreatProducts/builder-os/tree/main/skills/idea-generator into .claude/skills/idea-generator/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "idea-generator", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/BuildGreatProducts/builder-os/tree/main/skills/idea-generatorType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add BuildGreatProducts/builder-os --skill idea-generator -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install BuildGreatProducts/builder-os idea-generator --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/BuildGreatProducts/builder-os.git skills-src && mkdir -p .agents/skills && cp -r skills-src/skills/idea-generator .agents/skills/idea-generator && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "idea-generator" agent skill from https://github.com/BuildGreatProducts/builder-os/tree/main/skills/idea-generator into .agents/skills/idea-generator/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "idea-generator", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add BuildGreatProducts/builder-os --skill idea-generator -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install BuildGreatProducts/builder-os idea-generator --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/BuildGreatProducts/builder-os.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/skills/idea-generator .cursor/skills/idea-generator && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "idea-generator" agent skill from https://github.com/BuildGreatProducts/builder-os/tree/main/skills/idea-generator into .cursor/skills/idea-generator/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "idea-generator", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/BuildGreatProducts/builder-os.git --path skills/idea-generator--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add BuildGreatProducts/builder-os --skill idea-generator -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install BuildGreatProducts/builder-os idea-generator --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/BuildGreatProducts/builder-os.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/skills/idea-generator .gemini/skills/idea-generator && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "idea-generator" agent skill from https://github.com/BuildGreatProducts/builder-os/tree/main/skills/idea-generator into .gemini/skills/idea-generator/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "idea-generator", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install BuildGreatProducts/builder-os idea-generatorInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add BuildGreatProducts/builder-os --skill idea-generator -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/BuildGreatProducts/builder-os.git skills-src && mkdir -p .github/skills && cp -r skills-src/skills/idea-generator .github/skills/idea-generator && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "idea-generator" agent skill from https://github.com/BuildGreatProducts/builder-os/tree/main/skills/idea-generator into .github/skills/idea-generator/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "idea-generator", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add BuildGreatProducts/builder-os --skill idea-generator -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install BuildGreatProducts/builder-os idea-generator --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/BuildGreatProducts/builder-os.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/skills/idea-generator .opencode/skills/idea-generator && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "idea-generator" agent skill from https://github.com/BuildGreatProducts/builder-os/tree/main/skills/idea-generator into .opencode/skills/idea-generator/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "idea-generator", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
idea-generatorGuided discovery of a product idea by mining what the founder already knows or already does — covers source selection (business vs.
Idea Generator is an agent skill from BuildGreatProducts/builder-os. Guided discovery of a product idea by mining what the founder already knows or already does — covers source selection (business vs. expertise), context capture, pattern synthesis, candidate scorecard, and writes docs/product-idea.md. Use when the founder says "generate an idea", "help me find an idea", "what should I build", "product idea from my business", "product idea from my expertise", or otherwise needs to discover a product concept worth building.
Its SKILL.md is about 3.1k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.
The repository describes itself as: BuilderOS is your operating system for building with AI. The licence is MIT.
8 steps, taken from the step headings in SKILL.md.
Read from SKILL.md and the folder at commit fb74cac. It shows what the files ask for, not the result of running them.
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
No scripts in the folder and no shell commands in SKILL.md (its code samples are markdown).
From the folder's file list and the shell code blocks in SKILL.md.
No URLs in SKILL.md.
From URLs in SKILL.md, links to its own repository left out.
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
Idea Generator loads about 3.1k tokens when it runs. Until then it costs about 119 tokens; SKILL.md has 1,602 words of instructions outside code blocks.
Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.
The automated check found no risky patterns in SKILL.md.
Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.
The full file from BuildGreatProducts/builder-os at commit fb74cac, republished under its MIT licence (© BuildGreatProducts). 1,602 words, ~3,097 tokens.
.claude/skills/idea-generator/SKILL.md (or your agent's skills folder).This skill helps a founder identify a great product idea by mining what they already know or already do. The output, docs/product-idea.md, feeds the downstream BuilderOS skills Idea Validator and Product Planner — but stands on its own if those aren't installed.
You are a product development advisor. You are warm, direct, and opinionated. You treat the founder as capable and smart — you're here to help them articulate what's already in their head, not to lecture them.
Resumability: This skill is designed to be interrupted and resumed. Always check the current project state before starting work — does docs/product-idea.md already exist? Pick up from where things left off rather than restarting.
Starting fresh (no docs/product-idea.md exists):
Run the full idea discovery conversation from Step 0.
docs/product-idea.md exists:
Read it and ask what they want to do:
Before jumping to Step 4, validate that the Step 3 scorecard is present and well-formed: read docs/product-idea.md and confirm the ## Candidates considered section exists and parses as the expected table of candidates with their five-axis ratings. If the section is missing, empty, or corrupted, do not jump to Step 4. Instead, log a clear message that the scorecard is missing or unreadable, and prompt the founder to either re-run Step 2 (Pattern Synthesis) or let you regenerate the scorecard from the remaining context before continuing.
Partial session: If the conversation is interrupted mid-flow, note where you left off and resume from that step. Don't restart.
You are a product strategist with taste. You're warm but direct, and you're opinionated. Don't flatter weak ideas and don't pretend every answer is interesting. Your job is to help the founder find something worth building — not to validate whatever they say.
Open with:
"Great ideas usually come from one of two places: a business you already run, or expertise you've built up over years. Which are we drawing from — business, expertise, or both?"
Handle the response:
Ask questions one at a time. Offer 3 tailored suggestions starting at Q3 (first two questions get no suggestions — they're the raw inputs everything else is built on). Carry each answer forward as context for later suggestions.
Run these 5 from Branch A, then these 5 from Branch B:
When Step 1 is done, summarize what you heard in 3–5 bullets — the themes, tensions, and advantages that jumped out. Be specific.
Then surface 3–5 candidate idea directions. Each candidate has:
Rank them. Lead with your strongest recommendation and say why. Don't hedge — the founder can override.
Candidates should lean on the founder's actual inputs. If you invent an idea unrelated to what they said, you've done this wrong.
For each candidate, score five axes with a single traffic-light rating and a one-line rationale:
| Axis | Question | Rating |
|---|---|---|
| Unfair advantage | Is this founder uniquely positioned to build this? | 🟢 / 🟡 / 🔴 |
| Pain level | Is this a real, painful, paid-for problem? | 🟢 / 🟡 / 🔴 |
| Audience reachability | Can the founder reach these users without a huge budget? | 🟢 / 🟡 / 🔴 |
| MVP feasibility | Can a small team ship a useful v1 in 4–8 weeks? | 🟢 / 🟡 / 🔴 |
| Differentiation | Is there a clear reason to pick this over existing alternatives? | 🟢 / 🟡 / 🔴 |
Show the scorecard as a table the founder can read at a glance. Red scores are not disqualifying — they're the risky assumptions to validate.
Recommend the strongest candidate. Explain the call in two sentences — what it has going for it and what's worth worrying about. Invite the founder to:
Blends must combine complementary aspects — e.g., the same target user with adjacent features — not merge distinct user bases or unrelated problem spaces. Acceptable: "bookkeepers doing reconciliation" + "bookkeepers doing client reporting" (same user, different features). Not acceptable: "bookkeepers doing reconciliation" + "dentists managing appointments" (different users, different problems).
If they blend, re-score the blended idea before moving on.
Tighten the chosen idea across five fields. Ask for each, offer suggestions, and push back if answers stay vague.
If the founder's answers don't hold up to gentle pressure, say so and sharpen them together.
docs/product-idea.mdWrite the file to docs/product-idea.md. Create the docs/ directory if it doesn't already exist. Use this structure:
# Product Idea — [Working name, if any]
## One-liner
[One sentence: what it is and who it's for.]
## Background
[2–3 sentences on the founder's business or expertise context. Why this idea is coming from this person at this moment.]
## The problem
[Who feels the pain, what the pain is, and how they handle it today. Use the founder's and their users' language.]
## Target user
[Specific persona. Role, context, scale. Not "small businesses."]
## Proposed solution
[What the product does and the magic moment — the one flow that proves the concept.]
## Why you
[The unfair advantage. One clear sentence, plus evidence.]
## Candidates considered
[Table of the 3–5 candidates from Step 2 with their scorecards. Preserved for the record — useful if the founder wants to revisit later.]
## Risky assumptions
[The top 3 assumptions that must be true. These are what the founder should validate next.]
## Next step
Pressure-test this idea with the **Idea Validator** skill before planning, or run the **Product Planner** skill to turn it straight into a product vision, PRD, and roadmap. This document will pre-fill much of that work.Write the file, then verify the write succeeded before confirming. If the write fails, catch the error and surface a clear, user-friendly message based on the cause — for example:
docs/product-idea.md because the directory isn't writable. Check folder permissions and try again."docs/product-idea.md already exists and can't be overwritten. Want me to save under a different name or overwrite it?"Only confirm "saved" to the founder after the write is verified successful. On failure, do not send the confirmation message and do not advance to Step 7 until the file is written.
After writing docs/product-idea.md, say:
"Your idea is captured. Two ways to go from here:
- Pressure-test it first — run the Idea Validator skill to surface fatal flaws, test whether the problem is real, and lock in a 2-week MVP test before you invest in planning. Recommended.
- Jump to planning — run the Product Planner skill to walk through the vision intake. Most of what you answered here will carry forward."
If the Idea Validator or Product Planner skill is not installed, append:
"Both skills are part of BuilderOS: https://github.com/BuildGreatProducts/builder-os"
If the founder wants to continue immediately and the relevant skill is installed, hand off — the receiving skill will use docs/product-idea.md as pre-filled context.
If the founder wants to change something after docs/product-idea.md exists:
Always preserve the Candidates considered section when editing — it's a record of thinking, not just the current answer.
© BuildGreatProducts, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file
Just SKILL.md in skills/idea-generator of BuildGreatProducts/builder-os.
Open the folder on GitHubat commit fb74cac
Idea Generator next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| Idea Generator this skillBuildGreatProducts/builder-os | 228 | — | ~3.1k | Automated safety check: Pass | MIT | |
| Idea Refinementaddyosmani/agent-skills | 104k | 6 repos | ~2k | Automated safety check: Pass | MIT | |
| HTML PPT Studiolewislulu/html-ppt-skill | 8.6k | 4 repos | ~4.7k | Automated safety check: Pass | MIT | |
| Agent Browserquran/quran.com-frontend-next | 1.9k | 40 repos | ~3.3k | Automated safety check: Pass | None | |
| Dependency Watchtelegramdesktop/tdesktop | 33k | 1 repos | ~2.2k | Automated safety check: Pass | GPL-3.0 | |
| Perform Tasktelegramdesktop/tdesktop | 33k | 2 repos | ~3k | Automated safety check: Pass | GPL-3.0 |
addyosmani/agent-skills
Guides a conversation that takes a vague idea through divergent and convergent thinking and ends in a markdown one-pager covering scope and assumptions.
lewislulu/html-ppt-skill
Authors static HTML presentations from a library of themes, layouts and animations, with keyboard navigation, for talks, pitch decks and reports.
quran/quran.com-frontend-next
Automates browser interactions for web testing, form filling, screenshots, and data extraction.
telegramdesktop/tdesktop
Audit Telegram Desktop dependencies on freshly fetched origin/dev for releases and security fixes, including upstream lag and backport candidates in patched forks.
telegramdesktop/tdesktop
Resolve, start or resume, implement, review, test, and publish exactly one existing ai-tdesktop task by short slug or full dated id, including rare blocked retries and split-required results.
badlogic/pi-skills
Web search and content extraction via Brave Search API. An agent skill from badlogic/pi-skills.
BuildGreatProducts/builder-os
Translates an image (or a set of image references — screenshots, mockups, Figma URLs, live websites) into two mirrored design-system artifacts: docs/design.md (YAML tokens + prose, following…
BuildGreatProducts/builder-os
Pressure-tests a product idea before the founder invests in planning, building, or launching.
BuildGreatProducts/builder-os
Vision intake conversation followed by generation of three product documents — docs/product-vision.md (strategy and brand), docs/prd.md (technical spec for coding agents), and…
BuildGreatProducts/builder-os
A skill your agent uses when building features with Codex (OpenAI Codex CLI) in any codebase and the work should go through a disciplined build → review → test → fix loop.
BuildGreatProducts/builder-os
A skill your agent uses when building features with Cursor in any codebase and the work should go through a disciplined build → review → test → fix loop.
BuildGreatProducts/builder-os
Use inside a product repository when the user wants the full MVP built from their BuilderOS spec documents.
Guided discovery of a product idea by mining what the founder already knows or already does — covers source selection (business vs. Idea Generator is an agent skill from BuildGreatProducts/builder-os. Guided discovery of a product idea by mining what the founder already knows or already does — covers source selection (business vs.
Idea Generator fits situations like: the founder says generate an idea; help me find an idea; what should I build; product idea from my business.
Run `npx skills add BuildGreatProducts/builder-os --skill idea-generator -a claude-code`. Or copy the skill folder (skills/idea-generator in BuildGreatProducts/builder-os) into .claude/skills/idea-generator in your project. Claude Code loads it when a task matches its description.
Run `npx skills add BuildGreatProducts/builder-os --skill idea-generator -a codex`. Or copy the skill folder (skills/idea-generator in BuildGreatProducts/builder-os) into .agents/skills/idea-generator in your project. Codex loads it when a task matches its description.
Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add BuildGreatProducts/builder-os --skill idea-generator -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/idea-generator, .gemini/skills/idea-generator, .github/skills/idea-generator and .opencode/skills/idea-generator in your project.
SKILL.md names no scripts, command-line tools or credentials: Idea Generator is instructions for the agent only.
SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.
Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.
Idea Generator is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.
About 3.1k tokens (SKILL.md is roughly 12k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.
Skills that share tags, products or a category with Idea Generator: Idea Refinement (addyosmani/agent-skills, 104k stars), HTML PPT Studio (lewislulu/html-ppt-skill, 8.6k stars), Agent Browser (quran/quran.com-frontend-next, 1.9k stars) and Dependency Watch (telegramdesktop/tdesktop, 33k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
BuildGreatProducts (a GitHub user) maintains it in BuildGreatProducts/builder-os, which has 228 GitHub stars. The repository holds 8 skills in this directory. The repository was last updated on July 7, 2026.
Source: BuildGreatProducts/builder-os on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.