creating-skills

To create new agent skills, follow best practices for defining directory structure, naming conventions, and frontmatter requirements to ensure your skills are well-organized and discoverable. This framework guides you from gathering requirements to final content definition.

A SKILL.md file for agent development should include clear metadata frontmatter, a defined purpose, and well-structured body content. Adhering to specific naming conventions and instruction clarity ensures the skill functions effectively within its domain.

The best way to scaffold a new skill is to use a structured framework that guides you through defining its purpose, location, and content structure. This ensures the skill is set up effectively for its specific domain use case.

No specific developer tools or dependencies are required to start authoring agent skills. You only need to follow the established guidelines for writing the skill files, structuring the directory, and defining the required metadata.

Your agent skill may lack discoverability if it fails to adhere to best practice guidelines for structure, naming conventions, and metadata. Enforcing a specific content structure and clear instructions ensures the skill is well-organized and effective.