{
  "markdown": "# Awesome Agent Skills MCP Server\n\n[![CI](https://github.com/shadowrootdev/awesome-agent-skills-mcp/actions/workflows/ci.yml/badge.svg)](https://github.com/shadowrootdev/awesome-agent-skills-mcp/actions/workflows/ci.yml)\n[![Security Audit](https://github.com/shadowrootdev/awesome-agent-skills-mcp/actions/workflows/security-audit.yml/badge.svg)](https://github.com/shadowrootdev/awesome-agent-skills-mcp/actions/workflows/security-audit.yml)\n[![CodeQL](https://github.com/shadowrootdev/awesome-agent-skills-mcp/actions/workflows/codeql.yml/badge.svg)](https://github.com/shadowrootdev/awesome-agent-skills-mcp/actions/workflows/codeql.yml)\n[![npm version](https://img.shields.io/npm/v/awesome-agent-skills-mcp.svg)](https://www.npmjs.com/package/awesome-agent-skills-mcp)\n[![npm downloads](https://img.shields.io/npm/dm/awesome-agent-skills-mcp.svg)](https://www.npmjs.com/package/awesome-agent-skills-mcp)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n[![Node.js Version](https://img.shields.io/node/v/awesome-agent-skills-mcp.svg)](https://nodejs.org)\n[![MCP Compatible](https://img.shields.io/badge/MCP-2024--11--05-blue.svg)](https://modelcontextprotocol.io)\n[![GitHub release](https://img.shields.io/github/v/release/shadowrootdev/awesome-agent-skills-mcp)](https://github.com/shadowrootdev/awesome-agent-skills-mcp/releases)\n[![GitHub stars](https://img.shields.io/github/stars/shadowrootdev/awesome-agent-skills-mcp)](https://github.com/shadowrootdev/awesome-agent-skills-mcp/stargazers)\n\n> **A Model Context Protocol (MCP) server that provides access to 100+ curated AI agent skills from the [VoltAgent Awesome Agent Skills](https://github.com/VoltAgent/awesome-agent-skills) collection.**\n\nTransform your AI assistants into specialized experts with skills from Anthropic, Vercel, Trail of Bits, Hugging Face, Stripe, Expo, and many more leading organizations.\n\n## 🚀 Quick Start\n\n```bash\nnpx awesome-agent-skills-mcp\n```\n\nThat's it! Add to your MCP client config and start using 100+ AI skills.\n\n---\n\n## Table of Contents\n\n- [Features](#features)\n- [Quick Start](#quick-start)\n- [Installation](#installation)\n- [Configuration](#configuration)\n  - [VS Code / GitHub Copilot](#vs-code--github-copilot)\n  - [Claude Desktop](#claude-desktop)\n  - [OpenCode](#opencode)\n- [Available Skills](#available-skills)\n- [MCP Tools](#mcp-tools)\n- [Usage Examples](#usage-examples)\n- [Development](#development)\n- [API Reference](#api-reference)\n- [Troubleshooting](#troubleshooting)\n- [Credits](#credits)\n- [License](#license)\n\n---\n\n## Features\n\n- **100+ Curated Skills** - Access skills from top organizations including Anthropic, Vercel, Trail of Bits, Hugging Face, and more\n- **Auto-Sync** - Automatically fetches and updates skills from the VoltAgent repository\n- **MCP 2024-11-05 Compliant** - Full compatibility with the latest Model Context Protocol specification\n- **Multi-Client Support** - Works with Claude, GitHub Copilot, OpenCode, and any MCP-compatible client\n- **Smart Caching** - Efficient JSON-based caching for fast startup times\n- **Type-Safe** - Built with TypeScript and Zod for runtime validation\n- **Zero Configuration** - Works out of the box with sensible defaults\n\n---\n\n## Quick Start\n\n### Using npx (Recommended)\n\n```bash\nnpx awesome-agent-skills-mcp\n```\n\n### Global Installation\n\n```bash\nnpm install -g awesome-agent-skills-mcp\nawesome-agent-skills-mcp\n```\n\n---\n\n## Installation\n\n### Prerequisites\n\n- **Node.js** >= 20.0.0\n- **npm** or **yarn**\n\n### From npm\n\n```bash\nnpm install awesome-agent-skills-mcp\n```\n\n### From Source\n\n```bash\ngit clone https://github.com/shadowrootdev/awesome-agent-skills-mcp.git\ncd awesome-agent-skills-mcp\nnpm install\nnpm run build\n```\n\n---\n\n## Configuration\n\n### VS Code / GitHub Copilot\n\nCreate or update `.vscode/mcp.json` in your project:\n\n```json\n{\n  \"servers\": {\n    \"awesome-agent-skills\": {\n      \"command\": \"npx\",\n      \"args\": [\"awesome-agent-skills-mcp\"]\n    }\n  }\n}\n```\n\nOr with a local installation:\n\n```json\n{\n  \"servers\": {\n    \"awesome-agent-skills\": {\n      \"command\": \"node\",\n      \"args\": [\"/path/to/awesome-agent-skills-mcp/dist/index.js\"]\n    }\n  }\n}\n```\n\n> **Important**: After adding the configuration, **fully quit VS Code** (Cmd+Q / Alt+F4) and reopen it for changes to take effect.\n\n### Claude Desktop\n\nAdd to your Claude Desktop configuration (`~/Library/Application Support/Claude/claude_desktop_config.json` on macOS):\n\n```json\n{\n  \"mcpServers\": {\n    \"awesome-agent-skills\": {\n      \"command\": \"npx\",\n      \"args\": [\"awesome-agent-skills-mcp\"]\n    }\n  }\n}\n```\n\n### OpenCode\n\nAdd to `~/.config/opencode/opencode.json`:\n\n```json\n{\n  \"mcp\": {\n    \"awesome-agent-skills\": {\n      \"type\": \"local\",\n      \"command\": [\"npx\", \"awesome-agent-skills-mcp\"],\n      \"enabled\": true\n    }\n  }\n}\n```\n\n### Environment Variables\n\n| Variable | Default | Description |\n|----------|---------|-------------|\n| `SKILLS_REPO_URL` | `https://github.com/VoltAgent/awesome-agent-skills.git` | Skills repository URL |\n| `SKILLS_CACHE_DIR` | `.cache` | Cache directory path |\n| `SKILLS_SYNC_INTERVAL` | `60` | Auto-sync interval in minutes (0 to disable) |\n| `LOG_LEVEL` | `info` | Logging level (debug, info, warn, error) |\n\n---\n\n## Available Skills\n\nThe server provides access to **100+ skills** from leading organizations:\n\n### Anthropic\nDocument processing, presentation creation, spreadsheet manipulation, PDF handling, algorithmic art, MCP building, and more.\n\n| Skill | Description |\n|-------|-------------|\n| `docx` | Create, edit, and analyze Word documents |\n| `pptx` | PowerPoint presentation creation and editing |\n| `xlsx` | Spreadsheet manipulation with formulas |\n| `pdf` | PDF processing and form filling |\n| `mcp-builder` | Guide for creating MCP servers |\n| `webapp-testing` | Playwright-based web app testing |\n\n### Vercel\nReact and Next.js best practices, deployment, and performance optimization.\n\n| Skill | Description |\n|-------|-------------|\n| `react-best-practices` | React performance optimization guidelines |\n| `next-best-practices` | Next.js conventions and patterns |\n| `web-design-guidelines` | UI/UX compliance review |\n| `vercel-deploy` | Deploy apps to Vercel |\n\n### Trail of Bits\nSecurity analysis, smart contract auditing, and code review tools.\n\n| Skill | Description |\n|-------|-------------|\n| `building-secure-contracts` | Smart contract security toolkit |\n| `semgrep-rule-creator` | Create custom Semgrep rules |\n| `property-based-testing` | Property-based testing guidance |\n| `static-analysis` | Static analysis tooling |\n\n### Hugging Face\nML model training, dataset management, and Hub operations.\n\n| Skill | Description |\n|-------|-------------|\n| `hugging-face-cli` | HF Hub CLI operations |\n| `hugging-face-datasets` | Dataset creation and management |\n| `hugging-face-model-trainer` | Model fine-tuning with TRL |\n| `hugging-face-evaluation` | Model evaluation workflows |\n\n### Sentry\nCode review, commit conventions, and PR automation.\n\n| Skill | Description |\n|-------|-------------|\n| `code-review` | Sentry engineering code review practices |\n| `commit` | Conventional commit messages |\n| `create-pr` | PR creation following Sentry conventions |\n| `find-bugs` | Bug and vulnerability detection |\n\n### And Many More...\n- **Stripe** - Payment integration best practices\n- **Expo** - React Native app development\n- **n8n** - Workflow automation patterns\n- **Sanity** - CMS best practices\n- **Neon** - Serverless Postgres\n- **Remotion** - Programmatic video creation\n\n---\n\n## MCP Tools\n\nThe server exposes four MCP tools:\n\n### `list_skills`\n\nList all available skills with optional filtering.\n\n```typescript\n// List all skills\n{ }\n\n// Filter by source\n{ \"source\": \"repository\" }\n\n// Filter by tag\n{ \"tag\": \"security\" }\n```\n\n### `get_skill`\n\nGet detailed information about a specific skill.\n\n```typescript\n{ \"skill_id\": \"react-best-practices\" }\n```\n\n### `invoke_skill`\n\nInvoke a skill with optional parameters.\n\n```typescript\n{\n  \"skill_id\": \"docx\",\n  \"parameters\": {\n    \"document_type\": \"report\"\n  }\n}\n```\n\n### `refresh_skills`\n\nManually trigger a skills refresh from the repository.\n\n```typescript\n{ }\n```\n\n---\n\n## Usage Examples\n\n### In GitHub Copilot Chat\n\n```\n@workspace Use the react-best-practices skill to review my React components\n```\n\n```\n@workspace List all available security-related skills\n```\n\n```\n@workspace Get the stripe-best-practices skill and apply it to my checkout code\n```\n\n### In Claude\n\n```\nWhat skills are available for Next.js development?\n```\n\n```\nUse the code-review skill to analyze my pull request\n```\n\n---\n\n## Development\n\n### Setup\n\n```bash\ngit clone https://github.com/shadowrootdev/awesome-agent-skills-mcp.git\ncd awesome-agent-skills-mcp\nnpm install\n```\n\n### Build\n\n```bash\nnpm run build\n```\n\n### Run Tests\n\n```bash\n# Run all tests\nnpm test\n\n# Run tests in watch mode\nnpm run test:watch\n\n# Run integration tests only\nnpm run test:integration\n```\n\n### Lint & Format\n\n```bash\nnpm run lint\nnpm run format\n```\n\n### Project Structure\n\n```\nawesome-agent-skills-mcp/\n├── src/\n│   ├── index.ts              # Entry point\n│   ├── server.ts             # MCP server implementation\n│   ├── config.ts             # Configuration management\n│   ├── models/\n│   │   ├── skill.ts          # Skill type definitions\n│   │   ├── parameter.ts      # Parameter schemas\n│   │   ├── registry.ts       # SkillRegistry class\n│   │   └── repository.ts     # Repository source model\n│   ├── services/\n│   │   ├── git-sync.ts       # Git repository sync\n│   │   ├── skill-parser.ts   # Skill parsing from README\n│   │   └── skill-executor.ts # Skill invocation\n│   ├── cache/\n│   │   └── cache-manager.ts  # JSON-based caching\n│   └── utils/\n│       └── logger.ts         # Structured logging\n├── tests/\n│   ├── unit/                 # Unit tests\n│   └── integration/          # Integration tests\n├── dist/                     # Compiled output\n└── .cache/                   # Runtime cache (gitignored)\n```\n\n---\n\n## API Reference\n\n### Skill Object\n\n```typescript\ninterface Skill {\n  id: string;           // Unique identifier\n  name: string;         // Display name\n  description: string;  // Short description\n  source: 'repository' | 'local';\n  sourcePath: string;   // GitHub URL or local path\n  content: string;      // Full skill content (markdown)\n  parameters: ParameterSchema[];\n  metadata: {\n    author?: string;\n    version?: string;\n    tags?: string[];\n    requirements?: string[];\n    sourceOrg?: string;   // GitHub organization\n    sourceRepo?: string;  // GitHub repository\n  };\n  lastUpdated: Date;\n}\n```\n\n### Parameter Schema\n\n```typescript\ninterface ParameterSchema {\n  name: string;\n  type: 'string' | 'number' | 'boolean' | 'object' | 'array';\n  description: string;\n  required: boolean;\n  default?: unknown;\n  enum?: unknown[];\n}\n```\n\n---\n\n## Troubleshooting\n\n### Skills Not Loading\n\n1. **Check cache**: Delete `.cache` directory and restart\n2. **Verify network**: Ensure access to GitHub\n3. **Check logs**: Set `LOG_LEVEL=debug` for verbose output\n\n### GitHub Copilot Not Seeing Skills\n\n1. **Full restart required**: Quit VS Code completely (Cmd+Q) and reopen\n2. **Check config path**: Ensure `.vscode/mcp.json` is in the workspace root\n3. **Verify server**: Run `npx awesome-agent-skills-mcp` manually to test\n\n### Connection Errors\n\n```bash\n# Test the server manually\necho '{\"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\n```\n\n---\n\n## Credits\n\nThis project is built on top of the incredible work by the open-source community:\n\n### Data Source\n\n**[VoltAgent Awesome Agent Skills](https://github.com/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.\n\n### Skill Contributors\n\nSkills in this collection are contributed by leading organizations including:\n\n- [Anthropic](https://github.com/anthropics/skills) - Document processing, art generation, MCP building\n- [Vercel](https://github.com/vercel-labs/agent-skills) - React, Next.js, deployment\n- [Trail of Bits](https://github.com/trailofbits/skills) - Security analysis, smart contracts\n- [Hugging Face](https://github.com/huggingface/skills) - ML workflows, model training\n- [Sentry](https://github.com/getsentry/skills) - Code review, commit conventions\n- [Expo](https://github.com/expo/skills) - React Native development\n- [Stripe](https://github.com/stripe/skills) - Payment integrations\n- And many more contributors!\n\n### Technologies\n\n- [Model Context Protocol](https://modelcontextprotocol.io) - The protocol specification\n- [@modelcontextprotocol/sdk](https://github.com/modelcontextprotocol/typescript-sdk) - Official TypeScript SDK\n- [Zod](https://github.com/colinhacks/zod) - TypeScript-first schema validation\n- [simple-git](https://github.com/steveukx/git-js) - Git operations\n\n---\n\n## Contributing\n\nContributions are welcome! Please read our [contributing guidelines](CONTRIBUTING.md) before submitting PRs.\n\n1. Fork the repository\n2. Create your feature branch (`git checkout -b feature/amazing-feature`)\n3. Commit your changes (`git commit -m 'Add amazing feature'`)\n4. Push to the branch (`git push origin feature/amazing-feature`)\n5. Open a Pull Request\n\nSee our [issue templates](.github/ISSUE_TEMPLATE) for reporting bugs, requesting features, or asking questions.\n\n---\n\n## Documentation & Demo\n\n### GitHub Pages\n\nYou can enable GitHub Pages to host interactive documentation or demos:\n\n1. **Create your documentation** (recommended: use `/docs` folder):\n   - Create a `docs/` directory in your repository root\n   - Add an `index.html` file or use a static site generator like VitePress or Docusaurus\n   - This keeps documentation separate from source code\n\n2. **Enable GitHub Pages**:\n   - Go to your repository **Settings** → **Pages**\n   - Select **Source**: Deploy from a branch\n   - Choose **Branch**: `main` and folder `/docs` (recommended) or `/` if deploying entire repo\n   - Save and wait for deployment\n\nThis is useful for:\n- Interactive API documentation\n- Live demos of MCP server capabilities\n- Tutorial walkthroughs\n- Skill catalog browser\n\n> **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.\n\n---\n\n## License\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\n\n---\n\n## Related Projects\n\n- [VoltAgent](https://github.com/VoltAgent) - AI agent framework\n- [Awesome Agent Skills](https://github.com/VoltAgent/awesome-agent-skills) - The source skill collection\n- [MCP Servers](https://github.com/modelcontextprotocol/servers) - Official MCP server implementations\n\n---\n\n<p align=\"center\">\n  Made with ❤️ for the AI agent community\n  <br>\n  <a href=\"https://github.com/VoltAgent/awesome-agent-skills\">⭐ Star the Awesome Agent Skills repository</a>\n</p>\n",
  "bytes": 15133,
  "sha": "099e56652e55610b7d12b0e1ccfcb44ea93c943d7382f5209fcfafa3cacd4326",
  "repo_slug": "shadowrootdev/awesome-agent-skills-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_shadowrootdev_awesome_agent_sk_bc3ca1e2/readme"
}