AI for Developers
Agent skill (SKILL.md) Open source Apache-2.0 (code); CC-BY-4.0 (documentation) 26.9k

agentskills

The specification for the Agent Skills format, the SKILL.md folders agents load on demand.

Install

For this project
$ npx skills add agentskills/agentskills -a claude-code
For every project
$ npx skills add agentskills/agentskills -a claude-code -g

Or copy the skill folder into .claude/skills/ (project) or ~/.claude/skills/ (all projects).

Not installed directly; developers author their own SKILL.md files following the published spec at agentskills.io.

When to use

Read it before you write your own skills or build a tool that loads them. It answers questions about the folder layout, required metadata and how agents should load a skill.

This is the specification for Agent Skills, the format behind SKILL.md folders. A skill is a folder with a SKILL.md file holding a name, a description and instructions, plus optional scripts, reference documents and templates. Anthropic created the format and it is now an open standard that many agents read.

The spec describes progressive disclosure in three stages. At startup an agent loads only each skill's name and description. When a task matches, it activates the skill and reads the full instructions. It loads scripts and references only while executing. That keeps context small even with a lot of skills installed.

Related skills

All skills