create-agent-skill

To scaffold an Agent Skill, create a directory named after your skill, add a SKILL.md file with proper frontmatter fields like name, description, and license, and include optional scripts, references, or assets folders as needed for your workflow.

Required frontmatter fields for an Agent Skill include name, description, license, compatibility, metadata, and allowed-tools to ensure consistent discovery and pass the built-in structure validator without errors.

Agent Skill validation fails when the folder-name alignment does not match the name field in the frontmatter, or when required frontmatter fields and the clean directory structure are missing or incorrectly formatted.

You need Python and the pyyaml dependency to parse YAML frontmatter and run the built-in validation scripts that check your skill structure, frontmatter fields, and resource packaging.

The best way to package optional resources is to place them in dedicated scripts, references, and assets directories alongside your SKILL.md file, following the documented scalable directory layout for maintainable skills.

Yes, you can use this to enforce naming conventions, validate folder-name alignment with the name field, and surface common Gotchas and best practices, ensuring your team builds robust and maintainable Agent Skills.