Agent Skills are one of the most practical ways to get more out of AI tools like Claude. They’re reusable, shareable, and surprisingly simple to create.
If you’ve ever found yourself giving Claude the same instructions repeatedly—“follow our brand voice”, “use this SEO checklist”, “format the output this way”—skills solve that problem.
What Are Agent Skills?
Skills are folders containing instructions, scripts, and resources that AI agents load when needed. Think of them as onboarding guides for specific tasks—they transform a general-purpose assistant into a specialist.
As Anthropic explains: “Skills are reusable capabilities for AI agents. Install them with a single command to enhance your agents with access to procedural knowledge.”
The core component is a SKILL.md file containing instructions in Markdown, with optional scripts and reference files. Claude scans available skills at startup and loads the relevant ones based on your request—no manual selection required.
Why Skills Matter
Simon Willison calls skills potentially more significant than MCP (Model Context Protocol). His reasoning: “The simplicity is the point.”
Where MCP requires extensive token consumption and complex protocol specifications, skills remain lightweight. They’re just folders of Markdown files and optional scripts. You can create sophisticated automation using nothing more than text files.
The key benefits:
- Specialise Claude — Tailor capabilities for domain-specific tasks
- Reduce repetition — Create once, use automatically
- Compose capabilities — Combine skills to build complex workflows
- Share knowledge — Package expertise for your team or the community
When Skills Were Introduced
Anthropic launched Agent Skills on October 16, 2025, with a major update in December adding organisation-wide management and a partner directory.
Since then, adoption has been rapid. The open skills ecosystem now hosts over 37,000 skills across platforms including Claude Code, GitHub Copilot, Cursor, and more.
Recent updates in Claude Code 2.1 (January 2026) added hot reload for skills, forked sub-agent context, and progress indicators—making it easier than ever to create and iterate on custom skills.
The Open Skills Ecosystem
Skills work across multiple AI platforms, not just Claude. The Agent Skills standard ensures portability, so skills you create can work with different tools.
Where to Find Skills
1. Anthropic’s Official Repository — The official source for Anthropic-maintained skills, including document creation (DOCX, PDF, PPTX, XLSX) and example skills for creative, technical, and enterprise workflows.
2. Skills.sh — The largest community directory with 37,000+ skills. Built by Vercel, it tracks popularity and makes discovery easy.
3. GitHub Community Skills — Curated lists of community-contributed skills.
When choosing skills, prefer official sources first. Treat community skills like open-source code—audit before you use, especially for anything touching sensitive data.
How to Find Skills
The easiest way is to use the find-skills skill itself:
npx skills find [query]
Or browse skills.sh to see what’s trending and filter by category.
Top Skills for Marketers
Here are five skills worth installing:
1. SEO Audit
seo-audit provides comprehensive search engine optimisation analysis across crawlability, technical foundations, on-page optimisation, content quality, and authority.
npx skills add https://github.com/coreyhaines31/marketingskills --skill seo-audit
It generates structured audit reports with prioritised action plans—critical fixes, high-impact improvements, and quick wins.
2. Copywriting
copywriting is a conversion copywriting framework for creating marketing copy that’s clear, compelling, and drives action.
npx skills add https://github.com/coreyhaines31/marketingskills --skill copywriting
The skill emphasises clarity over cleverness, benefits over features, and customer language over company jargon.
3. Web Design Guidelines
web-design-guidelines reviews files for compliance with web interface standards—useful for landing pages and marketing sites.
npx skills add https://github.com/vercel-labs/agent-skills --skill web-design-guidelines
4. Remotion Best Practices
remotion-best-practices provides domain knowledge for creating videos programmatically with Remotion—useful for marketing teams creating video content at scale.
npx skills add https://github.com/remotion-dev/skills --skill remotion-best-practices
5. Find Skills
find-skills helps you discover and install new skills from the ecosystem. Meta, but essential.
npx skills add https://github.com/vercel-labs/skills --skill find-skills
How to Create a Skill
Creating a skill is straightforward. Every skill requires a SKILL.md file with YAML frontmatter:
---
name: your-skill-name
description: Brief description of what this skill does and when to use it
---
# Your Skill Name
## Instructions
[Clear, step-by-step guidance for Claude to follow]
## Examples
[Concrete examples of using this skill]
The skill-creator skill from Anthropic can help you build new skills:
npx skills add https://github.com/anthropics/skills --skill skill-creator
It walks you through a six-step process: understand with examples, plan contents, initialise, edit, package, and iterate.
For detailed guidance, see Anthropic’s documentation on creating custom skills.
Skill Structure
A typical skill folder looks like this:
my-skill/
├── SKILL.md # Main instructions (required)
├── REFERENCE.md # Additional documentation
└── scripts/
└── validate.py # Utility scripts
Skills load progressively:
- Metadata (always loaded) — Just the name and description, so Claude knows when to use it
- Instructions (when triggered) — The full SKILL.md content
- Resources (as needed) — Additional files and scripts, only when referenced
This means you can bundle extensive resources without consuming tokens until they’re actually needed.
Security Considerations
Anthropic recommends using skills only from trusted sources—those you created yourself or obtained from official repositories.
Skills provide Claude with new capabilities through instructions and code. A malicious skill could direct Claude to invoke tools or execute code in harmful ways.
If using community skills:
- Audit all files thoroughly before installing
- Be cautious of skills that fetch external data
- Treat like installing any third-party software
Getting Started
- Install a skill — Try one of the marketing skills above
- Use it naturally — Just describe what you want; Claude will load the relevant skill automatically
- Create your own — Package your most common workflows as skills
Skills are the practical way to capture institutional knowledge and share it with your team—or the broader community.
Resources
- What are Skills? — Anthropic’s introduction
- Equipping Agents for the Real World — Engineering deep-dive
- Agent Skills Documentation — Official docs
- Simon Willison on Claude Skills — Independent perspective
- Skills.sh — Community directory
- Anthropic Skills Repository — Official examples