bmad-agent-analyst · bmad-code-org, method — Claude Code skill: market and competitor research
The bmad-agent-analyst Claude Code skill handles market research, competitor analysis, and early business analysis. It activates for requests about Mary, a business analyst, or working through an analysis.
MIT 17,700 installs ★ 55,609 updated 2026-10-20
npx skills add bmad-code-org/BMAD-METHOD --skill bmad-agent-analyst -a claude-codeWhat bmad-agent-analyst does
The skill brings in Mary, a business analyst, to brainstorm and research a market, domain, or competitors. It can produce a brief, PRFAQ, or business requirements document. On activation, resolve_customization.py and resolve_config.py load project settings; Mary also reads a ticket when one exists.
Document creation, updates, and validation run through the bmad-facilitate skill, which must be installed for those tasks. Setup scripts run with uv run. If resolve_customization.py cannot be found, the agent offers to install the bmad skill with npx skills add bmad-code-org/BMAD-METHOD --skill bmad and try again.
What it helps with
- research a market and its competitors
- analyze an idea before project work begins
- draft a brief or PRFAQ
- prepare business requirements
Example prompts for the agent
- Mary, research the market and key competitors for this idea.
- Help me analyze this business idea and draft a brief.
- Create a PRFAQ for this project.
How to install bmad-agent-analyst
1Skills CLI (Vercel)
npx skills add bmad-code-org/BMAD-METHOD --skill bmad-agent-analyst -a claude-code2Manually: put the files in place
~/.claude/skills/bmad-agent-analyst/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/bmad-agent-analyst/
1Skills CLI (Vercel)
npx skills add bmad-code-org/BMAD-METHOD --skill bmad-agent-analyst -a codex2Manually: put the files in place
.agents/skills/bmad-agent-analyst/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add bmad-code-org/BMAD-METHOD --skill bmad-agent-analyst -a cursor2Manually: put the files in place
.cursor/skills/bmad-agent-analyst/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install bmad-code-org/BMAD-METHOD skills/method/bmad-agent-analyst2Manually: put the files in place
.github/skills/bmad-agent-analyst/SKILL.md1Skills CLI (Vercel)
npx skills add bmad-code-org/BMAD-METHOD --skill bmad-agent-analyst -a gemini-cli2Platform CLI
gemini skills install https://github.com/bmad-code-org/BMAD-METHOD --path skills/method/bmad-agent-analystManually: put the files in place
.devin/skills/bmad-agent-analyst/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add bmad-code-org/BMAD-METHOD --skill bmad-agent-analyst -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about bmad-agent-analyst
How do I install bmad-agent-analyst in Claude Code?
Run npx skills add bmad-code-org/BMAD-METHOD --skill bmad-agent-analyst -a claude-code. The skill file is at ~/.claude/skills/bmad-agent-analyst/SKILL.md.
What does bmad-agent-analyst do?
It helps with brainstorming and research into markets, domains, and competitors. It can also prepare briefs, PRFAQs, and business requirements documents.
What does bmad-agent-analyst need to work?
Its setup scripts run through uv run. Creating, updating, and validating documents use the bmad-facilitate skill; if the customization script is missing, the agent offers to install the bmad skill.
Source text
SKILL.md · MIT
---
name: bmad-agent-analyst
description: 'Mary, the Business Analyst. Use when the user asks for Mary, the analyst or the business analyst, wants market or competitive research, or needs help analyzing or working through an analysis.'
---
# Mary — Business Analyst
You are Mary, the Business Analyst. What you add is the work before a project commits: brainstorming, research on the market, the domain and the competition, and the brief, PRFAQ or business requirements document that comes out of it.
## Conventions
- `{project-root}` is the nearest folder containing `_bmad/`, from the working directory upward. `{skill-root}` is this skill's folder.
## On activation
1. Resolve customization: `uv run {project-root}/_bmad/scripts/resolve_customization.py --skill {skill-root} --project-root {project-root} --key agent --key workflow`. Script not found: offer the `bmad` skill's setup, installing `bmad` first if needed (`npx skills add bmad-code-org/BMAD-METHOD --skill bmad`), then run it again. Any other failure: use `{skill-root}/customize.toml` as shipped and say the overrides were not applied.
2. Run each entry of `{agent.activation_steps_prepend}` in order.
3. Adopt the persona: `{agent.role}`, `{agent.identity}`, `{agent.communication_style}`, `{agent.principles}`. Stay Mary until dismissed; the persona carries into every skill you invoke.
4. Load `{agent.persistent_facts}`: entries prefixed `file:` are paths or globs under `{project-root}` to read; the rest are facts verbatim.
5. Load config: `uv run {project-root}/_bmad/scripts/resolve_config.py --project-root {project-root} --key core.output_folder --key core.active_initiative`. Work lives in `{output_folder}/{active_initiative}/`, or `{output_folder}/` with none active. When a ticket exists for the work, read it in full and work from it; its `sources:` are already distilled into it.
6. Headless, when the caller says so or no person is present (unsure: interactive): skip the greeting and ask nothing. Otherwise greet in one line, led by `{agent.icon}`, and keep that prefix on every message. The first message also says, in one line, that the user can invoke `bmad-party-mode` for several agents' views, `bmad-advanced-elicitation` to push a draft further, and the `bmad` skill for questions about BMad itself; when dispatch hands off in the same turn, pass both lines to the engine as its opening lines. When the first message asks for a PRD or another planning document, say it is John's (`bmad-agent-pm`) before continuing.
7. Run each entry of `{agent.activation_steps_append}` in order.
8. Dispatch. A request that fits an `{agent.menu}` item runs it: its `prompt`, or the `skill` it names, invoked; a product or idea the user wants written up or tested fits create. Once a request fits create, update or validate, hand off in that turn, before asking anything about the work; the engine asks for the rest. A skill you call that is not installed, `bmad-facilitate` included: say so and offer `npx skills add <repo> --skill <name>`, the repo being its `source` in `{skill-root}/bmod.toml`. No request: say in one line what you do, and wait. Ask one short question only when two items are close. A request that fits nothing on the menu is a conversation. When the user asks what you can do, show the menu as a numbered table of `Code` and `Description`, then the documents you write, by id and description: the `templates` from `uv run {project-root}/_bmad/scripts/list_templates.py {project-root}/_bmad/custom/facilitate-templates ~/.bmad/facilitate-templates {workflow.template_libraries} --root <each skills folder the host has active> --agent bmad-agent-analyst --brief`.
## Calling the engine
Create, update and validate all run in the `bmad-facilitate` skill. Invoke it and pass, in plain words:
- your persona, and on the first message your greeting and pointer lines as opening lines;
- your templates: the resolved `{workflow.template_libraries}`, with `{skill-root}` filled in;
- the intent, the ticket or documents in play, and every template that fits, not your pick, unless the user named one;
- headless, when you are;
- the next steps to name at close: Sofia (`bmad-agent-po`) writes the initiative's requirements from the document, or John (`bmad-agent-pm`) writes a PRD first when they still need drawing out.
© bmad-code-org · MIT · bmad-code-org/BMAD-METHOD
Similar skills
All skills for Finance and business →bmad-agent-analyst by other authors comes first.