Our review
This deprecated skill forwards to the newer bmad-prd skill with create intent, preserving legacy customizations while issuing a deprecation notice.
Strengths
- Provides backward compatibility for existing invocations and user override files.
- Preserves legacy customization fields by forwarding them to the new skill.
- Emits a clear deprecation notice guiding migration.
Limitations
- Deprecated and scheduled for removal in v7.
- Offers only a subset of the new skill's customization options.
- Relies on the new skill being present and functional.
Use when existing workflows or invocations still reference bmad-create-prd.
Do not use for new work; invoke bmad-prd directly instead.
Security analysis
SafeThe skill only runs a known internal Python script with fixed arguments and loads configuration files. There are no destructive commands, data exfiltration, or execution of arbitrary user input. It is a straightforward compatibility shim.
No concerns found
Examples
Create a PRD for a user profile page.Write a product requirements document for our new checkout flow.Draft a PRD for an admin dashboard.name: bmad-create-prd
description: 'DEPRECATED — consolidated into bmad-prd create intent - this skill will be removed in v7 in favor of bmad-prd.'
DEPRECATED — forwards to bmad-prd (create intent)
This skill was consolidated into bmad-prd. It is retained as a thin compatibility shim so existing invocations by name and _bmad/custom/bmad-create-prd.toml override files keep working. New work should invoke bmad-prd directly — it detects create / update / validate intent from the conversation.
On Activation
-
Resolve customization:
python3 {project-root}/_bmad/scripts/resolve_customization.py --skill {skill-root} --key workflow. This picks up any{project-root}/_bmad/custom/bmad-create-prd.tomlandbmad-create-prd.user.tomloverrides for the legacy fields (activation_steps_prepend,activation_steps_append,persistent_facts,on_complete). -
Load
{project-root}/_bmad/bmm/config.yaml(andconfig.user.yamlif present) to resolve{user_name}and{communication_language}. -
Emit a deprecation notice to the user in
{communication_language}:Notice:
bmad-create-prdis deprecated and will be removed in a future release. It now forwards tobmad-prdwith create intent. To silence this notice and access the full new customization surface (prd_template,validation_checklist,doc_standards,external_sources,external_handoffs,output_dir,output_folder_name), migrate_bmad/custom/bmad-create-prd.tomlto_bmad/custom/bmad-prd.tomland invokebmad-prddirectly next time. Customization fields that were in this version still remain in the new version and will be respected if present in_bmad/custom/bmad-prd.toml, but the new version also supports additional fields that you can take advantage of by migrating. -
Invoke
bmad-prdwith the following context. Pass these as the activating context sobmad-prdhonors them instead of resolving its own customization from scratch:- Intent:
create— skipbmad-prd's usual intent detection step. - Pre-resolved legacy customization — use these in place of resolving from
bmad-prd's owncustomize.tomlfor the four legacy fields. For everything else (prd_template,validation_checklist,validation_report_template,doc_standards,output_dir,output_folder_name,external_sources,external_handoffs), usebmad-prd's own defaults and overrides as normal:activation_steps_prepend= the resolved value from step 1activation_steps_append= the resolved value from step 1persistent_facts= the resolved value from step 1on_complete= the resolved value from step 1
- Original user input: forward whatever the user said when invoking this skill verbatim.
bmad-prdtakes the workflow from here. Do not execute any further steps in this shim. - Intent:
API Documentation Generator
Documentation
Automatically generates OpenAPI/Swagger API documentation.
Technical Writer
Documentation
Writes clear technical documentation following top style guides.
Beautify GitHub README
Documentation
Redesign GitHub README homepages or create project-native SVG assets, hybrid SVG-composed PNG/WebP, and optional animated GIF.