Skip to content
BENIBIX Learn

Agent Skill

AI🤖 AI AgentsAgent Abilities

Also known as Agent Skills, SKILL.md, Skill (AI Agent)

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

Think of it like

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

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.

Why it matters

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

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 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.
Only the short notes are loaded at first. The agent opens a full skill when a task needs it.

Common mistake

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

Key takeaways

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

Compare