Agent Atlas

Atlas · agents

Skills

Packaged instructions for one kind of task, loaded only when a task needs them.

Established practiceDepth 2 of 4Reviewed 2026-11-08

See it working: Plate II

In plain words

A skill is a recipe the agent can pull off the shelf. Only its title and one-line description sit in the context all the time.

How it works

Each skill is a folder with a SKILL.md file: a short header with a name and description, then the full instructions. The harness shows the descriptions up front and loads a skill’s full text when the task matches it.

Going deeper

This is progressive disclosure: cheap pointers always, expensive detail on demand. The description is the trigger, so it must match how people actually phrase the task.

Sources

  1. Extend Claude with skills Anthropic
    • full skill content only loads when invoked.
    • the description helps Claude decide when to load the skill automatically.
  2. Agent Skills specification Agent Skills
    • The SKILL.md file must contain YAML frontmatter followed by Markdown content.
  3. Build skills OpenAI
    • load the full SKILL.md instructions when they decide to use that skill.
    • Codex reads skills from repository, user, admin, and system locations.

Quotes were checked against the live pages on 2026-11-08.