io.github.shadowrootdev/awesome-agent-skills

Official

by shadowrootdev · TypeScript

MCP server with 100+ AI agent skills from Anthropic, Vercel, Trail of Bits, Hugging Face & more.

Collection of 100+ AI agent skills from leading organizations for extended agent capabilities.

Topics

agent-skillsaiai-agentai-skillsanthropicautomationawesome-listclaudedeveloper-toolsgithub-copilotllmmcpmcp-servermodel-context-protocolopencodeskillstypescriptvoltagent

README.md15 KBView on GitHub

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

bash

npx awesome-agent-skills-mcp

That's it! Add to your MCP client config and start using 100+ AI skills.

Features
Quick Start
Installation
Configuration
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)

bash

npx awesome-agent-skills-mcp

Global Installation

bash

npm install -g awesome-agent-skills-mcp
awesome-agent-skills-mcp

Installation

Prerequisites

Node.js >= 20.0.0
npm or yarn

From npm

bash

npm install awesome-agent-skills-mcp

From Source

bash

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:

json

{
  "servers": {
    "awesome-agent-skills": {
      "command": "npx",
      "args": ["awesome-agent-skills-mcp"]
    }
  }
}

Or with a local installation:

json

{
  "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):

json

{
  "mcpServers": {
    "awesome-agent-skills": {
      "command": "npx",
      "args": ["awesome-agent-skills-mcp"]
    }
  }
}

OpenCode

Add to ~/.config/opencode/opencode.json:

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-skills.git`	Skills repository URL
`SKILLS_CACHE_DIR`	`.cache`	Cache directory path
`SKILLS_SYNC_INTERVAL`	`60`	Auto-sync interval in minutes (0 to disable)
`LOG_LEVEL`	`info`	Logging level (debug, info, warn, error)

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.

Skill	Description
`docx`	Create, edit, and analyze Word documents
`pptx`	PowerPoint presentation creation and editing
`xlsx`	Spreadsheet manipulation with formulas
`pdf`	PDF processing and form filling
`mcp-builder`	Guide for creating MCP servers
`webapp-testing`	Playwright-based web app testing

Vercel

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

Skill	Description
`react-best-practices`	React performance optimization guidelines
`next-best-practices`	Next.js conventions and patterns
`web-design-guidelines`	UI/UX compliance review
`vercel-deploy`	Deploy apps to Vercel

Trail of Bits

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

Skill	Description
`building-secure-contracts`	Smart contract security toolkit
`semgrep-rule-creator`	Create custom Semgrep rules
`property-based-testing`	Property-based testing guidance
`static-analysis`	Static analysis tooling

Hugging Face

ML model training, dataset management, and Hub operations.

Skill	Description
`hugging-face-cli`	HF Hub CLI operations
`hugging-face-datasets`	Dataset creation and management
`hugging-face-model-trainer`	Model fine-tuning with TRL
`hugging-face-evaluation`	Model evaluation workflows

Sentry

Code review, commit conventions, and PR automation.

Skill	Description
`code-review`	Sentry engineering code review practices
`commit`	Conventional commit messages
`create-pr`	PR creation following Sentry conventions
`find-bugs`	Bug and vulnerability detection

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.

typescript

// List all skills
{ }

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

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

`get_skill`

Get detailed information about a specific skill.

typescript

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

`invoke_skill`

Invoke a skill with optional parameters.

typescript

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

`refresh_skills`

Manually trigger a skills refresh from the repository.

typescript

{ }

Usage Examples

In GitHub Copilot Chat

code

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

code

@workspace List all available security-related skills

code

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

In Claude

code

What skills are available for Next.js development?

code

Use the code-review skill to analyze my pull request

Development

Setup

bash

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

Build

bash

npm run build

Run Tests

bash

# Run all tests
npm test

# Run tests in watch mode
npm run test:watch

# Run integration tests only
npm run test:integration

Lint & Format

bash

npm run lint
npm run format

Project Structure

code

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)

API Reference

Skill Object

typescript

interface Skill {
  id: string;           // Unique identifier
  name: string;         // Display name
  description: string;  // Short description
  source: 'repository' | 'local';
  sourcePath: string;   // GitHub URL or local path
  content: string;      // Full skill content (markdown)
  parameters: ParameterSchema[];
  metadata: {
    author?: string;
    version?: string;
    tags?: string[];
    requirements?: string[];
    sourceOrg?: string;   // GitHub organization
    sourceRepo?: string;  // GitHub repository
  };
  lastUpdated: Date;
}

Parameter Schema

typescript

interface ParameterSchema {
  name: string;
  type: 'string' | 'number' | 'boolean' | 'object' | 'array';
  description: string;
  required: boolean;
  default?: unknown;
  enum?: unknown[];
}

Troubleshooting

Skills Not Loading

Check cache: Delete .cache directory and restart
Verify network: Ensure access to GitHub
Check logs: Set LOG_LEVEL=debug for verbose output

GitHub Copilot Not Seeing Skills

Full restart required: Quit VS Code completely (Cmd+Q) and reopen
Check config path: Ensure .vscode/mcp.json is in the workspace root
Verify server: Run npx awesome-agent-skills-mcp manually to test

Connection Errors

bash

# Test the server manually
echo '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"test","version":"1.0.0"}}}' | npx awesome-agent-skills-mcp

Credits

This project is built on top of the incredible work by the open-source community:

Data Source

VoltAgent Awesome Agent Skills - A curated collection of AI agent skills maintained by VoltAgent. This MCP server fetches and serves skills from this repository, making them accessible to MCP-compatible AI assistants.

Skill Contributors

Skills in this collection are contributed by leading organizations including:

Anthropic - Document processing, art generation, MCP building
Vercel - React, Next.js, deployment
Trail of Bits - Security analysis, smart contracts
Hugging Face - ML workflows, model training
Sentry - Code review, commit conventions
Expo - React Native development
Stripe - Payment integrations
And many more contributors!

Technologies

Model Context Protocol - The protocol specification
@modelcontextprotocol/sdk - Official TypeScript SDK
Zod - TypeScript-first schema validation
simple-git - Git operations

Contributing

Contributions are welcome! Please read our contributing guidelines before submitting PRs.

Fork the repository
Create your feature branch (git checkout -b feature/amazing-feature)
Commit your changes (git commit -m 'Add amazing feature')
Push to the branch (git push origin feature/amazing-feature)
Open a Pull Request

See our issue templates for reporting bugs, requesting features, or asking questions.

Documentation & Demo

GitHub Pages

You can enable GitHub Pages to host interactive documentation or demos:

Create your documentation (recommended: use /docs folder):
- Create a docs/ directory in your repository root
- Add an index.html file or use a static site generator like VitePress or Docusaurus
- This keeps documentation separate from source code
Enable GitHub Pages:
- Go to your repository Settings → Pages
- Select Source: Deploy from a branch
- Choose Branch: main and folder /docs (recommended) or / if deploying entire repo
- Save and wait for deployment

This is useful for:

Interactive API documentation
Live demos of MCP server capabilities
Tutorial walkthroughs
Skill catalog browser

Note: Using the /docs folder is recommended as it keeps documentation organized and separate from source code. Only use / (root) if you want to deploy the entire repository as a website.

License

This project is licensed under the MIT License - see the LICENSE file for details.

VoltAgent - AI agent framework
Awesome Agent Skills - The source skill collection
MCP Servers - Official MCP server implementations

<p align="center"> Made with ❤️ for the AI agent community <br> <a href="https://github.com/VoltAgent/awesome-agent-skills">⭐ Star the Awesome Agent Skills repository</a> </p>

Install

Configuration

Environment variables

SKILLS_REPO_URLdefault https://github.com/VoltAgent/awesome-agent-skills.git

URL of the skills repository to sync from

SKILLS_CACHE_DIRdefault .cache

Directory path for caching skills data

SKILLS_SYNC_INTERVALdefault 60

Auto-sync interval in minutes (0 to disable)

LOG_LEVELdefault info

Logging level (debug, info, warn, error)

claude_desktop_config.json

{
  "mcpServers": {
    "awesome-agent-skills": {
      "command": "npx",
      "args": [
        "-y",
        "awesome-agent-skills-mcp@1.0.2"
      ],
      "env": {
        "SKILLS_REPO_URL": "https://github.com/VoltAgent/awesome-agent-skills.git",
        "SKILLS_CACHE_DIR": ".cache",
        "SKILLS_SYNC_INTERVAL": "60",
        "LOG_LEVEL": "info"
      }
    }
  }
}

Topics

Awesome Agent Skills MCP Server

🚀 Quick Start

Table of Contents

Features

Quick Start

Using npx (Recommended)

Global Installation

Installation

Prerequisites

From npm

From Source

Configuration

VS Code / GitHub Copilot

Claude Desktop

OpenCode

Environment Variables

Available Skills

Anthropic

Vercel

Trail of Bits

Hugging Face

Sentry

And Many More...

MCP Tools

list_skills

get_skill

invoke_skill

refresh_skills

Usage Examples

In GitHub Copilot Chat

In Claude

Development

Setup

Build

Run Tests

Lint & Format

Project Structure

API Reference

Skill Object

Parameter Schema

Troubleshooting

Skills Not Loading

GitHub Copilot Not Seeing Skills

Connection Errors

Credits

Data Source

Skill Contributors

Technologies

Contributing

Documentation & Demo

GitHub Pages

License

Related Projects

Install

Configuration

`list_skills`

`get_skill`

`invoke_skill`

`refresh_skills`