README.md
Awesome Agent Skills MCP Server
A Model Context Protocol (MCP) server that provides access to 100+ curated AI agent skills from the VoltAgent Awesome Agent Skills collection.
Transform your AI assistants into specialized experts with skills from Anthropic, Vercel, Trail of Bits, Hugging Face, Stripe, Expo, and many more leading organizations.
🚀 Quick Start
npx awesome-agent-skills-mcp
That's it! Add to your MCP client config and start using 100+ AI skills.
Features
- 100+ Curated Skills - Access skills from top organizations including Anthropic, Vercel, Trail of Bits, Hugging Face, and more
- Auto-Sync - Automatically fetches and updates skills from the VoltAgent repository
- MCP 2024-11-05 Compliant - Full compatibility with the latest Model Context Protocol specification
- Multi-Client Support - Works with Claude, GitHub Copilot, OpenCode, and any MCP-compatible client
- Smart Caching - Efficient JSON-based caching for fast startup times
- Type-Safe - Built with TypeScript and Zod for runtime validation
- Zero Configuration - Works out of the box with sensible defaults
Quick Start
Using npx (Recommended)
npx awesome-agent-skills-mcp
Global Installation
npm install -g awesome-agent-skills-mcp
awesome-agent-skills-mcp
Installation
Prerequisites
- Node.js >= 20.0.0
- npm or yarn
From npm
npm install awesome-agent-skills-mcp
From Source
git clone https://github.com/shadowrootdev/awesome-agent-skills-mcp.git
cd awesome-agent-skills-mcp
npm install
npm run build
Configuration
VS Code / GitHub Copilot
Create or update .vscode/mcp.json in your project:
{
"servers": {
"awesome-agent-skills": {
"command": "npx",
"args": ["awesome-agent-skills-mcp"]
}
}
}
Or with a local installation:
{
"servers": {
"awesome-agent-skills": {
"command": "node",
"args": ["/path/to/awesome-agent-skills-mcp/dist/index.js"]
}
}
}
Important: After adding the configuration, fully quit VS Code (Cmd+Q / Alt+F4) and reopen it for changes to take effect.
Claude Desktop
Add to your Claude Desktop configuration (~/Library/Application Support/Claude/claude_desktop_config.json on macOS):
{
"mcpServers": {
"awesome-agent-skills": {
"command": "npx",
"args": ["awesome-agent-skills-mcp"]
}
}
}
OpenCode
Add to ~/.config/opencode/opencode.json:
{
"mcp": {
"awesome-agent-skills": {
"type": "local",
"command": ["npx", "awesome-agent-skills-mcp"],
"enabled": true
}
}
}
Environment Variables
| Variable | Default | Description |
|---|---|---|
SKILLS_REPO_URL |
`https://github.com/VoltAgent/awesome-agent-s |
Tools 2
list_skillsLists all available AI agent skills from the curated collection.get_skillRetrieves the details and implementation of a specific AI agent skill.Environment Variables
SKILLS_REPO_URLThe URL of the repository to fetch skills from.Try it
→List all available AI agent skills currently provided by the server.
→Show me the details for the document processing skill.
→Can you find a skill that helps with security analysis?
→What skills are available from Anthropic or Vercel?