maestro-skill-author

Structure a Maestro skill by defining the SKILL.md frontmatter, organizing the reference directory layout, and configuring step-file architecture to ensure proper build-time embedding and registry validation. This skill guides you through that exact directory structure and file formatting.

Skill discovery failures often stem from incorrect SKILL.md frontmatter validation or naming convention errors. This skill helps identify and resolve these loading issues by validating your frontmatter fields and ensuring your skill meets Maestro's registry requirements.

Debug reference file loading failures by checking the reference directory structure and verifying build-time embedding paths. This skill assists in identifying access issues and resolving mismatches between your step-file architecture and the expected file layout.

Yes, you can validate an existing skill directory by pointing the skill at your target path, such as 'skills/new-skill/'. It checks the SKILL.md format, reference file organization, and overall structure to ensure your skill is functional and discoverable.

SKILL.md frontmatter requires specific fields for alias management and registry validation to ensure proper skill discovery. This skill provides clear instructions on formatting frontmatter correctly to prevent validation errors during the build process.

When updating Maestro skills, limitations arise from frontmatter validation rules, strict naming conventions, and build-time embedding requirements. This skill addresses these constraints by guiding you through alias management and reference file structure to prevent loading failures.