[BUG] bmad-module-builder ships an invalid SKILL.md template that Codex skips during skill loading

[cmd16]

Description

The bmad-module-builder module includes a template skill file that is being picked up by Codex skill discovery, but its YAML frontmatter is invalid for the expected schema.

The affected file is:

.agents/skills/bmad-module-builder/assets/setup-skill-template/SKILL.md

Its frontmatter starts with:

name: { setup-skill-name }
description: Sets up {module-name} module in a project. Use when the user requests to 'install {module-code} module', 'configure {module-name}', or 'setup {module-name}'.

The name value is parsed as a YAML map rather than a string, so Codex rejects the file and logs an invalid SKILL.md error.

Making the below changes (adding quotes) fixed the issue

---

name: "{setup-skill-name}"
description: "Sets up {module-name} module in a project. Use when the user requests to 'install {module-code} module', 'configure {module-name}', or 'setup {module-name}'."

Steps to reproduce

1. Install or load the BMAD method skills in Codex.
2. Start a Codex session in an environment where .agents/skills/bmad-module-builder/assets/setup-skill-template/SKILL.md is present.
3. Observe the skill-loading warning: skipped loading 1 skill(s) due to invalid SKILL.md files.
4. Check the Codex log output.

Expected behavior

Codex should load all shipped BMAD skill files cleanly without warnings.

The template file should either:

• contain valid YAML frontmatter, or
• be stored somewhere that is not scanned as a loadable skill.

Actual behavior

Codex skips loading one skill file because the template SKILL.md has invalid YAML frontmatter.

Screenshots

No response

Which module is this for?

BMad Method (BMM) - Core Framework

BMad Version

6.2.2

Which AI IDE are you using?

Other

Operating System

macOS

Relevant log output

failed to load skill [project-root].agents/skills/bmad-module-builder/assets/setup-skill-template/SKILL.md: invalid YAML: name: invalid type: map, expected a string at line 1 column 7

Note that [project-root] here is being used as a placeholder to redact actual project root path.

Confirm

• I've searched for existing issues
• I'm using the latest version

[coderabbitai]

⚠️ Possible Duplicate Issue(s)

• Module-builder setup skill template ships invalid SKILL.md YAML frontmatter #2196

🔗 Related PRs

#1729 - feat: migrate Codex installer from .codex/prompts to .agents/skills format [merged]
#1934 - refactor(bmm): convert create-ux-design workflow to native skill [merged]
#1982 - fix(skill): clean up bmad-create-product-brief validation findings [merged]
#1997 - fix(skill): validation cleanup for quick-flow skills [merged]
#2126 - fix: update bmb module-definition path [merged]

---

📝 Issue Planner

_{Check the box below or use the @coderabbitai plan command to generate an implementation plan and prompts that you can use with your favorite coding assistant.}

• Create Plan

---

🧪 Issue enrichment is currently in open beta.

You can configure auto-planning by selecting labels in the issue_enrichment configuration.

To disable automatic issue enrichment, add the following to your .coderabbit.yaml:

issue_enrichment:
  auto_enrich:
    enabled: false

💬 Have feedback or questions? Drop into our discord!

[cmd16]

Looks like this will be fixed by bmad-code-org/bmad-builder#55

[bmadcode]

merged the PR 55. Thanks @cmd16