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.
Feature Planning
Documentation
Creates structured feature specifications for Amaranth 10 modules, including license splits, user stories, and requirements.