Updated
What are agent skills?
What are agent skills?
An agent skill is a small, self-contained package of instructions — plus optional scripts and reference files — that teaches an AI agent how to do one repeatable job well. Instead of pasting the same long prompt every time, you install the skill once and let the agent load it when the task comes up.
What's inside a skill
A skill is a folder, and at minimum it contains one file called SKILL.md. That file has two parts: a short YAML frontmatter block that names and describes the skill, and a Markdown body with the actual instructions.
---
name: code-review-checklist
description: Review a pull request against a fixed checklist before approval. Use whenever the agent is asked to review code.
---
The body is free-form. For a code-review skill it might be a checklist; for a writing skill it might be style rules. Larger skills also ship optional folders: scripts/ for executable code, references/ for detail the agent loads only when needed, and assets/ for templates and data files.
How a skill differs from a prompt
A prompt is a one-off message. A skill is a reusable asset.
- Loaded on demand. The agent reads the skill's
descriptionat startup, then opens the full instructions only when the task matches. - Versioned and shareable. A skill lives in a folder, so you can review it, improve it, and hand it to a teammate or another agent.
- Self-contained. Scripts, templates, and reference docs travel with the instructions, so the skill works the same everywhere.
- Portable. A skill written to the open Agent Skills standard runs on any runtime that implements the spec, not just one vendor's tool.
Why the standard matters
Before the Agent Skills standard, every tool had its own way of packaging instructions. A checklist you tuned for one agent had to be rebuilt for the next. The standard fixes that: one SKILL.md, one folder layout, and any compliant runtime can use it.
For a solo builder, that means you don't lose your hard-won workflows when you switch tools. For a team, it means the same vetted process runs for everyone, whatever agent they happen to use.
Where to go next
If you're new here, the next step is to install one and watch it work. Our guide on how to install a skill walks through it, and the getting started tag collects everything for first-time readers.