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.

A Model Context Protocol (MCP) server that provides access to 100+ curated AI agent skills from theVoltAgent Awesome Agent Skillscollection.

- Features
- Quick Start
- Installation
- Configuration

- VS Code / GitHub Copilot
- Claude Desktop
- OpenCode

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

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

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

{ "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.

Add to your Claude Desktop configuration (~/Library/Application Support/Claude/claude_desktop_config.jsonon macOS):

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

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

{ "mcp": { "awesome-agent-skills": { "type": "local", "command": ["npx", "awesome-agent-skills-mcp"], "enabled": true } } }

The server provides access to100+ skillsfrom leading organizations:

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

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

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

ML model training, dataset management, and Hub operations.

Code review, commit conventions, and PR automation.

- 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

List all available skills with optional filtering.

// List all skills { } // Filter by source { "source": "repository" } // Filter by tag { "tag": "security" }

Get detailed information about a specific skill.

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

Invoke a skill with optional parameters.

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

Manually trigger a skills refresh from the repository.

@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

What skills are available for Next.js development?

Use the code-review skill to analyze my pull request

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

# Run all tests npm test # Run tests in watch mode npm run test:watch # Run integration tests only npm run test:integration

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)

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; }

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

- Check cache: Delete.cachedirectory and restart
- Verify network: Ensure access to GitHub
- Check logs: SetLOG_LEVEL=debugfor verbose output
- Full restart required: Quit VS Code completely (Cmd+Q) and reopen
- Check config path: Ensure.vscode/mcp.jsonis in the workspace root
- Verify server: Runnpx awesome-agent-skills-mcpmanually to test

# 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

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

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.

- 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!

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

Contributions are welcome! Please read ourcontributing guidelinesbefore 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 ourissue templatesfor reporting bugs, requesting features, or asking questions.

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

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

Made with ❤️ for the AI agent community
⭐ Star the Awesome Agent Skills repository

Connect your GTD system directly to any LLM, so you can capture, organize, and review your life and work using natural language.