What are Agent Skills?

2 min read Updated

Agent Skills are reusable packages of instructions, and optionally scripts and reference files, that extend what an AI agent can do without modifying its code or model. In the format popularised by Anthropic, a skill is a folder containing a SKILL.md file with YAML frontmatter (name and description) followed by the instructions an agent loads when a task matches.

WHY IT MATTERS

Skills solve a distribution problem: how to give an agent procedural knowledge — house style, a deployment runbook, a document format — without retraining a model, rewriting a system prompt, or building a new integration. A skill is just files, so it can be versioned, reviewed, and shared like any other artefact.

The format relies on progressive disclosure. At startup the agent pre-loads only each skill's name and description; the full SKILL.md body, and any bundled references or scripts, are read into context only when a task actually matches. That keeps dozens of installed skills cheap until one is needed.

Skills complement rather than replace MCP tools. Tools give an agent capabilities — API access, file operations, queries — while skills give it procedures for using those capabilities well. The two compose: a skill can instruct an agent on which tools to call and in what order. Because skills can also bundle executable scripts, they carry a supply-chain consideration similar to installing any third-party code: teams should review skills from external sources before adoption, the same way they vet an MCP server.

Running agents against MCP servers? Route them through PolicyLayer and every tool call is checked against policy first.

PUT POLICY ON YOUR TOOL CALLS →

Enforced before the call runs. Nothing to install.

HOW POLICYLAYER USES THIS

Skills shape how an agent decides to act; PolicyLayer governs what happens when it does. A skill may instruct an agent to call particular MCP tools, but when that traffic routes through the PolicyLayer gateway, each tools/call is still evaluated against deterministic policy — so a misjudged or malicious instruction package cannot reach tools the calling identity was never granted.

FREQUENTLY ASKED QUESTIONS

What goes in a SKILL.md file?
YAML frontmatter with at least a name and description, followed by the instructions themselves. The folder can also bundle scripts, templates, and reference documents the agent loads as needed.
How are Agent Skills different from MCP tools?
MCP tools provide capabilities — concrete operations an agent can invoke. Skills provide procedural knowledge: instructions for how and when to use capabilities. Skills are loaded as context; tools are called over a protocol.
Are Agent Skills specific to Claude?
Anthropic introduced the format and uses it across Claude Code and the Claude apps, but the SKILL.md structure is published as an open format that other agent products can adopt.

FURTHER READING

Let agents act without letting them run wild.

Route your MCP servers through PolicyLayer and every tool call is checked against your policy before it runs — allow, deny, or require approval. Per-identity grants. Full audit log. Live in minutes.

Free to start. No card required.

43,000+ MCP servers and 220,000+ tools scanned and risk-classified.

// GET IN TOUCH

Have a question or want to learn more? Send us a message.

Message sent.

We'll get back to you soon.