bmad-agent-analyst

Strategic business analyst and requirements expert. Use when the user asks to talk to Mary or requests the business analyst.

Quality

68%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./src/bmm-skills/1-analysis/bmad-agent-analyst/SKILL.md

Quality

Content

62%

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

The body is a well-sequenced activation workflow with strong error-recovery and validation checkpoints, but it relies on runtime template placeholders for actionability and keeps all content inline without reference files.

Suggestions

Where {agent.*} placeholders are resolved, give one short worked example of a resolved value so the step is copy-paste runnable, not purely schematic.

Move the persona/style guidance into a referenced file (e.g. references/persona.md) so SKILL.md stays a lean overview and earns progressive disclosure.

Dimension	Reasoning	Score
Conciseness	It avoids explaining concepts Claude already knows and stays procedural, but motivational phrasing like 'Fully embody this persona so the user gets the best experience' could be tightened, matching anchor 2 rather than 3.	2 / 3
Actionability	It includes one concrete executable command and explicit merge-rule semantics, yet most steps are driven by runtime-resolved {agent.*} template placeholders rather than copy-paste-ready code, fitting anchor 2.	2 / 3
Workflow Clarity	A clear 8-step sequence includes an explicit error-recovery feedback loop (the script-failure fallback) and a completion-validation checkpoint, matching anchor 3.	3 / 3
Progressive Disclosure	Sections are well-organized with no nested references, but all content is inline with no one-level-deep reference files, and at ~70 lines it exceeds the under-50-line simple-skill exemption, fitting anchor 2.	2 / 3
	Total	9 / 12 Passed

Description

75%

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

The description cleanly answers both what and when with a distinctive persona trigger, but it states a role rather than listing concrete actions and has narrow trigger-term coverage.

Suggestions

Replace the role label with concrete actions, e.g. 'Elicits and structures requirements, performs market and competitive analysis, and translates vague needs into actionable specs.'

Broaden trigger terms to include natural variations users might say, such as 'analyst', 'BA', 'requirements analysis', or 'gathering requirements'.

Dimension	Reasoning	Score
Specificity	It names a clear domain ('Strategic business analyst and requirements expert') but lists no concrete action verbs, matching anchor 2 rather than 3 (no list of specific actions) and staying above 1 (more specific than 'Helps with documents').	2 / 3
Completeness	It explicitly answers what (the role) and when ('Use when the user asks to talk to Mary or requests the business analyst') with an explicit trigger, matching anchor 3.	3 / 3
Trigger Term Quality	Natural terms like 'talk to Mary' and 'business analyst' are present, but coverage is limited and misses common variations (analyst, BA, requirements), fitting anchor 2.	2 / 3
Distinctiveness Conflict Risk	The persona-name trigger 'talk to Mary' is highly distinctive and unlikely to fire the wrong skill, satisfying anchor 3 despite the somewhat generic 'business analyst' phrase.	3 / 3
	Total	10 / 12 Passed

Validation

93%

Warnings & errors only

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 15 / 16 Passed

Validation for skill structure

Criteria	Description	Result
referenced_paths_exist	Referenced path issues: 1 missing	Warning

	Total	15 / 16 Passed

Repository: bmad-code-org/BMAD-METHOD
Path: src/bmm-skills/1-analysis/bmad-agent-analyst/SKILL.md
Commit: bb45db4

Reviewed: 1 day ago

Table of Contents

Discovery Implementation Validation

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.