awesome-agent-skills-mcp
Advanced tools
MCP server that exposes 100+ AI agent skills from the VoltAgent awesome-agent-skills collection. Works with Claude, GitHub Copilot, and any MCP-compatible client.
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.
npx awesome-agent-skills-mcp
That's it! Add to your MCP client config and start using 100+ AI skills.
npx awesome-agent-skills-mcp
npm install -g awesome-agent-skills-mcp
awesome-agent-skills-mcp
npm install 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
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.
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"]
}
}
}
Add to ~/.config/opencode/opencode.json:
{
"mcp": {
"awesome-agent-skills": {
"type": "local",
"command": ["npx", "awesome-agent-skills-mcp"],
"enabled": true
}
}
}
| 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) |
The server provides access to 100+ skills from leading organizations:
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 |
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 |
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 |
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 |
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 |
The server exposes four MCP tools:
list_skillsList all available skills with optional filtering.
// List all skills
{ }
// Filter by source
{ "source": "repository" }
// Filter by tag
{ "tag": "security" }
get_skillGet detailed information about a specific skill.
{ "skill_id": "react-best-practices" }
invoke_skillInvoke a skill with optional parameters.
{
"skill_id": "docx",
"parameters": {
"document_type": "report"
}
}
refresh_skillsManually 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
npm run build
# Run all tests
npm test
# Run tests in watch mode
npm run test:watch
# Run integration tests only
npm run test:integration
npm run lint
npm run format
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[];
}
.cache directory and restartLOG_LEVEL=debug for verbose output.vscode/mcp.json is in the workspace rootnpx awesome-agent-skills-mcp manually 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.
Skills in this collection are contributed by leading organizations including:
Contributions are welcome! Please read our contributing guidelines before submitting PRs.
git checkout -b feature/amazing-feature)git commit -m 'Add amazing feature')git push origin feature/amazing-feature)This project is licensed under the MIT License - see the LICENSE file for details.
Made with ❤️ for the AI agent community
⭐ Star the Awesome Agent Skills repository
FAQs
MCP server that exposes 100+ AI agent skills from the VoltAgent awesome-agent-skills collection. Works with Claude, GitHub Copilot, and any MCP-compatible client.
The npm package awesome-agent-skills-mcp receives a total of 48 weekly downloads. As such, awesome-agent-skills-mcp popularity was classified as not popular.
We found that awesome-agent-skills-mcp demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 1 open source maintainer collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Company News
Open source maintainers are under more pressure than ever. We're raising our open source program from the Team plan to the Business plan, free.
Security News
The supply chain control that delays freshly published gems now covers lockfile generation and gem vendoring in Ruby projects.
Security News
During a UK cyber test, a Mythos 5 agent used sockpuppets, social engineering, and prompt injection to try to get a maintainer to merge malware.