Concept Library
Building with Claude

What are Agent Skills?

Illustration of Agent Skills: reusable packages of instructions an AI agent loads on demand to perform a specific task well.

Agent Skills are reusable packages of know-how that an AI agent loads only when it needs them. A Skill is essentially a folder containing instructions, and often scripts and reference files, that teaches an agent how to do one specific task well. Instead of re-explaining a process every time, you package it once as a Skill, and the agent picks it up whenever that task comes up.

Introduced by Anthropic in late 2025, Skills are a practical answer to a real problem in getting agents to behave consistently, and the idea is simple enough to grasp in a sentence: a folder that teaches an agent one thing, loaded on demand.

The problem it solves

Prompts alone do not make an agent behave consistently in production. If your organization has a specific way of doing something, formatting a report, handling a type of document, following brand guidelines, you would otherwise have to explain it in the prompt every single time, and behavior still drifts from run to run.

Skills solve this by capturing that know-how once, in a reusable form the agent can load automatically. It is the difference between re-briefing a new hire on the same procedure every morning and handing them a written guide they keep and never forget. The knowledge stops living in one-off prompts and becomes a durable, shareable capability.

How it works

The design is deliberately simple, and one clever detail makes it efficient.

A Skill is a folder with instructions. At its core is a file of organized instructions describing how a capability should behave and when to use it, alongside any scripts or resources it needs. That folder is the Skill, and it can be versioned, shared, and reused like any other file.

The agent loads it only when relevant. Claude discovers available Skills and invokes the right one when a task calls for it, either automatically or on request. When a Skill is not relevant, it is ignored, so a large library of Skills does not clutter every interaction.

Progressive disclosure keeps it efficient. This is the key mechanism: rather than loading every Skill’s full instructions all the time, the agent initially sees only their names and descriptions, and pulls in a Skill’s full contents only when it decides to use it. That keeps the context lean while still giving the agent access to many capabilities, a direct application of good context management.

Like MCP, Skills began at Anthropic but the format was made open, so the same Skill can work across different agents and tools rather than being locked to one product. They work across Claude’s surfaces, the chat interface, Claude Code, and the API, and complement other mechanisms: where MCP gives an agent access to external tools, a Skill gives it procedural know-how for a task.

A concrete example

Suppose a company always produces its financial reports in a very particular format, with specific sections, rules, and calculations.

Without Skills, someone has to describe that entire format in the prompt every time a report is generated, and small variations creep in. With a Skill, the format is captured once as a folder of instructions. From then on, when someone asks for a financial report, Claude loads that Skill and follows the packaged process, producing consistent output without anyone re-explaining it. The institutional knowledge became an automatic, repeatable capability.

How it connects

Agent Skills extend what an agent can do reliably, and they are a form of packaged, reusable prompt know-how loaded through smart context management via progressive disclosure. They sit alongside MCP in the toolkit for building capable agents: MCP connects an agent to tools and data, while Skills give it procedural expertise.

For the building roles, Skills are a practical technique. An AI/LLM Developer packages and maintains them, and an AI Solutions Architect decides how an organization’s repeatable know-how should be captured so agents apply it consistently.