maestro-skill-author

Maestro skills fail to load when SKILL.md frontmatter is missing required fields or uses incorrect URL-escaped directory naming. Rebuilding the skill registry after fixing the on-disk slug encoding and validation rules ensures the skill appears in maestro skill-list.

Multi-step workflows in Maestro require organizing supplemental content in reference/ files and naming step files as reference/steps/step-N-* to meet loader expectations. Consistent file naming conventions ensure correct embedding and discovery during the skills build.

Valid Maestro built-in skills require the name and description fields in the SKILL.md YAML frontmatter. Strict formatting rules and correct on-disk slug encoding must be applied before rebuilding the skill registry to pass validation.

Reference files fail to embed when directory naming is not URL-escaped correctly or step file naming conventions are broken. Correct the SKILL.md frontmatter formatting and reference architecture, then run the required build step to update the generated registry.

Yes, a required build step must be run after editing SKILL.md frontmatter or reference files. This rebuilds the skill registry, embeds the updated content correctly, and makes the skill discoverable during the maestro skill-list execution.