PlugWiki

bmad-prfaq Skill for Claude Code: Stress-Test a Product with a PRFAQ

BMad Method skill that coaches you through Amazon's Working Backwards method and ends in a finished PRFAQ document.

Installs
12.6K
on skills.sh
Stars
54.9K
on GitHub
Files
10
besides SKILL.md
Updated
Nov 2026
last repo commit

You describe a product idea and the assistant acts as a tough product coach. You write the press release for the finished product first, then answer hard customer and internal questions, and it ends with a verdict and a PRFAQ document. A headless mode writes a first draft from facts you supply.

It only works in a project where BMad is set up, because its SKILL.md runs scripts from the project's _bmad folder through uv. It starts a web researcher and a document scanner as subagents. The folder has 11 files including SKILL.md and no scripts.

Good for

  • Founders and product managers testing an idea before building
  • Teams that need a PRFAQ as input for a PRD
  • Open-source and internal-tool owners who want their concept challenged

Install bmad-prfaq

Claude Code

  1. 1

    Copy this prompt.

    Install the bmad-prfaq skill in Claude Code. Run this command:
    
    /plugin marketplace add bmad-code-org/bmad-plugins
    
    Then check that it loaded and tell me how to use it.
  2. 2

    Paste it into Claude Code. It shows the change and asks before running it.

bmad-prfaq needs BMad set up in your project: its SKILL.md runs a script from the project's _bmad folder and tells the agent to run the bmad skill's setup when that script is missing. Pick one route, not both. The marketplace manifest lists this skill's folder under the bmad-method plugin, so install bmad-method after you add the marketplace, plus the plugin that holds the bmad skill (the bmad-plugins README names bmad-method and bmad-toolbox). Then ask the bmad skill to run bmad setup. Skills CLI route: it asks which coding tools to install to, so choose Claude Code, then ask the bmad skill to run bmad setup. BMad needs uv for its setup and Python scripts. The README calls v7 a preview alpha with breaking changes between updates.

From the project README. Source.

What's in the skill

When it loads

Test a product concept with Amazon's Working Backwards method: write the press release for the finished product first, then answer hard customer and stakeholder questions, ending in a complete PRFAQ document. Use when the user requests to 'create a PRFAQ', 'work backwards', or 'run the PRFAQ challenge'

Sections in SKILL.md

  1. Overview
  2. Conventions
  3. On Activation
  4. Step 1: Resolve the Workflow Block
  5. Step 2: Execute Prepend Steps
  6. Step 3: Load Persistent Facts
  7. Step 4: Load Config
  8. Step 5: Greet the User
  9. Step 6: Execute Append Steps
  10. Pre-workflow Setup
  11. Stage 1: Ignition
  12. Stages

Key facts

Installs on skills.sh
12,619 as of 2026-11-02
Last repo commit
2026-11-01

What it includes

  • Gets the concept on the table and pushes you to name a customer and problem.

    Also sets up the output document and starts the subagents.

    Write · Stage 1: Ignition

  • Drafts the press release for the finished product with hard coaching.

    Write · Stage 2: The Press Release

  • Asks devil's advocate questions from the customer's side.

    Write · Stage 3: Customer FAQ

  • Asks skeptical stakeholder questions about feasibility and risk.

    Write · Stage 4: Internal FAQ

  • Rates how strong the concept is and writes the final output.

    Write · Stage 5: The Verdict

  • Writes a first-draft PRFAQ from customer, problem, stakes and solution you supply.

    Fails with guidance if those four inputs are missing or vague.

    Write · --headless / -H

  • Subagent that scans your project documents for relevant material.

    Read · Artifact analyzer

  • Subagent that runs 3 to 5 web searches on competitors and market context.

    Network · Web researcher

From the official docs

Permissions

Low risk

It writes a PRFAQ file into your project and sends a summary of your idea into web searches. Leave anything confidential out of the idea you describe.

What it can do

  • Read your data
  • Create and change things
  • Delete things
  • Read-only mode

Watch out for

  • Your concept goes into web searches

    The web researcher agent receives a summary of your product idea and runs 3 to 5 web searches. Leave out anything confidential from the idea you describe. github.com

  • It reads project documents

    The artifact analyzer scans your output and initiative folders and any paths you give it. It skips ticket files, which the main session reads itself. github.com

  • This is a preview release

    The BMAD-METHOD README calls v7 a preview alpha with breaking changes between updates. github.com

Technical details
Scopes
  • Runs uv run on _bmad/scripts in your project to resolve settings

  • Reads documents in your output and initiative folders for context

  • Writes prfaq-<slug>/prfaq-<slug>.md and a distillate

  • Web researcher subagent runs 3 to 5 web searches about your concept

Questions

What does bmad-prfaq do?

It coaches you through Amazon's Working Backwards method. You write the press release for the finished product, answer customer and internal FAQs, and get a verdict and a PRFAQ document.

How do I install it?

Use the install box at the top of this page. After installing, ask the bmad skill to run bmad setup, because this skill needs BMad set up in the project.

Does it work in the Claude app or claude.ai?

This page documents no install for the Claude app. The skill needs uv and a project folder with BMad set up, so the box lists Claude Code, Codex and the skills CLI.

Is it safe?

It writes a PRFAQ file into your project and its web researcher searches the web about your concept. Our advice: keep confidential details out of the idea you describe.

Can it run without asking me questions?

Yes. Headless mode writes a first draft from your customer, problem, stakes and solution. Without those four it returns an error that says what is missing.

bmad-prfaq vs bmad-forge-idea?

Forge-idea is for a half-formed idea; the PRFAQ skill points you there when you cannot name a customer or problem. PRFAQ is for a concept you can describe and want to stress-test.

Information

updated Nov 2, 2026

Folder
skills/bmad-prfaq

bmad-code-org/bmad-methodskills.sh

Sources

Docs, issue trackers and discussions this page is built from.

Show all 6
  1. README.md · github.com
  2. README.md · github.com
  3. marketplace.json · github.com
  4. SKILL.md · github.com
  5. web-researcher.md · github.com
  6. artifact-analyzer.md · github.com

Updated Nov 2, 2026.