create-agent-skill

To create Claude Code skills, you need a defined YAML frontmatter schema where name and description are required fields, alongside optional resources directories and contextual instructions within the SKILL.md file. This ensures consistent skill creation and validation.

The best way to validate a SKILL.md file is to check its structure against a defined frontmatter schema, ensuring required fields like name and description are present, and verifying generated metadata such as tagline, keywords, dependencies, and toxicity status are correctly formatted.

When building a skill template, you must generate metadata fields including tagline, description, request, complexity, category, keywords, dependencies, components, and toxicity status, ensuring the required name and description fields are present in the YAML frontmatter.

Yes, you can update existing skills by validating the YAML frontmatter schema to maintain required name and description fields, while safely modifying contextual instructions and optional resources directories to enhance functionality without breaking consistency.

You should use an optional resources directory when your skill requires supplementary files or contextual instructions beyond the standard SKILL.md template, ensuring all components are properly referenced within the YAML frontmatter schema.