YC Office Hours
garrytan/gstack
Runs a YC-style office hours session that pressure-tests a product idea before any code and ends in a design document instead of an implementation.
Lean facilitator for creating, updating, and validating a product brief — the Analysis-phase foundation of the BMAD Method.
Install Bmad Product Brief
$ npx skills add aj-geddes/claude-code-bmad-skills --skill bmad-product-brief -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install aj-geddes/claude-code-bmad-skills bmad-product-brief --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/aj-geddes/claude-code-bmad-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/bmad-planning-orchestrator/skills/bmad-product-brief .claude/skills/bmad-product-brief && 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 "bmad-product-brief" agent skill from https://github.com/aj-geddes/claude-code-bmad-skills/tree/main/bmad-planning-orchestrator/skills/bmad-product-brief into .claude/skills/bmad-product-brief/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "bmad-product-brief", 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/aj-geddes/claude-code-bmad-skills/tree/main/bmad-planning-orchestrator/skills/bmad-product-briefType 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 aj-geddes/claude-code-bmad-skills --skill bmad-product-brief -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install aj-geddes/claude-code-bmad-skills bmad-product-brief --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/aj-geddes/claude-code-bmad-skills.git skills-src && mkdir -p .agents/skills && cp -r skills-src/bmad-planning-orchestrator/skills/bmad-product-brief .agents/skills/bmad-product-brief && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "bmad-product-brief" agent skill from https://github.com/aj-geddes/claude-code-bmad-skills/tree/main/bmad-planning-orchestrator/skills/bmad-product-brief into .agents/skills/bmad-product-brief/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "bmad-product-brief", 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 aj-geddes/claude-code-bmad-skills --skill bmad-product-brief -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install aj-geddes/claude-code-bmad-skills bmad-product-brief --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/aj-geddes/claude-code-bmad-skills.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/bmad-planning-orchestrator/skills/bmad-product-brief .cursor/skills/bmad-product-brief && 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 "bmad-product-brief" agent skill from https://github.com/aj-geddes/claude-code-bmad-skills/tree/main/bmad-planning-orchestrator/skills/bmad-product-brief into .cursor/skills/bmad-product-brief/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "bmad-product-brief", 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/aj-geddes/claude-code-bmad-skills.git --path bmad-planning-orchestrator/skills/bmad-product-brief--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 aj-geddes/claude-code-bmad-skills --skill bmad-product-brief -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install aj-geddes/claude-code-bmad-skills bmad-product-brief --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/aj-geddes/claude-code-bmad-skills.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/bmad-planning-orchestrator/skills/bmad-product-brief .gemini/skills/bmad-product-brief && 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 "bmad-product-brief" agent skill from https://github.com/aj-geddes/claude-code-bmad-skills/tree/main/bmad-planning-orchestrator/skills/bmad-product-brief into .gemini/skills/bmad-product-brief/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "bmad-product-brief", 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 aj-geddes/claude-code-bmad-skills bmad-product-briefInstalls 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 aj-geddes/claude-code-bmad-skills --skill bmad-product-brief -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/aj-geddes/claude-code-bmad-skills.git skills-src && mkdir -p .github/skills && cp -r skills-src/bmad-planning-orchestrator/skills/bmad-product-brief .github/skills/bmad-product-brief && 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 "bmad-product-brief" agent skill from https://github.com/aj-geddes/claude-code-bmad-skills/tree/main/bmad-planning-orchestrator/skills/bmad-product-brief into .github/skills/bmad-product-brief/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "bmad-product-brief", 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 aj-geddes/claude-code-bmad-skills --skill bmad-product-brief -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install aj-geddes/claude-code-bmad-skills bmad-product-brief --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/aj-geddes/claude-code-bmad-skills.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/bmad-planning-orchestrator/skills/bmad-product-brief .opencode/skills/bmad-product-brief && 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 "bmad-product-brief" agent skill from https://github.com/aj-geddes/claude-code-bmad-skills/tree/main/bmad-planning-orchestrator/skills/bmad-product-brief into .opencode/skills/bmad-product-brief/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "bmad-product-brief", 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.
Facts
- Skill name
bmad-product-brief- GitHub stars
- 488
- Token cost
- ~1.7k tokens
- SKILL.md length
- 690 words
- Files
- 4 (incl. scripts)
- Skills in repo
- 20
- Repo updated
- First seen
- Licence
- Custom licence
At a glance
Lean facilitator for creating, updating, and validating a product brief — the Analysis-phase foundation of the BMAD Method.
- Works in 8 steps: Problem Statement — What pain or… → Target Users — Primary and secondary… → Proposed Solution — Core value… → …
- The user says: create a product brief
- SKILL.md covers Intent Detection, Create Intent — Guided Discovery, Update Intent and Validate Intent, plus 4 more sections
- Runs Shell scripts from its folder; calls bash
What it does
Bmad Product Brief is an agent skill from aj-geddes/claude-code-bmad-skills. Lean facilitator for creating, updating, and validating a product brief — the Analysis-phase foundation of the BMAD Method. Captures problem statement, target users, core features, goals, constraints, and success metrics. Use when the user says: "create a product brief", "I need a product brief", "let's do discovery", "help me define my product", "what problem are we solving", "capture our product vision", "update the product brief", "validate the brief", "check if the brief is complete", "run discovery", "start…
Its SKILL.md is about 1.7k tokens, which your agent loads only when the skill is triggered. The skill folder holds 5 other files, including scripts (for example `scripts/discovery-checklist.sh`, `scripts/validate-brief.sh` and `templates/product-brief.template.md`).
It sits in Product & Project Management, covering Product metrics, Brainstorming and Product strategy. The repository describes itself as: BMAD Method skills for Claude Code - Auto-detection, Memory integration, Slash commands. Transform Claude Code into a BMAD-powered development environment.
When your agent uses it
- The user says: create a product brief
- I need a product brief
- Lets do discovery
- Help me define my product
Example prompts
- “create a product brief”
- “I need a product brief”
- “s do discovery”
- “/bmad-product-brief”
Requirements
- A Bash shell
- Pre-approved tools (allowed-tools): Read, Write, Edit, Bash, Glob, Grep, TodoWrite
Workflow steps
8 steps, taken from the first numbered list in SKILL.md.
- Problem Statement — What pain or opportunity exists? Who feels it? How often? What is the cost of inaction?
- Target Users — Primary and secondary personas. Roles, goals, pain points, technical proficiency.
- Proposed Solution — Core value proposition, key capabilities (MVP scope vs. future). What makes it different?
- Goals & Constraints — Business goals, non-negotiable constraints (regulatory, platform, budget, timeline).
- Success Metrics — SMART metrics with baselines and targets. What does success look like at 3 / 6 / 12 months?
- Market & Competition — Key competitors, gaps, differentiation angle. (Optional: use WebSearch if the user wants research.)
- Risks & Assumptions — Top 3–5 risks with probability, impact, and mitigation. Critical assumptions to validate.
- Dependencies & Next Steps — Internal/external dependencies, blockers, recommended handoff.
What it can do on your machine
Read from SKILL.md and the folder at commit 27dca0e. It shows what the files ask for, not the result of running them.
Tool permissions
Pre-approves these tools, so the agent can use them without asking each time:
ReadWriteEditBashGlobGrepTodoWrite
From allowed-tools in the SKILL.md frontmatter.
Runs code
Ships 2 files in scripts/ (Shell), which the agent can run.
Shell commands in SKILL.md call:
bash
From the folder's file list and the shell code blocks in SKILL.md.
Network
Links to these hosts (documentation or services it may open):
github.com
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
Bmad Product Brief loads about 1.7k tokens when it runs. Until then it costs about 224 tokens; SKILL.md has 690 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.
Safety
Auto-check: notes
The automated check noted patterns worth knowing about, such as sudo or a known installer.
- NotePre-approves every shell command (allowed-tools: Bash)SKILL.md
allowed-tools: Read, Write, Edit, Bash, Glob, Grep, TodoWrite
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); the scripts in this folder are not scanned.
SKILL.md
Its licence (Custom licence) doesn't allow us to republish the file, so here is its outline and opening line. It has 690 words (~1,717 tokens).
“Phase: Analysis (Phase 1) Upstream counterpart: bmad-business-analyst Output artifact: bmad-output/product-brief.md”
- name
- bmad-product-brief
- allowed-tools
- Read, Write, Edit, Bash, Glob, Grep, TodoWrite
Files
SKILL.md and 3 other files (scripts) in bmad-planning-orchestrator/skills/bmad-product-brief of aj-geddes/claude-code-bmad-skills.
- SKILL.md
- scripts/discovery-checklist.sh
- scripts/validate-brief.sh
- templates/product-brief.template.md
Open the folder on GitHubat commit 27dca0e
Compare with similar skills
Bmad Product Brief 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 |
|---|---|---|---|---|---|---|
| Bmad Product Brief this skillaj-geddes/claude-code-bmad-skills | 488 | — | ~1.7k | Automated safety check: Notes | Custom licence | |
| YC Office Hoursgarrytan/gstack | 136k | — | ~4.2k | Automated safety check: Pass | MIT | |
| Idea Refinementaddyosmani/agent-skills | 105k | 6 repos | ~2k | Automated safety check: Pass | MIT | |
| Team OKR Brainstormphuryn/pm-skills | 27k | — | ~1.1k | Automated safety check: Pass | MIT | |
| AI Product Strategy InterviewerPrepLabsAI/InterviewMentor | 112 | — | ~4.5k | Automated safety check: Pass | MIT | |
| SaaS Revenue and Growth Metricsdeanpeters/Product-Manager-Skills | 7.2k | 1 repos | ~5.8k | Automated safety check: Pass | Custom licence |
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.
Team OKR Brainstorm
phuryn/pm-skills
Drafts three alternative sets of team OKRs, each with an inspiring objective and measurable key results, tied to the company strategy you provide.
AI Product Strategy Interviewer
PrepLabsAI/InterviewMentor
A VP of Product interviewer that simulates a product strategy interview focused on AI-native products.
SaaS Revenue and Growth Metrics
deanpeters/Product-Manager-Skills
Explains and calculates SaaS revenue, retention and growth metrics such as MRR, ARPU, GRR and NRR, to read momentum, churn and product-market-fit signals.
Yao Demand Skill
yaojingang/yao-open-skills
Evaluate product demand from product links, product descriptions, PRDs, websites, app-store pages, white papers, sales decks, screenshots, or funding materials using the demand triangle model: lack…
More from aj-geddes/claude-code-bmad-skills
All 20 skills in this repoBmad Architecture
aj-geddes/claude-code-bmad-skills
Solutioning skill (Winston, the Architect). An agent skill from aj-geddes/claude-code-bmad-skills.
Bmad Brainstorm
aj-geddes/claude-code-bmad-skills
Facilitates structured ideation sessions using proven brainstorming techniques (SCAMPER, SWOT, 5 Whys, Mind Mapping, Six Thinking Hats, Reverse Brainstorming, Starbursting, Brainwriting).
Bmad Builder
aj-geddes/claude-code-bmad-skills
Meta-skill for scaffolding and validating custom PLANNING/ORCHESTRATION skills within the BMAD Planning & Orchestrator plugin.
Bmad Epics And Stories
aj-geddes/claude-code-bmad-skills
Solutioning flagship — shards a PRD + architecture into epics.md and individual {epic}.{story}.{slug}.story.md context objects, the LAST planning artifact before external dev handoff.
Bmad Help
aj-geddes/claude-code-bmad-skills
Orchestration spine and "what do I do next?" router for the BMAD Planning & Orchestrator plugin.
Bmad Init
aj-geddes/claude-code-bmad-skills
Initialize a BMAD planning workspace: pick a scale-adaptive TRACK (Quick Flow / BMad Method / Enterprise) interactively, then scaffold the output folder, a config file, an empty decision-log.md, and…
Related
Questions about Bmad Product Brief
What does Bmad Product Brief do?
Lean facilitator for creating, updating, and validating a product brief — the Analysis-phase foundation of the BMAD Method. Bmad Product Brief is an agent skill from aj-geddes/claude-code-bmad-skills. Lean facilitator for creating, updating, and validating a product brief — the Analysis-phase foundation of the BMAD Method.
When should I use Bmad Product Brief?
Bmad Product Brief fits situations like: the user says: create a product brief; I need a product brief; lets do discovery; help me define my product.
How do I install Bmad Product Brief in Claude Code?
Run `npx skills add aj-geddes/claude-code-bmad-skills --skill bmad-product-brief -a claude-code`. Or copy the skill folder (bmad-planning-orchestrator/skills/bmad-product-brief in aj-geddes/claude-code-bmad-skills) into .claude/skills/bmad-product-brief in your project. Claude Code loads it when a task matches its description.
How do I install Bmad Product Brief in Codex?
Run `npx skills add aj-geddes/claude-code-bmad-skills --skill bmad-product-brief -a codex`. Or copy the skill folder (bmad-planning-orchestrator/skills/bmad-product-brief in aj-geddes/claude-code-bmad-skills) into .agents/skills/bmad-product-brief in your project. Codex loads it when a task matches its description.
Can I use Bmad Product Brief 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 aj-geddes/claude-code-bmad-skills --skill bmad-product-brief -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/bmad-product-brief, .gemini/skills/bmad-product-brief, .github/skills/bmad-product-brief and .opencode/skills/bmad-product-brief in your project.
What does Bmad Product Brief need to run?
Going by SKILL.md and its folder, Bmad Product Brief needs a shell for the scripts in its folder and the command-line tools its instructions call (bash). Our summary lists: A Bash shell. Its frontmatter pre-approves these tools: Read, Write, Edit, Bash, Glob, Grep, TodoWrite.
Does Bmad Product Brief access the network?
SKILL.md names 1 domain. As links in the text: github.com. This is read from the text; nothing was executed.
Is Bmad Product Brief safe to install?
Our automated static check of SKILL.md found notes only (pre-approves every shell command (allowed-tools: bash)), nothing it rates as a warning. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.
What licence does Bmad Product Brief use?
Bmad Product Brief has a licence file (the repository's licence) that doesn't match a standard licence. Read it on GitHub before reusing the skill.
How many tokens does Bmad Product Brief use?
About 1.7k tokens (SKILL.md is roughly 6.9k 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 Bmad Product Brief?
Skills that share tags, products or a category with Bmad Product Brief: YC Office Hours (garrytan/gstack, 136k stars), Idea Refinement (addyosmani/agent-skills, 105k stars), Team OKR Brainstorm (phuryn/pm-skills, 27k stars) and AI Product Strategy Interviewer (PrepLabsAI/InterviewMentor, 112 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
Who maintains Bmad Product Brief?
aj-geddes (a GitHub user) maintains it in aj-geddes/claude-code-bmad-skills, which has 488 GitHub stars. The repository holds 20 skills in this directory. The repository was last updated on June 20, 2026.
Source: aj-geddes/claude-code-bmad-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.