sepehr
4f7e808855
Next.js dashboard with git statistics, AI-powered summaries via Ollama, and research documents for project planning. Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
48 lines
2.4 KiB
Markdown
48 lines
2.4 KiB
Markdown
# Template Substitution Rules
|
|
|
|
The SKILL-template provides a minimal skeleton: frontmatter, overview, and activation with config loading. Everything beyond that is crafted by the builder based on what was learned during discovery and requirements phases.
|
|
|
|
## Frontmatter
|
|
|
|
- `{module-code-or-empty}` → Module code prefix with hyphen (e.g., `bmb-`) or empty for standalone. The `bmad-` prefix is reserved for official BMad creations; user skills should not include it.
|
|
- `{skill-name}` → Skill functional name (kebab-case)
|
|
- `{skill-description}` → Two parts: [5-8 word summary]. [trigger phrases]
|
|
|
|
## Module Conditionals
|
|
|
|
### For Module-Based Skills
|
|
|
|
- `{if-module}` ... `{/if-module}` → Keep the content inside
|
|
- `{if-standalone}` ... `{/if-standalone}` → Remove the entire block including markers
|
|
- `{module-code}` → Module code without trailing hyphen (e.g., `bmb`)
|
|
- `{module-setup-skill}` → Name of the module's setup skill (e.g., `mymod-setup`)
|
|
|
|
### For Standalone Skills
|
|
|
|
- `{if-module}` ... `{/if-module}` → Remove the entire block including markers
|
|
- `{if-standalone}` ... `{/if-standalone}` → Keep the content inside
|
|
|
|
## Customization Conditionals
|
|
|
|
### When Customization Is Opted In
|
|
|
|
- `{if-customizable}` ... `{/if-customizable}` → Keep the content inside; emit `customize.toml` alongside SKILL.md.
|
|
- Lifted configurable scalars are referenced in SKILL.md body as `{workflow.<name>}` (e.g. `{workflow.brief_template}`). These are resolved at runtime by the resolver, not at build time — emit them verbatim.
|
|
|
|
### When Customization Is Not Opted In
|
|
|
|
- `{if-customizable}` ... `{/if-customizable}` → Remove the entire block including markers.
|
|
- Do NOT emit `customize.toml`. Use hardcoded paths and values in SKILL.md throughout.
|
|
|
|
## Beyond the Template
|
|
|
|
The builder determines the rest of the skill structure — body sections, phases, stages, scripts, external skills, headless mode, role guidance — based on the skill type classification and requirements gathered during the build process. The template intentionally does not prescribe these; the builder has the context to craft them.
|
|
|
|
## Path References
|
|
|
|
All generated skills use paths relative to skill root (cross-directory) or `./` (same-folder):
|
|
|
|
- `references/{reference}.md` — Reference documents loaded on demand
|
|
- `references/{stage}.md` — Stage prompts (complex workflows)
|
|
- `scripts/` — Python/shell scripts for deterministic operations
|