How to Install Agent Skills

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.

Official Methods (Claude Platform)

Anthropic provides several ways to install skills depending on your workflow.

Claude.ai

Upload skill packages directly through the web interface:

1. Navigate to Settings > Features
2. Upload your skill as a .zip file
3. The skill becomes available immediately in your conversations

Claude Code

Skills are filesystem-based and can be installed in two locations:

• Global skills: ~/.claude/skills/ - Available across all projects
• Project skills: .claude/skills/ - Scoped to a specific project

Simply place your skill directory in either location. Claude Code automatically discovers and loads skills on startup.

Claude API

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"

Claude Agent SDK

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.

Community Tools: Vercel's npx Command

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:

• One-command installation - No manual downloading or file management
• Cross-platform support - Works with 20+ AI agents including Claude, Cursor, Windsurf, and others
• Version management - Install specific versions of skills

Example:

npx skills add anthropics/claude-code-example-skill

Emerging Standards: Cloudflare's Well-Known URI RFC

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:

• Universal discovery - Agents can automatically find skills from any domain
• Progressive disclosure - Expose skill capabilities in stages
• Decentralized distribution - No central registry required

While still emerging, this standard could simplify how agents discover and install skills across the web.

Bonus: Skills + MCP Integration

Skills become more powerful when combined with MCP (Model Context Protocol) servers. A skill can define workflows that leverage MCP tools, creating enhanced capabilities:

• A "code review" skill can use MCP tools for Git operations
• A "deployment" skill can connect to cloud provider MCP servers
• A "data analysis" skill can query databases through MCP

This combination of declarative skills and executable tools unlocks sophisticated agent workflows.

Summary

Installing agent skills is straightforward with multiple options available:

Choose the method that fits your workflow, and your agents will gain new capabilities instantly.