Skip to main content
skill CX Codex

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

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add bmad-code-org/BMAD-METHOD --skill bmad-agent-analyst -a claude-code
Open on GitHub

What 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-code

2Manually: put the files in place

~/.claude/skills/bmad-agent-analyst/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/bmad-agent-analyst/

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.

bmad-agent-analyst bmad-code-org bmad-agent-analyst is a Claude Code skill that takes on Mary’s business analyst role for market research, competitor analysis, and requirements. It activates when asked to speak with Mary or call the business analyst. CX Codex +1 17,700installs bmad-research aj-geddes bmad-research — a skill that conducts structured market, competitor, technology and domain research from live sources, producing a cited research report. Run it before product planning or architecture decisions. CX Codex +1 138installs startup-business-analyst Seth Hobson startup-business-analyst is a Claude Code plugin for startup market, finance, and team analysis. Its skills respond to business questions, while commands generate projections and business cases. CX Codex ★ 42,780repo stars competitive-intelligence-analyst davila7 competitive-intelligence-analyst — a Claude Code subagent for competitor analysis and market research. It pulls data from public sources, runs SWOT and Porter's Five Forces, and writes structured reports to files. CX Codex 1,561installs competitive-analyst VoltAgent Community The competitive-analyst subagent researches direct and indirect competitors, compares products, and suggests positioning strategies. Use it when you need a structured competitor review before making a strategic decision. CX Codex 812installs analyst sametcelikbicak analyst is a Claude Code subagent that researches markets, competitors, and users from an idea or PRD brief. It writes a report and hands the findings to the PM for PRD work. CX Codex ★ 71repo stars business_requirements_analyst AgenticOrgLab The business_requirements_analyst Claude Code subagent turns unclear stakeholder requests into testable business requirements. It connects goals to acceptance criteria and flags gaps or conflicting statements. CX Codex ★ 776repo stars

From the same set33

The whole set →
bmad-agent-pm bmad-agent-pm — a skill for Claude Code and Cursor acts as John the Product Manager to write, update, and review project planning documents. CX Codex +1 17,800installs bmad-architecture bmad-architecture writes a short architecture document that pins down only the invariants keeping independently built parts of a system from diverging. CX Codex +1 17,800installs bmad-agent-pm bmad-agent-pm activates John, a product manager persona for PRD creation and requirements discovery. It breaks down product ideas into deliverable tickets. CX Codex +1 17,800installs bmad-agent-architect The bmad-agent-architect skill turns ticket requirements into technical architecture with explicit trade-offs. Use it when you want to work with Winston as the architect. CX Codex +1 17,800installs bmad-agent-analyst bmad-agent-analyst is a Claude Code skill that takes on Mary’s business analyst role for market research, competitor analysis, and requirements. It activates when asked to speak with Mary or call the business analyst. CX Codex +1 17,700installs bmad-agent-dev bmad-agent-dev activates Amelia, a senior software engineer persona executing stories through red, green, refactor and acceptance criteria. CX Codex +1 17,700installs bmad-agent-ux-designer bmad-agent-ux-designer activates Sally, a dedicated UX designer persona for crafting interaction design and interface specifications. Helps teams map out user journeys and edge cases before coding. CX Codex +1 17,600installs bmad-review bmad-review is a Claude Code skill that reviews code and documents through selected lenses. It runs only after an explicit request to review. CX Codex +1 17,400installs

More in the catalog

Project sponsors

Companies that keep this analytics open