Open Standard: Specification - Agent Skills
At its core, a skill is a folder containing a SKILL.md file. This file includes metadata (name and description, at minimum) and instructions that tell an agent how to perform a specific task. Skills can also bundle scripts, templates, and reference materials.
my-skill/
├── SKILL.md # Required: instructions + metadata
├── scripts/ # Optional: executable code
├── references/ # Optional: documentation
└── assets/ # Optional: templates, resources
Skill的基本思想是按需加载;一开始只会读取少量元数据(名称、描述)。模型根据任务选定符合描述的Skill后,惰性载入SKILL.md,并按照其中的指示行事。
Recommended sections for the body:
- Step-by-step instructions
- Examples of inputs and outputs
- Common edge cases