CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

bmad-prd

Create, update, or validate a PRD. Use when the user wants help producing, editing, or validating a PRD

Quality

90%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

SKILL.md
Quality
Evals
Security

Quality

Content

88%Weight 40%Scale 1-5

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

An exceptionally well-engineered workflow skill: fully executable commands, explicit sequencing with validation gates and recovery loops for every failure mode, and a clean split between the orchestration body and reference/template files. Its only costs are a slightly dense prose style in a few policy paragraphs and placeholder indirection that obscures the direct path to template assets.

DimensionReasoningScore

Conciseness

The body is dense, directive, and assumes competence ("You are a master facilitator", no explanation of what a PRD is or basic PM concepts), with nearly every line carrying non-inferable BMad-specific policy. A few passages could still be trimmed — the long "File roles" paragraph and open-ended enumerations like "compliance, integration density, operational SLAs, hardware constraints, public-API contracts, monetization, data governance" — placing it at anchor 4 (minor over-explanation) rather than 5's every-token-earns-its-place, and well above anchor 3 since there is no real padding.

4 / 5

Actionability

Guidance is copy-paste executable throughout: complete commands with flags ("uv run {project-root}/_bmad/scripts/memlog.py append --workspace {doc_workspace} --type <decision|change|override|assumption|event> --text \"...\"", "resolve_customization.py --skill {skill-root} --project-root {project-root} --key workflow", "npx skills add bmad-code-org/BMAD-METHOD --skill bmad"), exact output paths, frontmatter fields, and concrete fallback behavior for every failure mode. This matches anchor 5 (fully executable commands covering the common create/update/validate cases); anchor 4 would require missing key details, and there are none.

5 / 5

Workflow Clarity

Multi-step processes are explicitly sequenced with validation checkpoints and error-recovery loops: Activation steps 1–5 with per-failure feedback ("Script not found: ... offer to run setup ... then run the command again"; "confirm every entry was executed in order before proceeding"), Discovery's fixed order "Brain dump → Stakes calibration → Working mode", and Finalize steps 1–8 with ordering rationale ("Polish goes last so it does not redo work after reviewer fixes", "Must happen before polish", conflicts surfaced before applying changes). This matches anchor 5's explicit validation steps, feedback loops, and checklists; anchor 4 would need missing checkpoints.

5 / 5

Progressive Disclosure

The body is an orchestration hub with clearly signaled, point-of-need references ("If headless, follow references/headless.md for the whole run", "Load references/validate.md"), both verified to exist and one level deep, with templates correctly split into assets/. The gap keeping it from anchor 5: the large template assets (prd-template.md, prd-validation-checklist.md) are reachable only through {workflow.prd_template}/{workflow.validation_checklist_template} placeholder indirection rather than direct paths, and reference files point onward to assets — minor organization gaps characteristic of anchor 4.

4 / 5

Total

18

/

20

Passed

Description

87%Weight 40%Scale 1-5

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

A strong, well-structured description: third-person, concise, with an explicit Use-when trigger clause and full coverage of the skill's three intent modes. The only improvement space is spelling out "product requirements document" once for synonym coverage.

DimensionReasoningScore

Specificity

"Create, update, or validate a PRD" lists three distinct concrete actions on a named artifact, covering the skill's full scope, but the actions stay high-level without naming what the PRD elaborates (features, user journeys, success metrics). This matches anchor 4 (several specific actions, minor gaps in coverage) rather than 5, whose exemplars pair each action with a distinct concrete object.

4 / 5

Completeness

The description explicitly answers both questions: "Create, update, or validate a PRD" (what) and "Use when the user wants help producing, editing, or validating a PRD" (when, with concrete trigger phrases). This mirrors the anchor-5 exemplar's structure of action list plus explicit Use-when triggers; anchor 4 would require the when-clause to be less explicit, which it is not.

5 / 5

Trigger Term Quality

"PRD" is the dominant natural keyword and "producing, editing, or validating" mirror real user phrasing, but the expansion "product requirements document" and common synonyms ("product spec", "requirements doc") are absent. Good coverage with a few natural terms missing fits anchor 4, not 5's comprehensive synonym/extension coverage.

4 / 5

Distinctiveness Conflict Risk

"PRD" is a clear niche term with distinct triggers; a user saying "PRD" unambiguously wants this skill, and adjacent product-shaping skills (one-pagers, PRFAQs) target different artifacts and terms. Minimal conflict risk matches anchor 5; it is not anchor 4 because no closely related skill shares this trigger.

5 / 5

Total

18

/

20

Passed

Validation

100%

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

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

bmad-code-org/BMAD-METHOD

Path

skills/bmad-prd/SKILL.md

Reviewed

Table of Contents

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.