
A practical guide to installing agent skills using official methods, community tools, and emerging standards.
Agent skills are modular capabilities that extend what AI agents can do. Think of them as plugins or extensions that give agents specialized knowledge and workflows. Installing skills correctly ensures your agents work effectively across different environments.
Anthropic provides several ways to install skills depending on your workflow.
Upload skill packages directly through the web interface:
.zip fileSkills are filesystem-based and can be installed in two locations:
~/.claude/skills/ - Available across all projects.claude/skills/ - Scoped to a specific projectSimply place your skill directory in either location. Claude Code automatically discovers and loads skills on startup.
For programmatic installation, use the skills endpoints:
# Upload a skill
curl -X POST https://api.anthropic.com/v1/skills \
-H "x-api-key: $ANTHROPIC_API_KEY" \
-F "file=@my-skill.zip"
When building with the Agent SDK, place skills in the .claude/skills/ directory of your project. The SDK loads them automatically when initializing an agent.
The community has built tooling to simplify skill installation. skills.sh provides a one-command installation experience:
npx skills add owner/repo
This approach offers several benefits:
Example:
npx skills add anthropics/claude-code-example-skill
Cloudflare has proposed a standardized discovery mechanism using the well-known URI pattern:
/.well-known/skills/
This RFC suggests that skill providers host a manifest at a predictable URL, enabling:
While still emerging, this standard could simplify how agents discover and install skills across the web.
Skills become more powerful when combined with MCP (Model Context Protocol) servers. A skill can define workflows that leverage MCP tools, creating enhanced capabilities:
This combination of declarative skills and executable tools unlocks sophisticated agent workflows.
Installing agent skills is straightforward with multiple options available:
| Method | Best For |
|---|---|
| Claude.ai upload | Quick testing and personal use |
Filesystem (~/.claude/skills/) | Local development |
| Claude API | Automated deployments |
npx skills add | Cross-platform installation |
| Well-known URI | Future-proof discovery |
Choose the method that fits your workflow, and your agents will gain new capabilities instantly.
Join the community
Subscribe to our newsletter for the latest news and updates