create-agent-skill

To create an agent skill, define the required frontmatter and metadata following the AgentSkills.io specification, then structure the directory with SKILL.md, references, scripts, and assets. This provides a structured framework to make new capabilities discoverable and maintainable.

The recommended agent skill structure uses a root SKILL.md file alongside references, scripts, and assets subdirectories. This layout applies progressive disclosure principles by keeping SKILL.md concise while moving detailed implementation content into the appropriate subdirectories.

Skill creation requires defining the name, description, and metadata in the SKILL.md frontmatter according to the AgentSkills.io specification. Including optional metadata alongside these required fields ensures the agent skill is properly indexed, discoverable, and maintainable.

Keep SKILL.md concise by applying progressive disclosure principles: outline the core skill logic in the main file and move detailed project-specific agent knowledge, references, and scripts into their respective subdirectories to maintain readability and structure.

Package domain expertise as a reusable agent skill when you need to define consistent patterns for AI coding assistants. Structuring expertise this way ensures the knowledge is discoverable, maintainable, and effectively applied across multiple projects.

Building agent skills requires following the naming conventions specified in the AgentSkills.io framework to ensure discoverability and maintainability. Adhering to these standards when defining the skill name and directory structure prevents integration issues with AI assistants.