BMad Analyst Skill for Claude: Mary, Your Business Analyst

Makes Claude act as Mary, a BMad business analyst with a menu for brainstorming, research, product briefs and PRFAQs.

Installs: 13.2K; on skills.sh
Stars: 54.9K; on GitHub
Files: 2; besides SKILL.md
Updated: Nov 2026; last repo commit

bmad-agent-analyst turns Claude into Mary, the Business Analyst from the BMad Method. SKILL.md says she brings market research, competitive analysis, requirements elicitation and domain knowledge, and stays grounded in evidence. Claude greets you as Mary, marks messages with a chart icon and stays in character until you dismiss her.

Ask to talk to Mary or to the business analyst and it triggers. On start it runs two uv scripts from your project's _bmad folder, then shows a menu of ten items. Most call other BMad skills such as bmad-brainstorming, bmad-deep-recon and bmad-product-brief. This skill is only the persona and menu, so you need the rest of the BMad set installed.

Good for

Founders and product people exploring an idea before committing to build it
Teams that need market, domain or competitor research with evidence behind it
Anyone drafting a product brief or stress-testing a concept with a PRFAQ

Install bmad-agent-analyst

Claude Code

Copy this prompt.

Install the bmad-agent-analyst skill in Claude Code. Run this command:

/plugin marketplace add bmad-code-org/bmad-plugins
/plugin install bmad-method@bmad
/plugin install bmad-toolbox@bmad

Then check that it loaded and tell me how to use it.

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

Requires uv.

Install the whole BMad set, not just this skill: it calls scripts and sibling skills that the set provides. After installing, open your coding tool in the project and ask the bmad skill to run bmad setup. Every route needs uv (the README says both routes need it for setup and Python scripts). This is the v7 preview alpha, so expect breaking changes between updates. Plugin names differ between sources: the BMAD-METHOD README says to install bmad-method and bmad-core-tools, but the bmad-plugins README and its marketplace manifest list bmad-method and bmad-toolbox, and the bmad skill sits in the toolbox plugin's skills folder. Use the names that /plugin shows after you add the marketplace. Pick one route, not both.

From the project README. Source.

What's in the skill

When it loads

Business analyst for market research, competitive analysis, and requirements. Use when the user asks to talk to Mary or requests the business analyst

Sections in SKILL.md

Overview
Conventions
On Activation
Step 1: Resolve the Agent Block
Step 2: Execute Prepend Steps
Step 3: Adopt Persona
Step 4: Load Persistent Facts
Step 5: Load Config
Step 6: Greet the User
Step 7: Execute Append Steps
Step 8: Dispatch or Present the Menu

Key facts

Author: bmad-code-org (BMad Code); the plugin marketplace lists Brian (BMad) Madison as owner
License: GitHub detects none for the repo (NOASSERTION); the README and plugin marketplace say MIT
Installs on skills.sh: 13,227 as of 2026-11-02
GitHub stars: 54,859 for the whole BMAD-METHOD repo
Last commit to the repo: 2026-11-01
Files in the skill: 3 files including SKILL.md: bmod.toml, customize.toml
Needs: uv (README), plus the bmad setup skill so the _bmad/scripts folder exists
skills.sh audits: Gen Agent Trust Hub pass, Socket pass, Snyk pass

What it includes

Loads the persona, your facts and config, then greets you as Mary.
Claude resolves the agent settings with a uv script, runs any extra steps you configured, adopts the persona, loads persistent facts and the output folder, greets you and runs the append steps.
Runs code · Activation (8 steps)
Guided brainstorming through bmad-brainstorming.
Expert brainstorming facilitation.
Try: “Hey Mary, let's brainstorm.”
Read · Menu: BP
Market, domain and technical research via bmad-deep-recon.
Each opens bmad-deep-recon with a research type already chosen: market (competitive landscape, customer needs, trends), domain (industry deep dive and terminology) or technical (landscape and implementation reality).
Read · Menu: MR, DR, TR
Compares technologies, vendors or tools with a decision matrix.
Opens bmad-deep-recon in its select shape to choose between candidates and give a recommendation.
Read · Menu: TS
Competitor teardown and user-voice research.
CR covers named competitors' offers, pricing, positioning and trajectory. UV covers reviews, communities and jobs-to-be-done. Both run through bmad-deep-recon.
Read · Menu: CR, UV
Creates or updates a product brief through bmad-product-brief.
Guided or autonomous discovery that produces the brief.
Write · Menu: CB
Working Backwards PRFAQ challenge through bmad-prfaq.
Forges and stress-tests a product concept.
Write · Menu: WB
Sets up or refreshes the repo's agent instructions via bmad-project-context.
Records verified commands, policy, conventions and pitfalls for this repo. Its modes are setup, refresh, record and audit.
Write · Menu: PC

From the official docs

Permissions

Medium risk

This skill makes Claude run uv scripts from your project and follow the steps in your BMad customization files. Its research menu items call other skills, so read their notes too.

What it can do

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

Watch out for

It runs uv scripts from your project
SKILL.md tells Claude to run resolve_customization.py and resolve_config.py with uv from a _bmad/scripts folder in your project. Those scripts come from the bmad skill, not from this folder, so read them there if you want to know what they do. github.com
Project override files steer Claude
Claude reads customize.toml plus optional team and personal override files under _bmad/custom, and runs their activation steps and persistent facts. Anyone who can edit those files in your repo can change what the agent does, so review them in pull requests. github.com
The persona stays on until you dismiss it
SKILL.md says not to break character until you dismiss the persona, and the persona carries into any skill it calls. Say so plainly when you want Claude back to normal. github.com

Technical details

Sign-in and keys	SKILL.md names no sign-in or API key.
Scopes	Runs uv scripts from _bmad/scripts in your project

Questions

What does the bmad-agent-analyst skill do?

It makes Claude play Mary, the BMad Method's Business Analyst. She asks for evidence, structures findings, and offers a menu for brainstorming, several kinds of research, product briefs, PRFAQs and project context.

How do I install bmad-agent-analyst?

Use the install box above and install the whole BMad set. This skill runs scripts and calls skills that the set provides, so installing it alone does not work. Then ask the bmad skill to run bmad setup.

Does it need an API key?

SKILL.md names no API key. It does need uv, which the README lists as required for BMad setup and its Python scripts.

Is bmad-agent-analyst safe to run?

It runs uv scripts from your project's _bmad folder and follows any steps in your customization files, so review those before you trust a repo you did not write. Mary stays in character until you dismiss the persona. The Permissions section lists the details.

Does it work in Claude.ai, Codex or Cursor?

The README documents a Claude Code plugin, a Codex plugin and a skills CLI install that asks which coding tool to target. It says you need a coding tool that supports skills. It does not name Cursor or the Claude app, and the skill needs a local project folder and uv.

bmad-agent-analyst vs bmad-agent-pm?

Mary works at the analysis stage: brainstorming, research and briefs before a project is committed. John, the product manager, works on the PRD. Each is a persona with its own menu, and the menus call different skills.

Information

updated Nov 2, 2026

Repository: bmad-code-org/bmad-method
Folder: skills/bmad-agent-analyst

bmad-code-org/bmad-method skills.sh

Sources

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

Show all 6

BMAD-METHOD README · github.com
bmad-plugins README · github.com
bmad-agent-analyst SKILL.md · github.com
bmad-agent-analyst customize.toml · github.com
bmad-agent-pm customize.toml · github.com
bmad skill memlog.py · github.com