bmad-product-brief

bmad-product-brief is a skill for Claude Code from skyf0xx/hedgehog. It costs 31 tokens per session (2,567 once invoked), scanned A, original, MIT.

A guided process for creating, updating, or checking a product brief, a concise description of what a product is, who it serves, and why it should exist. It helps the user examine assumptions and record what is known and unknown.

In plain words
What is it for?
Use it to start a product brief, refine an existing one, or validate whether it is ready for the next stage of product work. It supports conversational exploration at a level of detail suited to the user's goal.
Why use it?
It turns an idea into a clearer document without hiding unanswered questions or making up advantages. Coaching and challenge help expose weak or incomplete parts of the brief.

Skill for Claude Code

Written for Claude Code: shipped in a Claude Code plugin. Also seen: mentions subagents.

Part of the hedgehog plugin — 20 skills, 5 agents, 1 hook shipped together

Good fit Use it to start a product brief, refine an existing one, or validate whether it is ready for the next stage of product work. It supports conversational exploration at a level of detail suited to the user's goal.

Compare 6 skills from other repositories ↓
Install with agentmods
npx agentmods add skills/skyf0xx/hedgehog/bmad-product-brief
Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

Any agent
npx skills add skyf0xx/hedgehog --skill bmad-product-brief
Clone the repo
git clone --depth 1 https://github.com/skyf0xx/hedgehog

Made for: Claude Code.

Or install hedgehog, the plugin that ships this one along with the rest of its 20 skills, 5 agents, 1 hook.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for bmad-product-brief

README.md
[![agentmods](https://agentmods.dev/badge/skills/skyf0xx/hedgehog/bmad-product-brief/github.svg)](https://agentmods.dev/skills/skyf0xx/hedgehog/bmad-product-brief)
Your own site
<a href="https://agentmods.dev/skills/skyf0xx/hedgehog/bmad-product-brief"><img src="https://agentmods.dev/badge/skills/skyf0xx/hedgehog/bmad-product-brief/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for bmad-product-brief

Your own site · 80×15
<a href="https://agentmods.dev/skills/skyf0xx/hedgehog/bmad-product-brief"><img src="https://agentmods.dev/badge/skills/skyf0xx/hedgehog/bmad-product-brief.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 31 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 2,567 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe. Third-party audits
  • NVIDIA SkillSpector pass 7 Sept 2026
How audits are shown
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00031 $0.02567
Opus 5 $0.00015 $0.01283
Sonnet 5 $0.00006 $0.00513
Haiku 4.5 $0.00003 $0.00257

Measured 12d ago against content hash 134b6dcb9cda, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-12, from the pricing page.

Security

Grade A, and why

bmad-product-brief scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 12d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

vendor-skills/BMAD/bmm-skills/plan/bmad-product-brief/SKILL.md · 96 lines

How it starts

The opening of the file, as written. The whole thing — 96 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Overview

You are an expert product analyst coach and facilitator. The user has an idea, an existing brief to refine, or a brief to pressure-test. You will conversationally help them craft or refine a brief appropriate to their purpose.

You are not in a hurry. You will not do the thinking for them. Coach, do not quiz. Make them sweat: push hardest when assumptions are unexamined, ease as the brief firms up or they signal fatigue. Get out what is stuck in their head and what they may have forgotten. Push back when an answer is thin.

Briefs produced here are honest, right-sized to purpose, and built for what comes next — they do not pad, they do not fabricate moats, they surface what is unknown alongside what is known - the user must feel that it is their own creation.

At the opening greeting, let the user know they can invoke bmad-advanced-elicitation for deeper exploration at any point.

Conventions

  • {bmad-root} is the vendored vendor-skills/BMAD/ root.

On Activation

  1. Resolve customization: uv run {bmad-root}/scripts/resolve_customization.py --skill {skill-root} --key workflow. On failure, read {skill-root}/customize.toml directly and use defaults.
  2. Execute each entry in {workflow.activation_steps_prepend} in order.
  3. Treat every entry in {workflow.persistent_facts} as foundational context for the rest of the run. Entries prefixed file: are paths or globs under {project-root} — load the referenced contents as facts. All other entries are facts verbatim.
  4. {workflow.external_sources} is an org-configured registry of internal tools (knowledge bases, MCP tools); consult them alongside generic web research on the same triggers in ## Discovery, org tools preferred when their directive matches. If a named tool is unavailable at runtime, fall back to standard behavior and note the gap when relevant.
  5. Resolve {user_name} (ask the user or omit), {communication_language} (English), {document_output_language} (English), {planning_artifacts}, {project_name} (infer from the Hedgehog project), {date} (today's date) using sensible defaults.
  6. Greet {user_name} in {communication_language} — and stay in {communication_language} for every turn for the entire run, not just the greeting. Detect intent (create / update / validate). If interactive and intent is unclear, ask; for headless behavior see ## Headless Mode.

Read the full file on GitHub · 96 lines

Files

What ships with it

2 files beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 12d ago First seen · 96 lines · 31 tokens per session scan A 134b6dcb9cda

Subscribe to this mod's changes

bmad-product-brief is a skill published in the GitHub repository skyf0xx/hedgehog (38 stars, last pushed yesterday), licensed MIT. It adds 31 tokens to every session and 2,567 once invoked, about $0.0002 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

Related

Other skills, from other repositories

writing-skills

Use when creating a new skill for the Shipworthy plugin, or when a recurring failure mode needs to be codified into a reusable guide. Covers TDD-for-documentation, CSO (Claude Search Optimization), adversarial testing, and the full skill lifecycle.

Vimalk0703/shipworthy · 56 tokens

production-readiness

Pre-launch checklist covering security, performance, reliability, legal, SEO, monitoring, backups, and custom domains. Each item has both a plain-language explanation and technical implementation detail. Ensures nothing critical is missed before going live.

Vimalk0703/shipworthy · 49 tokens

compliance-awareness

Practical engineering guidance for SOC 2, GDPR, HIPAA compliance and data classification. Covers access controls, audit logging, change management, right to deletion, data portability, consent, PHI encryption, and data classification levels. Engineering checks, not legal advice.

Vimalk0703/shipworthy · 57 tokens

threat-modeling

Apply the STRIDE framework to identify and mitigate security threats. Covers Spoofing, Tampering, Repudiation, Information Disclosure, Denial of Service, and Elevation of Privilege with practical questions, verification steps, and mitigations for each threat category.

Vimalk0703/shipworthy · 58 tokens

distributed-systems

Apply distributed systems patterns including idempotency, saga pattern, outbox pattern, eventual consistency, and CQRS to build reliable, consistent distributed services.

Vimalk0703/shipworthy · 34 tokens

twelve-factor-app

Evaluate and apply the Twelve-Factor App methodology with modern 2025 interpretations. Covers all 12 factors with actionable checks for cloud-native applications running on containers, Kubernetes, and serverless platforms.

Vimalk0703/shipworthy · 44 tokens