skill-creator

To create an AI agent skill, you generate a SKILL.md file with YAML frontmatter containing the name and description, add operational guidance in the Markdown body, and enforce local-path references to prevent invalid documentation linking.

The correct directory structure for agent skills separates supporting materials into assets/ for templates and schemas, and references/ for local documentation, ensuring standardized and discoverable skill units.

You should create a new skill when you need to turn repeated instruction patterns into standardized operational guidance, whereas references are for local documentation that supports the skill without duplicating existing workflows.

The YAML frontmatter for a SKILL.md file must include the name and description fields to establish identity and discoverability, followed by operational guidance written directly in the Markdown body.

Your agent skill should use a generic name for broad reuse, but a namespace-prefixed name is recommended when defining skills for a specific domain to prevent naming collisions and improve discoverability.