skills/spec/agent-skills-spec.md

Agent Skills Spec

A skill is a folder of instructions, scripts, and resources that agents can discover and load dynamically to perform better at specific tasks. In order for the folder to be recognized as a skill, it must contain a SKILL.md file.

Guides

• Skill Authoring Guide — How to create skills, including folder layout and SKILL.md format
• Skill Client Integration Guide — How to add Skills support to a new agent or product

Version History

• 1.1 (2025-12-16) Added guidance for Skill Client implementors.
• 1.0 (2025-10-16) Public Launch