skills README

The project's README from github.com/anthropics/skills. As one markdown file: README.md.

Note: This repository contains Anthropic's implementation of skills for Claude. For information about the Agent Skills standard, see agentskills.io.

skills.sh

Skills

Skills are folders of instructions, scripts, and resources that Claude loads dynamically to improve performance on specialized tasks. Skills teach Claude how to complete specific tasks in a repeatable way, whether that's creating documents with your company's brand guidelines, analyzing data using your organization's specific workflows, or automating personal tasks.

For more information, check out:

About This Repository

This repository contains skills that demonstrate what's possible with Claude's skills system. These skills range from creative applications (art, music, design) to technical tasks (testing web apps, MCP server generation) to enterprise workflows (communications, branding, etc.).

Each skill is self-contained in its own folder with a SKILL.md file containing the instructions and metadata that Claude uses. Browse through these skills to get inspiration for your own skills or to understand different patterns and approaches.

Many skills in this repo are open source (Apache 2.0). We've also included the document creation & editing skills that power Claude's document capabilities under the hood in the skills/docx, skills/pdf, skills/pptx, and skills/xlsx subfolders. These are source-available, not open source, but we wanted to share these with developers as a reference for more complex skills that are actively used in a production AI application.

Disclaimer

These skills are provided for demonstration and educational purposes only. While some of these capabilities may be available in Claude, the implementations and behaviors you receive from Claude may differ from what is shown in these skills. These skills are meant to illustrate patterns and possibilities. Always test skills thoroughly in your own environment before relying on them for critical tasks.

Skill Sets

Try in Claude Code, Claude.ai, and the API

Claude Code

You can register this repository as a Claude Code Plugin marketplace by running the following command in Claude Code:

/plugin marketplace add anthropics/skills

Then, to install a specific set of skills:

  1. Select Browse and install plugins
  2. Select anthropic-agent-skills
  3. Select document-skills or example-skills
  4. Select Install now

Alternatively, directly install either Plugin via:

/plugin install document-skills@anthropic-agent-skills
/plugin install example-skills@anthropic-agent-skills

After installing the plugin, you can use the skill by just mentioning it. For instance, if you install the document-skills plugin from the marketplace, you can ask Claude Code to do something like: "Use the PDF skill to extract the form fields from path/to/some-file.pdf"

Claude.ai

These example skills are all already available to paid plans in Claude.ai.

To use any skill from this repository or upload custom skills, follow the instructions in Using skills in Claude.

Claude API

You can use Anthropic's pre-built skills, and upload custom skills, via the Claude API. See the Skills API Quickstart for more.

Creating a Basic Skill

Skills are simple to create - just a folder with a SKILL.md file containing YAML frontmatter and instructions. You can use the template-skill in this repository as a starting point:

---
name: my-skill-name
description: A clear description of what this skill does and when to use it
---

# My Skill Name

[Add your instructions here that Claude will follow when this skill is active]

## Examples
- Example usage 1
- Example usage 2

## Guidelines
- Guideline 1
- Guideline 2

The frontmatter requires only two fields:

The markdown content below contains the instructions, examples, and guidelines that Claude will follow. For more details, see How to create custom skills.

Partner Skills

Skills are a great way to teach Claude how to get better at using specific pieces of software. As we see awesome example skills from partners, we may highlight some of them here:

skills (anthropics/skills)

productivity
Searching Database…

182K ·GitHub
Skills
What is this?This is Anthropic's public repository of Agent Skills for Claude: folders of instructions, scripts, and resources that Claude loads dynamically to get better at specific tasks like document creation, data analysis, or enterprise workflows.
Is a skill a program I run, or something Claude reads?A skill is just a folder with a SKILL.md file containing YAML frontmatter (name, description) and markdown instructions that Claude follows; it's not standalone software you execute yourself.
How do I start using these skills?In Claude Code, register this repo as a plugin marketplace and install the 'document-skills' or 'example-skills' plugin, then just mention the skill in a prompt; in Claude.ai the example skills are already available on paid plans; via the API you can use pre-built skills or upload custom ones.
Do I need a paid Claude plan or API access to use these?You need either Claude Code, a paid Claude.ai plan, or the Claude API with a key, since the example skills are built into Claude.ai's paid plans and installable as plugins in Claude Code.
Will Claude behave exactly like these example skills show?No — the repo is explicitly for demonstration and education, and actual Claude behavior may differ from what the skills illustrate, so you should test thoroughly before relying on them.
Who is this repo meant for?It's aimed at developers building on Claude who want inspiration or reference patterns for writing their own Agent Skills, as well as anyone using Claude Code, Claude.ai, or the API.
How do I create my own custom skill?Copy the template-skill folder as a starting point and fill in a SKILL.md with just two required frontmatter fields, name and description, plus your instructions below.
What kinds of skills are included?They range from creative applications like art, music, and design, to technical tasks like testing web apps and MCP server generation, to enterprise workflows like communications and branding, organized under ./skills, with the spec itself in ./spec.
What is the Agent Skills spec folder for?The ./spec folder contains the formal Agent Skills specification that defines the standard skills follow, separate from Anthropic's specific implementation examples.
What are similar projects?financial-services, knowledge-work-plugins, everything-claude-code, claude-for-legal, newsjack, pstack, headcount, claude-plugins-official
Which topics is it in?specification, template, enterprise, skills, anthropic, agents, documentation, claude, agent-skills, productivity, agent, claude-code
Creator
anthropics
Size
5.6 MB
Stars
182K
Updated
CommitOct 09
Age
1y
Commits · 90 Days