/ Directory / Playground / Anthropic Skills (Official)
● Official anthropics ⚡ Instant

Anthropic Skills (Official)

by anthropics · anthropics/skills

Anthropic's official reference skill collection — canonical examples for SKILL.md format and best practices.

anthropics/skills is the official reference repo for the SKILL.md format. Contains canonical examples (e.g., document-handling, web-design, slash-creator), reference patterns for skill structure, and best-practice templates. Treat this as the source of truth when building your own skills.

Why use it

Key features

Live Demo

What it looks like in practice

ready

Install

Pick your client

~/Library/Application Support/Claude/claude_desktop_config.json  · Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "anthropic-skills-official": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/anthropics/skills",
        "~/.claude/skills/anthropic"
      ],
      "_inferred": true
    }
  }
}

Open Claude Desktop → Settings → Developer → Edit Config. Restart after saving.

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "anthropic-skills-official": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/anthropics/skills",
        "~/.claude/skills/anthropic"
      ],
      "_inferred": true
    }
  }
}

Cursor uses the same mcpServers schema as Claude Desktop. Project config wins over global.

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "anthropic-skills-official": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/anthropics/skills",
        "~/.claude/skills/anthropic"
      ],
      "_inferred": true
    }
  }
}

Click the MCP Servers icon in the Cline sidebar, then "Edit Configuration".

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "anthropic-skills-official": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/anthropics/skills",
        "~/.claude/skills/anthropic"
      ],
      "_inferred": true
    }
  }
}

Same shape as Claude Desktop. Restart Windsurf to pick up changes.

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "anthropic-skills-official",
      "command": "git",
      "args": [
        "clone",
        "https://github.com/anthropics/skills",
        "~/.claude/skills/anthropic"
      ]
    }
  ]
}

Continue uses an array of server objects rather than a map.

~/.config/zed/settings.json
{
  "context_servers": {
    "anthropic-skills-official": {
      "command": {
        "path": "git",
        "args": [
          "clone",
          "https://github.com/anthropics/skills",
          "~/.claude/skills/anthropic"
        ]
      }
    }
  }
}

Add to context_servers. Zed hot-reloads on save.

claude mcp add anthropic-skills-official -- git clone https://github.com/anthropics/skills ~/.claude/skills/anthropic

One-liner. Verify with claude mcp list. Remove with claude mcp remove.

Use Cases

Real-world ways to use Anthropic Skills (Official)

Learn the SKILL.md format by reading the canonical examples

👤 Devs about to write their first skill ⏱ ~30 min beginner

When to use: You want a polished example, not a guess.

Flow
  1. Pick a reference skill
    Use anthropics/skills. Show me the document-handling skill in full. Walk me through its structure.✓ Copied
    → SKILL.md fields explained — name, description, instructions, resources
  2. Map to my domain
    Adapt the structure to my domain (e.g. database-migrations). Show me the SKILL.md skeleton.✓ Copied
    → Domain-mapped skeleton
  3. Test trigger
    Add the new skill to ~/.claude/skills. Verify it triggers on the right prompts.✓ Copied
    → Skill activates correctly

Outcome: Your first skill, structured the way Anthropic recommends.

Pitfalls
  • Vague description = false triggers — Make description specific to triggering signals; less is more

Use Anthropic's document-handling skill for PDF/DOCX work

👤 Anyone with document workflows ⏱ ~15 min beginner

When to use: You want a skill maintained by Anthropic, not a community fork.

Flow
  1. Install
    Clone anthropics/skills into ~/.claude/skills/anthropic.✓ Copied
    → Skill discoverable
  2. Trigger naturally
    I have a 200-page PDF I need to summarize and extract tables from. Help.✓ Copied
    → Doc-handling skill kicks in with structured approach

Outcome: Document workflow handled by official skill.

Combine with: markitdown-mcp

Use as a template for internal team skills

👤 Platform/DX teams standardizing AI workflows ⏱ ~60 min intermediate

When to use: You want everyone on the team to write skills the same way.

Flow
  1. Fork and customize
    Fork anthropics/skills. Add an internal skill following the same structure for our deploy process.✓ Copied
    → Forked repo with new skill matching style
  2. Distribute
    Document the install path so the team can clone uniformly.✓ Copied
    → Internal docs ready

Outcome: Skill standard for your org rooted in the official one.

Combinations

Pair with other MCPs for X10 leverage

anthropic-skills-official + markitdown-mcp

Doc-handling skill + MarkItDown MCP for end-to-end docs

Use the doc-handling skill from anthropics/skills, with markitdown MCP to convert input PDFs.✓ Copied
anthropic-skills-official + wshobson-skills-skill

Stack official + community skills

Anthropics for baseline, wshobson for breadth.✓ Copied

Tools

What this MCP exposes

ToolInputsWhen to callCost
(reference skill bundle) trigger via natural language Auto-triggered by Claude when prompt matches description 0

Cost & Limits

What this costs to run

API quota
N/A
Tokens per call
Skills load on-trigger; idle cost is zero
Monetary
Free (Apache 2.0)
Tip
Use only the skills your team actually needs; remove unused ones to keep trigger surface clean

Security

Permissions, secrets, blast radius

Minimum scopes: filesystem-read
Credential storage: None
Data egress: None

Troubleshooting

Common errors and fixes

Skill conflicts with custom one

Skill names must be unique; rename or namespace your custom skill

Skill doesn't trigger

Description matters — it's how Claude decides when to load. Match user intent words.

Alternatives

Anthropic Skills (Official) vs others

AlternativeWhen to use it insteadTradeoff
wshobson/skillsYou want broader community-maintained coverageLess canonical; more variety
obra/superpowersSmaller curated set with strong opinionsDifferent curator's lens

More

Resources

📖 Read the official README on GitHub

🐙 Browse open issues

🔍 Browse all 400+ MCP servers and Skills