creating-skills

To create reusable agent skills, use an open-standard template by adding a SKILL.md file with YAML frontmatter and Markdown body to a new folder under the skills root, optionally including scripts, references, and assets directories.

The SKILL.md format for modular agent design includes required YAML frontmatter specifying the name and description, a Markdown body for documentation, and supports optional directories for scripts, references, and assets to ensure scalability.

To publish and maintain skills within the catalog, create the structured skill directory, reference it in the AGENTS.md file, and push the changes to the repository to ensure discovery and reusability.

You need a standardized open-standard template for agent skills when you want to solve the problem of inconsistent agent skill authoring and enforce clear guidelines for naming, scope, and documentation across your projects.

Yes, agent skill authoring requires specific directory structures for scalability, utilizing a root folder containing SKILL.md alongside optional scripts, references, and assets directories to promote safe, modular design and reusability.

A limitation of using YAML frontmatter in skill creation is that it enforces strict requirements, specifically mandating the inclusion of name and description fields within the SKILL.md file to ensure proper catalog discovery and standardization.