Skills
Anthropic Agent Skills
Anthropic’s public skill repository, useful as a reference for how SKILL.md is written.
Anthropic’s public Agent Skills repository. A skill is usually a SKILL.md plus optional scripts and reference files, so an agent that understands the format follows the same procedure for a class of tasks instead of being re-briefed in every chat.
Read the repository introduction and one example’s trigger conditions before copying anything into your own skill directory. No SPDX license was detected, so this page does not reproduce the skill text.
This page is a guide, not the original text.
What problem it solves
anthropics/skills is Anthropic’s public skill repository. A skill is a folder with a SKILL.md file, and it can also hold scripts and reference files. The agent reads each skill’s name and description up front, then loads the body only when a task matches. That is how you turn a repeatable procedure — applying a house style to a document, or running a team checklist — into something Claude can reuse.
The repo ships example skills and also the docx, pdf, pptx, and xlsx skills that sit behind Claude’s document features, so you can see how a more complex SKILL.md is put together. It also points at the Agent Skills standard on agentskills.io. The README is explicit: these skills are for demonstration and education, behavior in the Claude product may differ, and you should test anything important in your own environment first.
Who it is for
It is for people who already use Claude Code and want official examples, the document skills, or a pattern for writing their own SKILL.md. The README says the example skills in this repository are already available on paid Claude.ai plans. You can also use Anthropic’s pre-built skills, or upload custom ones, through the Claude API, following official docs. In Claude Code, custom skills are just files on disk; you do not have to upload them first.
You still need access to the product that will run the skill. Claude Code itself requires a supported paid or Console plan, and it follows Anthropic’s supported-regions policy; see the Claude Code entry for that. This page does not repeat the login walkthrough.
How to install it
Checked on 15 November 2026 (Asia/Shanghai) against the repository README and official skill docs.
In Claude Code, register the repo as a plugin marketplace:
/plugin marketplace add anthropics/skillsYou can then pick anthropic-agent-skills in the UI and install document-skills or example-skills. You can also install either plugin directly:
/plugin install document-skills@anthropic-agent-skills
/plugin install example-skills@anthropic-agent-skillsAfter that, mention the skill in plain language. The official example, once document-skills is installed, is: “Use the PDF skill to extract the form fields from path/to/some-file.pdf.”
To write your own skill, you do not need the marketplace. Create a folder and a SKILL.md in your personal skills directory:
mkdir -p ~/.claude/skills/my-skill-nameOfficial docs start SKILL.md with YAML frontmatter:
---
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]name and description are required. name should use lowercase letters, numbers, and hyphens, and it should match the folder name. Project skills belong in .claude/skills/ so you can commit them. Platform docs also note that the pre-built document skills are not bundled with Claude Code. If you want PDF or Word skills there, install the document-skills plugin above; do not assume they are already present.
A worked example
This walkthrough uses the official README prompt. It was not run against a real PDF in this review, so the page does not invent a list of form fields.
- In Claude Code, add the marketplace and install
document-skills@anthropic-agent-skills. - Use a PDF you are allowed to open, and put its real path in the prompt.
- Send:
Use the PDF skill to extract the form fields from path/to/some-file.pdf. Official docs say that naming the skill should cause Claude to load the PDF skill and try to extract the fields. - Check the result yourself. The README warning still applies: the sample implementation may not match what the product does, so treat one output as a draft, not as final data.
Common pitfalls
- Treating the repo as a guaranteed production feature. The README disclaimer says the skills are for demonstration and education, and that Claude’s implementation may differ. Test in your own environment first.
- Overlapping plugins. Issue #189 reports that
document-skillsandexample-skillscan install the same content and leave you with duplicate skills. If you see two copies, check whether both plugins are installed. - Marketplace install failures. Issue #14 reported an error when adding
anthropics/skillsfrom the CLI. Check official plugin troubleshooting, or copy the skill folder into~/.claude/skills/instead. - Installed but not loaded. Issue #67 describes Claude Code missing skills after a marketplace install when the expected
skills/layout is absent. Issue #1943 reports “conflicting manifests” after a Claude Desktop marketplace refresh. Those issues may still be open; match the current error against official troubleshooting. - The repo copy of the document skills can lag Claude.ai. Issue #2104 reported that the docx, pptx, and xlsx copies were months behind. When you need current behavior, prefer the in-product skill and official docs.
FAQ
Do I have to upload a skill first?
Not in Claude Code. Put the folder in ~/.claude/skills/ or in the project’s .claude/skills/ directory. Uploading, or using pre-built skills, is for Claude.ai or the API, following official docs.
What is the minimum SKILL.md?
Official docs require name and description in the YAML frontmatter. The description is what Claude uses to decide when to load the skill, so say what it does and when to use it. Put the actual steps in the body.
What license are these skills under?
The README says many skills in the repository, including the document skills, are open source under Apache 2.0. This review did not find a root LICENSE file; treat the README and any license notes inside each skill folder as authoritative.
How is this different from CLAUDE.md?
CLAUDE.md loads at the start of every session and is meant for standing project rules. A skill loads on demand and is meant for a full procedure. Official docs suggest moving a CLAUDE.md section into a skill once it has become a process rather than a fact.
Does Claude Code already include PDF and Word skills?
Platform docs say the pre-built document skills are not bundled with Claude Code. Install the document-skills plugin from this repository, or copy the skill folders yourself.
Sources and license
This page follows the anthropics/skills README as of 15 November 2026, plus the official Agent Skills overview, Claude Code skills, and how-to pages, rewritten for CQBase — Context & Query Base. If the install commands or license notes change, follow the repository and official docs.
In this category
- Skills
Superpowers
Jesse Vincent’s skill framework: plan, write tests, then let the agent change code.
obra - Skills
Addy Osmani’s agent skills
Engineering skills for coding agents, aimed at code you can keep rather than a one-shot generation.
addyosmani - Skills
Impeccable
A design vocabulary for coding agents, so feedback can be specific instead of “make it nicer.”
pbakaus