agent-skills

Author a new Agent Skill by creating a SKILL.md file with correct frontmatter, a concise body following progressive disclosure, and proper directory structure. The specification enforces naming rules, descriptions, and reference-file guidance to ensure compliance and discoverability.

Progressive disclosure in Agent Skills means structuring documentation so users encounter essential information first, then deeper details on demand. This approach keeps SKILL.md bodies concise while supporting reference files and layered explanations for complex tasks.

Review your Skill against the agentskills.io specification checklist: verify frontmatter correctness, naming and description rules, optional metadata presence, structured directory layout, and progressive-disclosure workflow. Quality checks ensure consistency and proper organization across your Skill repository.

Yes, modify existing skills by updating SKILL.md files and reorganizing directories to enforce proper naming, descriptions, and progressive disclosure. The specification provides guidance for improving Skill clarity, structure, and compliance with agentskills.io standards.

Agent Skills require core frontmatter fields defined by the agentskills.io specification for proper function and discovery. Optional metadata fields allow additional context; the specification documents which fields are mandatory and which enhance Skill quality without being essential.

Organize Skill directories following the agentskills.io specification structure guidelines, using consistent naming conventions and logical groupings. Proper directory layout ensures scalability, discoverability, and enables effective progressive-disclosure workflows across your Skill collection.