awesome-agent-skills

Awesome Agent Skills MCP Server exposes 100+ curated AI agent skills from the VoltAgent collection. It runs as a Node.js-based MCP server and auto-syncs skills from the upstream repository, making them available to any MCP-compliant client (Claude Desktop, OpenCode, VS Code, GitHub Copilot, etc.). To use it, start the server (for example via npx awesome-agent-skills-mcp or by running the underlying Node.js entrypoint if you have a local install) and configure your MCP client to point at the server. The MCP tools provided by this server include list_skills to enumerate skills (with optional filters), get_skill to fetch details about a specific skill, and invoke_skill to run a skill with parameters. The server is designed to be zero-config out of the box, but you can customize behavior through environment variables such as SKILLS_REPO_URL to point at a custom skills repository, SKILLS_CACHE_DIR for caching, and SKILLS_SYNC_INTERVAL to control how often the repo is synchronized.

Prerequisites:

• Node.js >= 20.0.0
• npm or yarn

From npm:

npm install -g awesome-agent-skills-mcp

From source (optional):

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

Run:

npx awesome-agent-skills-mcp

If you prefer a local installation, you can start the server with Node.js directly from the built distribution:

node /path/to/awesome-agent-skills-mcp/dist/index.js

Environment variables:

• SKILLS_REPO_URL: URL of the skills repository to fetch (default: https://github.com/VoltAgent/awesome-agent-skills.git)
• SKILLS_CACHE_DIR: Cache directory (default: .cache)
• SKILLS_SYNC_INTERVAL: Auto-sync interval in minutes (default: 60). Set to 0 to disable auto-sync.
• LOG_LEVEL: Logging level (debug, info, warn, error; default: info)

Common issues:

• Ensure Node.js version is >= 20.0.0
• If you modify SKILLS_REPO_URL, ensure the repository is accessible and you have network access
• When configuring in clients (Claude/OpenCode/VS Code), quit and re-open the client or app to pick up changes
• If you encounter permission issues with global installs, use a local installation and run via node dist/index.js