bmad-agent-analyst

Activates a business analyst persona for market research, requirements elicitation, and product briefs.

Updated Sep 3, 2026
One-click install
npx skills add https://github.com/watchthelight/shatterfish --skill bmad-agent-analyst-watchthelight
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: bmad-agent-analyst
Source: https://github.com/watchthelight/shatterfish/tree/main/.claude/skills/bmad-agent-analyst
Command: npx skills add https://github.com/watchthelight/shatterfish --skill bmad-agent-analyst-watchthelight

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Teams often jump into projects with vague ideas and no structured analysis. This Skill activates Mary, a business analyst persona that guides market research, competitive analysis, and requirements elicitation through a customizable menu of research and planning workflows. ## Core Features & Use Cases - Persona Activation with Customization: Loads a layered agent configuration from TOML files (defaults, team overrides, personal overrides) to shape the analyst's role, style, and principles. - Research and Analysis Menu: Dispatches guided workflows for brainstorming, market research, domain research, technical research, competitive teardowns, user-voice research, and technology selection. - Planning Artifact Creation: Produces product briefs, PRFAQ documents, and project context files through connected BMad skills. - Use Case: A product manager asks Mary to run a competitive teardown of three rivals; the analyst persona loads persistent project facts, greets the user, and dispatches the competitive research workflow with findings grounded in evidence. ## Quick Start Ask to talk to Mary the business analyst and request a market analysis for your product idea.

Frequently Asked Questions about bmad-agent-analyst

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I use the business analyst agent for market research?

Invoke the analyst persona and select the market research menu item, which forwards to the deep research workflow with the market type pre-selected. The analyst guides you through competitive landscape, customer needs, and trend analysis.

How do I customize the analyst agent's persona and menu?

Edit the customize.toml file in the skill directory or add team and user override TOML files under the project's _bmad/custom directory. Scalars override, tables deep-merge, and menu items merge by code.

What is the difference between product brief and PRFAQ workflows?

The product brief workflow creates or updates briefs through guided discovery, while the PRFAQ workflow applies a Working Backwards approach to forge and stress-test product concepts. Both are dispatched from the analyst's menu.

Does the analyst agent work without the BMad config file?

The activation flow expects a config file at _bmad/bmm/config.yaml for user name, language, and output locations. Without it, greeting and output routing steps cannot resolve their configured values.

What are the limitations of the analyst persona?

The persona focuses on analysis and planning artifacts, not implementation. Research depth depends on the connected downstream skills it dispatches, and persistent facts only load from files that exist in the project.