Skip to content

docs(customize): explain which skills use render_skill.py vs inline customization - #2891

Draft
gmoncor wants to merge 1 commit into
bmad-code-org:devfrom
gmoncor:docs/s01-05-explain-render-skill-mechanism
Draft

gmoncor wants to merge 1 commit into
bmad-code-org:devfrom
gmoncor:docs/s01-05-explain-render-skill-mechanism

Conversation

@gmoncor

@gmoncor gmoncor commented Sep 17, 2026

Copy link
Copy Markdown

What

Add a paragraph explaining that skills with their own workflow.md use render_skill.py to inject customize.toml overrides into a workflow.md template, while skills without one resolve customization inline or via resolve_customization.py.

Why

bmad-retrospective/SKILL.md references a render_skill.py + workflow.md mechanism without explaining why; this pattern is shared by 4 other skills, so centralizing the explanation avoids 5 duplicated paragraphs.

How

  • Added the explanatory paragraph to docs/customize/customize-bmad.md next to the existing render_skill.py documentation.

Testing

Read-through diff; doc-only change.

🤖 Generated with Claude Code

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant