writing-skills

SKILL.md documentation requires specific sections including Prerequisites, Usage, Gotchas, and Related Skills, along with a frontmatter schema containing name, description, and metadata to ensure predictable loading and discovery.

Frontmatter for CI agent-skills must enforce a consistent schema with name, description, and metadata fields, reducing ambiguity and maintenance overhead across the repository.

Creating a new skill markdown file requires mandatory sections: Prerequisites, Usage, Gotchas, and Related Skills, ensuring predictable loading and clear maintenance guidelines for contributors.

Yes, references and scripts directories are optional but supported components of skill authoring, and the house style guidelines help teams ensure these directories exist when referenced in SKILL.md.

A style guide maintains agent-skills repositories by defining expected structure and wording for SKILL.md files, frontmatter, and references, which reduces ambiguity and lowers maintenance overhead for teams.

Standardized documentation formats for agent-skills should not be bypassed when working within this repository, as deviating from the house style increases ambiguity and breaks predictable loading and discovery mechanisms.