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.

Table of Contents

• Features
• Quick Start
• Installation
• Configuration
  • VS Code / GitHub Copilot
  • Claude Desktop
  • OpenCode
• Available Skills
• MCP Tools
• Usage Examples
• Development
• API Reference
• Troubleshooting
• Credits
• License

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

Available Skills

The server provides access to 100+ skills from leading organizations:

Anthropic

Document processing, presentation creation, spreadsheet manipulation, PDF handling, algorithmic art, MCP building, and more.

Vercel

React and Next.js best practices, deployment, and performance optimization.

Trail of Bits

Security analysis, smart contract auditing, and code review tools.

Hugging Face

ML model training, dataset management, and Hub operations.

Sentry

Code review, commit conventions, and PR automation.

And Many More...

• Stripe - Payment integration best practices
• Expo - React Native app development
• n8n - Workflow automation patterns
• Sanity - CMS best practices
• Neon - Serverless Postgres
• Remotion - Programmatic video creation

MCP Tools

The server exposes four MCP tools:

list_skills

List all available skills with optional filtering.

// List all skills
{ }

// Filter by source
{ "source": "repository" }

// Filter by tag
{ "tag": "security" }

get_skill

Get detailed information about a specific skill.

{ "skill_id": "react-best-practices" }

invoke_skill

Invoke a skill with optional parameters.

{
  "skill_id": "docx",
  "parameters": {
    "document_type": "report"
  }
}

refresh_skills

Manually trigger a skills refresh from the repository.

{ }

Usage Examples

In GitHub Copilot Chat

@workspace Use the react-best-practices skill to review my React components

@workspace List all available security-related skills

@workspace Get the stripe-best-practices skill and apply it to my checkout code

In Claude

What skills are available for Next.js development?

Use the code-review skill to analyze my pull request

Development

Setup

git clone https://github.com/shadowrootdev/awesome-agent-skills-mcp.git
cd awesome-agent-skills-mcp
npm install

Build

npm run build

Run Tests

# Run all tests
npm test

# Run tests in watch mode
npm run test:watch

# Run integration tests only
npm run test:integration

Lint & Format

npm run lint
npm run format

Project Structure

awesome-agent-skills-mcp/
├── src/
│   ├── index.ts              # Entry point
│   ├── server.ts             # MCP server implementation
│   ├── config.ts             # Configuration management
│   ├── models/
│   │   ├── skill.ts          # Skill type definitions
│   │   ├── parameter.ts      # Parameter schemas
│   │   ├── registry.ts       # SkillRegistry class
│   │   └── repository.ts     # Repository source model
│   ├── services/
│   │   ├── git-sync.ts       # Git repository sync
│   │   ├── skill-parser.ts   # Skill parsing from README
│   │   └── skill-executor.ts # Skill invocation
│   ├── cache/
│   │   └── cache-manager.ts  # JSON-based caching
│   └── utils/
│       └── logger.ts         # Structured logging
├── tests/
│   ├── unit/                 # Unit tests
│   └── integration/          # Integration tests
├── dist/                     # Compiled output
└── .cache/                   # Runtime cache (gitignored)