writing-skills

To validate YAML frontmatter in a SKILL.md file, ensure the required name and description fields are present and correctly formatted. This validation enforces the Agent Skills open standard for reliable loading and discovery.

The correct structure for agent skills uses kebab-case naming conventions and specific folder layouts. Optional resources are organized within expected directories to ensure proper skill validation, review, and QA workflows.

Review existing agent skills for quality by analyzing the SKILL.md body content, verifying the 3-level loading model, and checking dependencies and components. This process enforces structure, naming conventions, and metadata accuracy.

A good SKILL.md file features valid YAML frontmatter, clear body instructions, progressive disclosure, and example patterns. Bad files lack required metadata, proper structure, and fail toxicity checks for unsafe content detection.

You need the 3-level loading model during skill validation to enforce proper structure and metadata discovery. It ensures dependencies and components are correctly verified before agent skills are loaded.

Yes, you can check agent skills for unsafe content. The skill validation process analyzes SKILL.md files and reports toxicity if unsafe content is detected, ensuring secure execution environments.