Skill Best Practices

Structure SKILL.md by starting with YAML frontmatter containing required name and description fields, followed by a lean body that links to references for deeper topics to enforce progressive disclosure.

Trigger phrases should use robust patterns and domain-aware guidance to ensure reliable skill activation, matching specific domain vocabulary to consistently trigger the intended automation workflows.

Organize documentation by keeping the SKILL.md body lean and moving detailed content into a linked references directory, enforcing progressive disclosure for consistent structure and maintainability.

Apply validation checks to ensure YAML frontmatter includes required fields, trigger phrases follow established patterns, and linked references are consistently implemented across the skill folder.

Progressive disclosure manages large documentation by keeping the SKILL.md body lean and routing deeper technical topics to a references directory, ensuring the core trigger logic remains maintainable.

Create a new skill folder containing SKILL.md and a references directory, fill the frontmatter with required fields, and populate the body with core guidance linked to reference files.