create-skill

A spec-compliant GAAI skill directory ensures your custom skills are discoverable and consistent. It requires strict YAML frontmatter, specific body sections, and mandatory index updates so discovery and delivery sessions can properly locate and execute the skill.

To structure a SKILL.md file for GAAI skill creation, include YAML frontmatter with name and description, followed by body sections for Purpose, Process, Quality Checks, Outputs, and Non-Goals. Optional resource directories like scripts/ or references/ can also be added.

The required sections in a GAAI SKILL.md body are Purpose, Process, Quality Checks, Outputs, and Non-Goals. These mandatory components ensure the skill unit is self-contained, properly documented, and ready for indexing across core and project indices.

To update core and project skill indices after creating a new skill, place the directory under .gaai/core/skills/, add the properly structured SKILL.md, and run the index build tool. This registers the skill in agent skill lists for discoverability.

You do not need to manually update agent skill lists when adding a new GAAI skill if you run the index build tool. The tool automatically registers the new spec-compliant skill directory across core and project indices for delivery sessions.

You can use optional resource directories when building a GAAI skill unit. The SKILL.md spec supports adding scripts/, references/, and assets/ directories alongside the mandatory frontmatter and body sections to keep your skill self-contained.