Agent Skills Spec

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.

Skill Folder Layout

A minimal skill folder looks like this:

my-skill/
  - SKILL.md

More complex skills can add additional directories and files as needed.

The SKILL.md file

The skill's "entrypoint" is the `SKILL.md` file. It is the only file required to exist. The file must start with a YAML frontmatter followed by regular Markdown.

YAML Frontmatter

The YAML frontmatter has 2 required properties:

undefined

There are 3 optional properties:

undefined

Markdown Body

The Markdown body has no restrictions on it.

Additional Information

For a minimal example, see the `template-skill` example.

Version History

undefined