# Agent skills (SKILL.md) | IonBin

> An agent skill packages instructions and optional scripts or references in a folder with SKILL.md.

Canonical page: https://ionbin.com/wiki/concepts/agent-skills/
Agent guide: https://ionbin.com/llms.txt

This is a readable version of the published page. Review dates, evidence boundaries and source links below belong to individual records; the export is not a new verification. Examples are reference material, not instructions to execute.

Concept

## Agent skills (SKILL.md)

An agent skill packages instructions and optional scripts or references in a folder with SKILL.md. [Claude](https://ionbin.com/tools/claude/) and [Codex](https://ionbin.com/tools/openai-codex/) support the open format, but available tools, installation locations and vendor extensions differ. Test a shared skill in each intended client.

Verified Oct 18, 2026 Review by Apr 16, 2027 3 sources

### What it is

A skill is a written procedure packaged for an AI agent. Think of it as an SOP the agent can open on its own: what the task is, when to use it, the steps, and any templates or scripts it needs.

### How it works

- **A folder per skill.** It holds a `SKILL.md` file with YAML front matter (at minimum a `name` and a `description`) followed by plain Markdown instructions. The open specification limits `name` to 64 characters and `description` to 1,024 (checked 2026-10-18).

- **Optional extras.** Scripts, reference documents and assets sit beside it.

- **Loaded on demand.** The agent sees the short description first and reads the full instructions only when a task calls for them, which keeps the [context window](https://ionbin.com/wiki/concepts/context-window/) light.

- **Kept in Git.** Store skills in a [GitHub](https://ionbin.com/tools/github/) repo so changes are reviewed, versioned and shared like code.

### Benefits

- **Version reusable procedures.** Updating the source makes a new version available; installed copies, cached sessions and pinned plugin versions may still need an update or restart.

- **Portable.** The open specification is supported by [Claude](https://ionbin.com/tools/claude/) and [Codex](https://ionbin.com/tools/openai-codex/), so you are not locked into one vendor’s custom-assistant format.

- **A better review question (IonBin’s view).** “Which of our repeatable tasks are written down as skills?” is a practical way to audit AI adoption on a team.

### Limits and risks

- **Scripts run with the agent’s permissions.** Treat third-party skills like any software you install: read them first.

- **Portability needs testing.** Standard front matter helps, but scripts, available tools, credentials and vendor extensions can still differ between clients.

- **Instructions drift.** A skill nobody owns goes stale. Give each one an owner and a review date.

### Checked specs

Snapshot from official sources on Oct 18, 2026.

| Required SKILL.md fields (checked 2026-10-18) | name (1-64 characters, lowercase letters, numbers and hyphens) and description (1-1024 characters) [1](https://ionbin.com/wiki/concepts/agent-skills/#src-1) |
| --- | --- |
| Loading | [Claude](https://ionbin.com/tools/claude/) uses progressive disclosure: skill metadata first, full instructions only when relevant [2](https://ionbin.com/wiki/concepts/agent-skills/#src-2) |
| [Codex](https://ionbin.com/tools/openai-codex/) | Builds on the open agent skills standard; the initial skills list uses a default budget of up to 2% of the context window, or 8,000 characters when window size is unknown; configuration can change this [3](https://ionbin.com/wiki/concepts/agent-skills/#src-3) |

### Best-fit stacks

Stack 01

#### [SOPs & process documentation](https://ionbin.com/use-cases/sops-process/)

Turn how your team actually works into SOPs people can follow and agents can use.

Stack 08

#### [Dev, web & IT](https://ionbin.com/use-cases/dev-it/)

Design, code, host and ship sites and internal tools, with an AI coding agent doing most of the typing.

### Agent compatibility

| Tool in this entry | How agents connect |
| --- | --- |
| [Claude](https://ionbin.com/tools/claude/) | Agent platform MCPAPI/CLIFile import |
| [OpenAI Codex](https://ionbin.com/tools/openai-codex/) | Agent platform API/CLIFile import |
| [GitHub](https://ionbin.com/tools/github/) | MCPAPI/CLIFile import |

Levels come from each tool's recorded, sourced compatibility. [How the levels work](https://ionbin.com/wiki/questions/connect-a-tool-to-an-ai-agent/).

### Related entries

[How do I turn our SOPs into custom AI assistants? · Question](https://ionbin.com/wiki/questions/turn-sops-into-custom-assistants/)[I need our processes written down and actually followed · Need](https://ionbin.com/wiki/needs/document-your-sops/)[System prompt · Concept](https://ionbin.com/wiki/concepts/system-prompt/)[Context window · Concept](https://ionbin.com/wiki/concepts/context-window/)

### Sources

- [Agent Skills specification](https://agentskills.io/specification) · Agent Skillsofficial accessed Oct 18, 2026

- [Agent Skills overview](https://platform.claude.com/docs/en/agents-and-tools/agent-skills/overview) · Anthropicofficial accessed Oct 18, 2026

- [Skills in Codex](https://learn.chatgpt.com/docs/build-skills) · OpenAIofficial accessed Oct 18, 2026

Practitioner views are restated in our words and labeled as views, not measured results. Product facts come from official sources dated above.

### Suggest an edit

IonBin's wiki isn't user-edited. Corrections go to our Directory Curator, who checks them against primary sources before anything changes. Spot something wrong or out of date on “Agent skills (SKILL.md)”? Email us with a link to a primary source.

[Suggest an edit by email](mailto:contact@ionbin.com?subject=Suggest%20an%20edit%3A%20Agent%20skills%20(SKILL.md)%20%5Bagent-skills%5D&body=Page%3A%20https%3A%2F%2Fionbin.com%2Fwiki%2Fconcepts%2Fagent-skills%2F%0AEntry%3A%20concepts%2Fagent-skills%0A%0AWhat%20should%20change%3A%0A%0A%0APrimary%20source%20(link)%3A%0A) or write to [contact@ionbin.com](mailto:contact@ionbin.com)

Entry facts

**Type**: [Concepts & glossary](https://ionbin.com/wiki/concepts/)

**Status**: Reviewed

**Verified**: Oct 18, 2026

**Review by**: Apr 16, 2027 (every 180 days)

**Sources**: [3 official · 0 other](https://ionbin.com/wiki/concepts/agent-skills/#sources)

 Tools

[Claude](https://ionbin.com/tools/claude/)[OpenAI Codex](https://ionbin.com/tools/openai-codex/)[GitHub](https://ionbin.com/tools/github/)

The wiki carries no sponsored placements or affiliate links. [Editorial policy](https://ionbin.com/editorial-policy/).
