# Agent Skill

> A folder of steps that an agent reads when a task needs it.

**Field:** Artificial Intelligence  
**Category:** AI Agents  
**Also known as:** Agent Skills, SKILL.md, Skill (AI Agent)

## Think of it like

Think of it like a recipe book on a shelf. You only open the page you need.

## Definition

An agent skill is a folder of instructions, and sometimes scripts, that teaches an agent how to do one kind of task. Its main file starts with a name and a one-line note on when to use it. The agent sees only those short notes at first, so many skills cost little context. When a task matches a note, the agent loads the full instructions. Skills let teams package their own know-how once and reuse it in every task.

## Example

Jack's team writes a skill for their release steps. When he asks the agent to ship a release, it loads the skill and follows the team's steps exactly.

## Example code

```markdown
---
name: release-notes
description: Write release notes from the merged changes. Use when the user asks for release notes.
---

1. List the changes merged since the last tag.
2. Group them as Added, Fixed and Removed.
3. Write one plain line for each change.
```

The name and description are all the agent sees until a task matches. Then it reads the steps.

## Why it matters

It keeps the context small and still gives the agent deep know-how on demand.

## Common mistake

Writing a vague description. The agent picks skills by their description, so a fuzzy one is never loaded.

## Three principles

- **One task each.** A folder per skill.
- **Short note first.** Full text on demand.
- **Write once, reuse.** In every task.

## Related terms

- [Agent Instruction File](https://learn.benibix.com/term/ai/agent-instruction-file)
- [Context Engineering](https://learn.benibix.com/term/ai/context-engineering)
- [AI Agent](https://learn.benibix.com/term/ai/ai-agent)
- [Claude Code Skill](https://learn.benibix.com/term/ai/claude-code-skill)

## Told apart from

- [Agent Skill vs Agent Instruction File](https://learn.benibix.com/compare/agent-skill-vs-agent-instruction-file): People think a skill is just another instruction file, and it is not. An instruction file, such as AGENTS.md, is read on every run, so it costs space each time. A skill shows only its name and a short note until a task needs it. Then the agent loads the full steps. Rules that always apply go in the file. Steps for one kind of job go in a skill.

![A shelf of skill folders, each with only a name and a one-line note showing. When a task needs one, the agent opens that folder and reads the full instructions.](https://learn.benibix.com/diagrams/ag-agent-skill.svg)

---

Source: https://learn.benibix.com/term/ai/agent-skill
Author: Behnia Zarei (a developer in Vienna, Austria, who builds and teaches data, AI and business intelligence at BENIBIX)
Publisher: BENIBIX Learn (https://learn.benibix.com/)
Last updated: 2026-11-19
Licence: CC BY 4.0 (https://creativecommons.org/licenses/by/4.0/). Quote freely with attribution.
