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