sage-skill-development

Frontmatter for Claude Code agent skills requires mandatory YAML name and description fields, while optional when_to_use and allowed_tools fields control auto or manual triggering.

The standard SKILL.md format requires YAML frontmatter with name and description fields to ensure consistent discovery, and supports optional components like scripts and references within the Skill directory.

Skill discovery and activation in Sage works by scanning project and user discovery paths, matching frontmatter metadata to trigger conditions, and loading associated components like scripts and assets when present.

Yes, you can use optional resource directories when developing a skill to populate components like scripts, references, and assets, which are loaded by the agent when the skill is activated.

The specification is limited to governing frontmatter fields and resource directories for Skill units, meaning it does not define complex execution logic but strictly enforces mandatory name and description metadata.