creating-skills

To structure an AI skill for discoverability, you must create a SKILL.md file with mandatory YAML frontmatter, specifying the `name` and `description` fields to maximize AI searchability and ensuring clear content organization.

YAML frontmatter in an AI skill requires mandatory `name` and `description` fields. These fields must follow specific naming conventions and keyword coverage rules to optimize the skill for AI search and understanding.

Writing a scannable SKILL.md involves organizing content with clear overviews, use cases, code examples, and common mistakes. This structure ensures the AI model can parse instructions efficiently and take action based on the provided documentation.

Optimizing prompt engineering documentation for token efficiency involves structuring your SKILL.md with concise overviews and clear sections. This approach reduces unnecessary tokens while maintaining the actionability of the AI skill instructions.

Utility scripts are an advanced practice for creating AI skills. While not mandatory, they support iterative development and help refine the skill's code quality and overall functionality during the creation process.

Your AI skill might not be found due to poor naming conventions or inadequate keyword coverage in the description. Optimizing the `name` and `description` frontmatter fields directly improves the skill's visibility and searchability for AI models.