bmad-create-prd (deprecated)

VerifiedSafe

Deprecated shim that forwards to bmad-prd with create intent. Retained for compatibility; migrate to bmad-prd.

Sby Skills Guide Bot
DocumentationIntermediate
1308/10/2026
Claude Code
#deprecated#prd#product-requirements#compatibility-shim

Recommended for

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.
When to use it

Use when existing workflows or invocations still reference bmad-create-prd.

When not to use it

Do not use for new work; invoke bmad-prd directly instead.

Security analysis

Safe
Quality score80/100

The 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 user profile PRD
Create a PRD for a user profile page.
Write checkout flow PRD
Write a product requirements document for our new checkout flow.
Draft admin dashboard PRD
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

  1. 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.toml and bmad-create-prd.user.toml overrides for the legacy fields (activation_steps_prepend, activation_steps_append, persistent_facts, on_complete).

  2. Load {project-root}/_bmad/bmm/config.yaml (and config.user.yaml if present) to resolve {user_name} and {communication_language}.

  3. Emit a deprecation notice to the user in {communication_language}:

    Notice: bmad-create-prd is deprecated and will be removed in a future release. It now forwards to bmad-prd with 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.toml to _bmad/custom/bmad-prd.toml and invoke bmad-prd directly 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.

  4. Invoke bmad-prd with the following context. Pass these as the activating context so bmad-prd honors them instead of resolving its own customization from scratch:

    • Intent: create — skip bmad-prd's usual intent detection step.
    • Pre-resolved legacy customization — use these in place of resolving from bmad-prd's own customize.toml for 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), use bmad-prd's own defaults and overrides as normal:
      • activation_steps_prepend = the resolved value from step 1
      • activation_steps_append = the resolved value from step 1
      • persistent_facts = the resolved value from step 1
      • on_complete = the resolved value from step 1
    • Original user input: forward whatever the user said when invoking this skill verbatim.

    bmad-prd takes the workflow from here. Do not execute any further steps in this shim.

Related skills