Ready to supercharge your AI agents?

Install any skill in seconds. Free to start, no credit card required.

BMAD Product Brief · aj-geddes | DecimalAI

productivityby aj-geddes

BMAD Product Brief

aj-geddes/bmad-product-brief

Source aj-geddes/claude-code-bmad-skills ↗License NOASSERTION

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.

SkillScore50Maintained

Automatic

Product Management pack

Last verified 8/19/2026

What it changes

Passed 10 of 20 test cases with the skill, and 5 of 20 without it.

Without skill23%

With skill50%

Checks it passed that the model alone missed

Delegates competitive research to a subagent.
Specifies storing output inside the bmad-output/ directory.
Formats the filename as product-brief-<slug>-<YYYY-MM-DD>.md.

and 5 more in the full report

6 fixed5 passed either way11 still failing0 broke

Pass-rate lift: +27 pp
Tokens: +31%
Agent turns: 0%
Response time: -53%

Model gemini-3.6-flashMeasured 8/19/2026v111 of 22 cases passed with skill · 20 comparable

Tokens, turns and time describe resource use, not a dollar price.

Use this skill

Save it into your project's skills folder. Claude Code picks it up in its next session.

curl -fsSL --create-dirs -o .claude/skills/aj-geddes-bmad-product-brief/SKILL.md https://app.decimal.ai/s/aj-geddes-bmad-product-brief/SKILL.md

Want it pinned and updatable? pip install "decimalai>=0.15", then decimalai skills add aj-geddes-bmad-product-brief, and start Claude Code with claude --plugin-dir "$(git rev-parse --show-toplevel)/.agents"

1 · One-time — install the CLI (docs ↗)

pip install "decimalai>=0.15"

2 · Get the skill — writes .agents/skills/aj-geddes-bmad-product-brief/ and pins it in .decimal/skills.lock

decimalai skills add aj-geddes-bmad-product-brief

No CLI? Get the same file — curl · raw file

curl -fsSL --create-dirs -o .claude/skills/aj-geddes-bmad-product-brief/SKILL.md https://app.decimal.ai/s/aj-geddes-bmad-product-brief/SKILL.md

Raw file: /s/aj-geddes-bmad-product-brief/SKILL.md ↗ · machine-readable summary at /s/aj-geddes-bmad-product-brief.json ↗

Safety checks: 3 of 3 passed

Code scan CleanIntent PassedContent Clean

See it in action

One of 6 test cases the skill fixed. Same model, same prompt, with and without the skill.

1 of 6

Prompt

What exact bash command should be run to check if bmad-output/product-brief-crm-2025-02-01.md is complete and free of errors?

What was checked, without and with the skill
Checked	Without skill	With skill
Runs bash ${CLAUDE_PLUGIN_ROOT}/skills/bmad-product-brief/scripts/validate-brief.sh bmad-output/product-brief-crm-2025-02-01.md.	Missed	Passed

case-16 · gemini-3.6-flash · 8/19/2026 · answers are capped and redacted

What's inside

The instructions your model reads when the skill loads.

SKILL.md129 lines4 filesincludes scripts

BMAD Product Brief

Phase: Analysis (Phase 1) Upstream counterpart: bmad-business-analyst Output artifact: bmad-output/product-brief.md

Intent Detection

On activation, determine which intent the user wants:

Intent	Trigger	Action
Create	No existing brief, or user says "new" / "start"	Run guided discovery, write fresh brief
Update	Existing brief found, user says "update" / "change" / "add"	Load brief, ask which section(s) to revise
Validate	User says "validate" / "check" / "review brief"	Run `scripts/validate-brief.sh` on the brief file

If unclear, ask: "Would you like to create a new product brief, update an existing one, or validate a draft?"

Create Intent — Guided Discovery

This is a conversation, not a form dump. Work through these sections one at a time, asking follow-up questions before moving on. Use TodoWrite to track progress.

Discovery Sections (in order)

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.

Facilitation Rules

Ask one focused question (with 1–3 probing sub-questions) before moving on.

Track record

Benchmark

10 / 20

test cases passed, vs 5 / 20 without

Adoption

Users: 0
Times used: 0

Safety and source details

SkillSafety

✓ 3 of 3 passed

Code scan15 of 15 checks clean

0 critical · 0 warning · 0 info — scanner v4 — 8/3/2026

View 15 scanner checks

live_secretremote_code_executionreverse_shelldata_exfiltrationssrf_metadataagent_snoopinganti_refusaldestructive_commandsobfuscated_unicodeunicode_homoglyphopaque_blobsuspicious_urltool_overreachtrigger_abuseprompt_injection_phrasing

IntentSafe

LLM judge · does the skill do what it claims

ContentClean

LLM judge · policy & harmful-content review

Source

Imported

aj-geddes / claude-code-bmad-skills

bmad-planning-orchestrator/skills/bmad-product-brief/SKILL.md

View on GitHub ↗

License NOASSERTIONImported 8/3/2026Version v1Bundled 3 files · scripts

Other skills for the same job

Published skills whose descriptions closely match this one, with their headline benchmark lift.

More skills from the same source and nearby in the registry, with their headline benchmark lift.

Ready to supercharge your AI agents?

See it in action

What's inside

BMAD Product Brief

Intent Detection

Create Intent — Guided Discovery

Discovery Sections (in order)

Facilitation Rules

Track record

Benchmark

Adoption

SkillSafety

Source

Other skills for the same job

Related skills