Agent skill

Idea Generator

by BuildGreatProducts in BuildGreatProducts/builder-os

Guided discovery of a product idea by mining what the founder already knows or already does — covers source selection (business vs.

MITAuto-check passed

Install Idea Generator

skills CLI
$ npx skills add BuildGreatProducts/builder-os --skill idea-generator -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install BuildGreatProducts/builder-os idea-generator --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ 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-src

Use ~/.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/

Facts

Skill name
idea-generator
GitHub stars
228
Token cost
~3.1k tokens
SKILL.md length
1,602 words
Files
1
Skills in repo
8
Repo updated
First seen
Licence
MIT

At a glance

Guided discovery of a product idea by mining what the founder already knows or already does — covers source selection (business vs.

  • Works in 8 steps: Source Selection → Context Capture → Pattern Synthesis → …
  • The founder says generate an idea
  • SKILL.md covers Shared Context, Modes, Voice and Step 0: Source Selection, plus 8 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

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.

When your agent uses it

  • The founder says generate an idea
  • Help me find an idea
  • What should I build
  • Product idea from my business

Example prompts

  • “generate an idea”
  • “help me find an idea”
  • “what should I build”
  • “/idea-generator”

Workflow steps

8 steps, taken from the step headings in SKILL.md.

  1. Source Selection
  2. Context Capture
  3. Pattern Synthesis
  4. Scorecard
  5. Pick One
  6. Sharpen
  7. Write docs/product-idea.md
  8. Handoff

What it can do on your machine

Read from SKILL.md and the folder at commit fb74cac. It shows what the files ask for, not the result of running them.

  • Tool permissions

    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.

  • Runs code

    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.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

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.

Always · name and description, kept in context so the agent knows when to use it
~119
When it runs · the whole SKILL.md, loaded when a task matches
~3.1k

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.

Safety

Auto-check passed

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.

SKILL.md

The full file from BuildGreatProducts/builder-os at commit fb74cac, republished under its MIT licence (© BuildGreatProducts). 1,602 words, ~3,097 tokens.

Download SKILL.mdSave it as .claude/skills/idea-generator/SKILL.md (or your agent's skills folder).
name
idea-generator
description
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.
license
MIT
metadata.author
BuilderOS
metadata.version
1.0
metadata.compatibility
Requires file system access to write the docs/ directory.

Idea — Product Idea Discovery

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.

Shared Context

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.

Modes

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:

  • Refine the existing idea (jump to Step 5)
  • Pick a different candidate from the scorecard (jump to Step 4 — see scorecard check below)
  • Start over (confirm, then restart from Step 0)

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.


Voice

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.


Step 0: Source Selection

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:

  • Business → Branch A
  • Expertise → Branch B
  • Both → Run a trimmed version of each (5 questions per branch instead of 8)
  • "I don't know" → Ask two scouting questions: "What do you spend most of your working time on right now?" and "What's something you get unreasonably excited about?" Use the answers to recommend a branch. Then proceed.

Step 1: Context Capture

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.

Branch A — Business Process
  1. What does your business do? Plain English. No jargon. One or two sentences.
  2. Who are your customers and how do they find you?
  3. Walk me through your most common workflow. Start to finish. Where does it begin and end?
  4. Where do hours disappear each week? The time sinks — manual, repetitive, or unavoidable work.
  5. What do customers keep asking for that you don't offer? Unmet demand you've already heard.
  6. What do you know that your team or your competitors don't? Tribal knowledge. The things you'd have to document to replace yourself.
  7. What unique data, relationships, or access do you have? Moats. What would a new competitor struggle to replicate?
  8. What part of the job would you pay to delete? Friction you'd automate if you could.
Branch B — Personal Expertise
  1. What's your background? Career, craft, what you've built or been paid to do.
  2. What do you understand deeply that most people don't? A topic, system, or skill you have real depth in.
  3. What do people come to you for advice about? Repeated questions from peers, friends, or strangers.
  4. What problem have you solved the hard way that you'd re-solve for others? Something you figured out through pain or long exposure.
  5. What tool do you wish existed in your daily work? The thing that would make your own life better.
  6. What unfair advantages do you have? Access, relationships, data, taste, reputation, or time.
  7. Where have you seen existing solutions fall short? Products you use that miss the mark, and how.
  8. What could you talk about for three hours without getting bored? Obsessions are leading indicators of durable founder fit.
Branch C — Both (Trimmed)

Run these 5 from Branch A, then these 5 from Branch B:

  • A: 1, 3, 4, 5, 7
  • B: 2, 3, 5, 6, 8
Behavior rules
  • One question at a time. Don't batch.
  • Suggestions start at Q3. They should be based on everything said so far — not generic.
  • If an answer is thin ("I don't know"), probe once with a gentler version. If still thin, move on and come back.
  • Mirror back specifics the founder uses. If they say "invoice reconciliation," don't generalize it to "finance work."
  • If something surprising or promising comes up mid-question, flag it: "That's interesting — hold that thought, we'll come back to it."

Step 2: Pattern Synthesis

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:

  • Who it's for — a specific user, not "businesses"
  • What it does — one sentence
  • Why this founder — the angle only they could take

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.


Show full SKILL.md (654 more words)Show less

Step 3: Scorecard

For each candidate, score five axes with a single traffic-light rating and a one-line rationale:

AxisQuestionRating
Unfair advantageIs this founder uniquely positioned to build this?🟢 / 🟡 / 🔴
Pain levelIs this a real, painful, paid-for problem?🟢 / 🟡 / 🔴
Audience reachabilityCan the founder reach these users without a huge budget?🟢 / 🟡 / 🔴
MVP feasibilityCan a small team ship a useful v1 in 4–8 weeks?🟢 / 🟡 / 🔴
DifferentiationIs 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.


Step 4: Pick One

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:

  • Go with the recommendation
  • Pick a different candidate
  • Blend two candidates into one

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.


Step 5: Sharpen

Tighten the chosen idea across five fields. Ask for each, offer suggestions, and push back if answers stay vague.

  1. Target user — Specific. "Freelance bookkeepers who manage 10–30 small-business clients," not "small businesses."
  2. Specific problem — In the user's own words. What do they complain about today?
  3. Smallest testable version — The MVP shape. What's the one flow that proves the concept? (Focus: this is the magic moment that proves the concept.)
  4. Why you — The advantage statement. One sentence on why this founder wins.
  5. Top 3 risky assumptions — What must be true for this to work? What would kill it?

If the founder's answers don't hold up to gentle pressure, say so and sharpen them together.


Step 6: Write docs/product-idea.md

Write the file to docs/product-idea.md. Create the docs/ directory if it doesn't already exist. Use this structure:

markdown
# 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:

  • Permission denied → "I couldn't save docs/product-idea.md because the directory isn't writable. Check folder permissions and try again."
  • No space left on device (ENOSPC) → "The disk is full — free up space and I'll retry the save."
  • Existing file conflict (unexpected contents or read-only) → "A docs/product-idea.md already exists and can't be overwritten. Want me to save under a different name or overwrite it?"
  • Any other error → Report the error message verbatim and ask how to proceed.

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.


Step 7: Handoff

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.


Editing the Idea

If the founder wants to change something after docs/product-idea.md exists:

  • Small edit (wording, a single field) → update the file in place
  • Change the chosen candidate → re-run Step 4 onward from the existing scorecard
  • Rethink the idea entirely → confirm, then restart from Step 0

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

Files

Just SKILL.md in skills/idea-generator of BuildGreatProducts/builder-os.

Open the folder on GitHubat commit fb74cac

Compare with similar skills

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.

Idea Generator compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Idea Generator this skillBuildGreatProducts/builder-os228—~3.1kAutomated safety check: PassMIT
Idea Refinementaddyosmani/agent-skills104k6 repos~2kAutomated safety check: PassMIT
HTML PPT Studiolewislulu/html-ppt-skill8.6k4 repos~4.7kAutomated safety check: PassMIT
Agent Browserquran/quran.com-frontend-next1.9k40 repos~3.3kAutomated safety check: PassNone
Dependency Watchtelegramdesktop/tdesktop33k1 repos~2.2kAutomated safety check: PassGPL-3.0
Perform Tasktelegramdesktop/tdesktop33k2 repos~3kAutomated safety check: PassGPL-3.0

Similar skills

  • 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.

    104k GitHub starsUsed in 6 repos~2k tokens
    Agent WorkflowsAuto-check passed
  • HTML PPT Studio

    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.

    8.6k GitHub starsUsed in 4 repos~4.7k tokens
    Documents & OfficeAuto-check passed
  • Agent Browser

    quran/quran.com-frontend-next

    Automates browser interactions for web testing, form filling, screenshots, and data extraction.

    1.9k GitHub starsUsed in 40 repos~3.3k tokens
    Productivity & AutomationAuto-check passed
  • Dependency Watch

    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.

    33k GitHub starsUsed in 1 repo~2.2k tokens
    Productivity & AutomationAuto-check passed
  • Perform Task

    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.

    33k GitHub starsUsed in 2 repos~3k tokens
    Productivity & AutomationAuto-check passed
  • Brave Search

    badlogic/pi-skills

    Web search and content extraction via Brave Search API. An agent skill from badlogic/pi-skills.

    2.6k GitHub starsUsed in 5 repos~592 tokens
    Productivity & AutomationAuto-check passed

More from BuildGreatProducts/builder-os

All 8 skills in this repo
  • Design System

    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…

    228 GitHub stars~4.8k tokensUpdated 3 mo ago
    Auto-check passed
  • Idea Validator

    BuildGreatProducts/builder-os

    Pressure-tests a product idea before the founder invests in planning, building, or launching.

    228 GitHub stars~3.8k tokensUpdated 3 mo ago
    Auto-check passed
  • Product Planner

    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…

    228 GitHub stars~4.6k tokensUpdated 3 mo ago
    Auto-check passed
  • Build Loop Codex

    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.

    228 GitHub stars~888 tokensUpdated 3 mo ago
    Auto-check passed
  • Build Loop Cursor

    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.

    228 GitHub stars~827 tokensUpdated 3 mo ago
    Auto-check passed
  • Build Mvp

    BuildGreatProducts/builder-os

    Use inside a product repository when the user wants the full MVP built from their BuilderOS spec documents.

    228 GitHub stars~1.2k tokensUpdated 3 mo ago
    Auto-check: notes

Questions about Idea Generator

What does Idea Generator do?

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.

When should I use Idea Generator?

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.

How do I install Idea Generator in Claude Code?

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.

How do I install Idea Generator in Codex?

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.

Can I use Idea Generator in Cursor, Gemini CLI or GitHub Copilot?

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.

What does Idea Generator need to run?

SKILL.md names no scripts, command-line tools or credentials: Idea Generator is instructions for the agent only.

Does Idea Generator access the network?

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.

Is Idea Generator safe to install?

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.

What licence does Idea Generator use?

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.

How many tokens does Idea Generator use?

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.

What are the alternatives to Idea Generator?

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.

Who maintains Idea Generator?

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.