What Are Agent Skills?

Agent Skills are portable folders that extend AI agents with specialized knowledge and workflows. Each skill contains a SKILL.md file with YAML frontmatter (name, description) and markdown instructions.

How discovery works

Agents use **progressive disclosure**: at startup they load only skill names and descriptions. When a task matches, they read the full SKILL.md. Optional scripts/, references/, and assets/ directories provide on-demand resources.

Directory structure

my-skill/
├── SKILL.md          # Required
├── scripts/          # Optional executable code
├── references/       # Optional documentation
└── assets/           # Optional templates and data

Supported platforms

Cursor, Claude Code, GitHub Copilot, Windsurf, Codex CLI, and any agentskills.io-compatible agent.