mcp-skills
Integrates with the Vercel-backed skills.sh ecosystem to enable discovery, installation, and lifecycle management of reusable AI agent skills and instruction sets.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@mcp-skills find and install a skill for generating React components"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
mcp-skills
What is mcp-skills?
mcp-skills is an MCP server that integrates with the open skills.sh ecosystem. It enables coding agents and LLMs to discover, recommend, and install reusable skills automatically.
Related MCP server: skills-master-mcp
Why this matters
Modern AI coding agents can write code, but they can’t easily extend themselves.
When an agent lacks a capability (e.g. React testing, refactoring patterns, architectural scaffolding), it usually depends on:
Manual CLI execution
Human intervention
Prompt hacks
mcp-skills bridges that gap.
It gives AI agents structured access to the open skills.sh ecosystem through Model Context Protocol (MCP), enabling:
Skills discovery
Context-aware skill recommendation and installation
Full lifecycle management (install, update, uninstall)
What is skills.sh?
skills.sh is The Open Agent Skills Ecosystem by Vercel. It lets you search, install, and manage skills (reusable instruction sets) for popular coding agents like Copilot, Cursor, Claude Code, Codex, OpenCode, and many more.
Example use cases:
"Find a skill to generate React components" → Agent searches and installs it
"Install the TypeScript refactoring skill" → Agent adds it to your environment
Agent detects missing capability → Autonomously searches and installs the right skill
"Analyze this monorepo and enforce a consistent testing strategy across all packages" → Agent detects Jest/Vitest usage, installs the appropriate testing skill, and refactors configs automatically
"Migrate this legacy Express API to a typed architecture" → Agent selects a TypeScript migration skill, installs it, and applies structured refactors across the codebase
mcp-skills vs skills CLI
CLI: Token-efficient and fast for direct execution.
MCP: Better for structured reasoning, introspection, and autonomous agent workflows.
Getting started
Quick Installation (Production)
Install the MCP server from npm. No need to clone the repository.
Standard config works in most MCP clients:
{ "mcpServers": { "mcp-skills": { "command": "npx", "args": [ "-y", "@koderspa/mcp-skills@latest" ] } } }Add via the Amp VS Code extension settings screen or by updating your settings.json file:
"amp.mcpServers": { "mcp-skills": { "command": "npx", "args": [ "@koderspa/mcp-skills@latest" ] } }Amp CLI Setup:
Add via the
amp mcp addcommand belowamp mcp add mcp-skills -- npx @koderspa/mcp-skills@latestUse the Claude Code CLI to add the mcp-skills MCP server:
claude mcp add mcp-skills npx @koderspa/mcp-skills@latestFollow the MCP install guide, use the standard config above.
Follow the instruction in the section Configuring MCP Servers
Example: Local Setup
Add the following to your
cline_mcp_settings.jsonfile:{ "mcpServers": { "mcp-skills": { "type": "stdio", "command": "npx", "timeout": 30, "args": [ "@koderspa/mcp-skills@latest" ], "disabled": false } } }Use the Codex CLI to add the mcp-skills MCP server:
codex mcp add mcp-skills npx "@koderspa/mcp-skills@latest"Alternatively, create or edit the configuration file
~/.codex/config.tomland add:[mcp_servers.mcp-skills] command = "npx" args = ["@koderspa/mcp-skills@latest"]For more information, see the Codex MCP documentation.
Use the Copilot CLI to interactively add the mcp-skills MCP server:
/mcp addAlternatively, create or edit the configuration file
~/.copilot/mcp-config.jsonand add:{ "mcpServers": { "mcp-skills": { "type": "local", "command": "npx", "tools": [ "*" ], "args": [ "@koderspa/mcp-skills@latest" ] } } }For more information, see the Copilot CLI documentation.
Follow the MCP install guide, use the standard config above. You can also install the mcp-skills MCP server using the VS Code CLI:
# For VS Code code --add-mcp '{"name":"mcp-skills","command":"npx","args":["@koderspa/mcp-skills@latest"]}'After installation, the mcp-skills MCP server will be available for use with your GitHub Copilot agent in VS Code.
Click the button to install:
Or install manually:
Go to
Cursor Settings->MCP->Add new MCP Server. Name to your liking, usecommandtype with the commandnpx @koderspa/mcp-skills@latest. You can also verify config or add command like arguments via clickingEdit.Use the Factory CLI to add the mcp-skills MCP server:
droid mcp add mcp-skills "npx @koderspa/mcp-skills@latest"Alternatively, type
/mcpwithin Factory droid to open an interactive UI for managing MCP servers.For more information, see the Factory MCP documentation.
Follow the MCP install guide, use the standard config above.
Click the button to install:
Or install manually:
Go to
Advanced settings->Extensions->Add custom extension. Name to your liking, use typeSTDIO, and set thecommandtonpx @koderspa/mcp-skills@latest. Click "Add Extension".Follow the MCP Servers documentation. For example in
.kiro/settings/mcp.json:{ "mcpServers": { "mcp-skills": { "command": "npx", "args": [ "@koderspa/mcp-skills@latest" ] } } }Click the button to install:
Or install manually:
Go to
Programin the right sidebar ->Install->Edit mcp.json. Use the standard config above.Follow the MCP Servers documentation. For example in
~/.config/opencode/opencode.json:{ "$schema": "https://opencode.ai/config.json", "mcp": { "mcp-skills": { "type": "local", "command": [ "npx", "@koderspa/mcp-skills@latest" ], "enabled": true } } }Open Qodo Gen chat panel in VSCode or IntelliJ → Connect more tools → + Add new MCP → Paste the standard config above.
Click Save.
Go to
Settings->AI->Manage MCP Servers->+ Addto add an MCP Server. Use the standard config above.Alternatively, use the slash command
/add-mcpin the Warp prompt and paste the standard config from above:{ "mcpServers": { "mcp-skills": { "command": "npx", "args": [ "@koderspa/mcp-skills@latest" ] } } }Follow Windsurf MCP documentation. Use the standard config above.
Overview
AI Agent ↓ MCP Client ↓ mcp-skills (this server) ↓ skills.sh CLI ↓ Installed Skills
Tools
Read-only: Yes Input: Query string Output: List of matching skills with metadata
Uses the skills.sh CLI to search the open skills ecosystem.
Read-only: No (modifies system)
Input: Skill ID (format: <code>owner/repo@skill</code>)
Output: Installation success/failure message
Auto-detects: Installs missing skills CLI automaticallyInstalls a skill from skills.sh or GitHub by its ID.
Read-only: No (modifies system)
Input: Skill ID (format: <code>owner/repo@skill</code>)
Output: Uninstallation success/failure messageRemoves a previously installed skill by its ID.
Read-only: No (modifies system)
Input: Skill ID (format: <code>owner/repo@skill</code>)
Output: Update success/failure messageUpdates an installed skill to its latest version.
Read-only: Yes
Input: Task description
Output: Best matching skill with detailsRecommends the most relevant skill for a specific task using the skills.sh ecosystem.
Read-only: Yes
Input: None (analyzes <code>package.json</code> in the current directory)
Output: Detected stack and recommended skillsAnalyzes your project's package.json to detect frameworks/libraries and recommends relevant skills.
Resources
Contributing
Contributions are welcome! Please feel free to submit a Pull Request.
Fork the repository
Create your feature branch (
git checkout -b feature/amazing-feature)Commit your changes (
git commit -m 'Add some amazing feature')Push to the branch (
git push origin feature/amazing-feature)Open a Pull Request
Support
Issues: GitHub Issues
Email: yusterfrancisco@koderspa.com
License
Apache-2.0 License - see LICENSE file for details.
Available Tools
6 toolsanalyzeProjectStackB
Analiza el package.json y recomienda skills según el stack detectado.
Inputs: no named parameters.
findSkillsC
Busca skills en el ecosistema skills.sh por palabra clave
Inputs: query (required).
installSkillC
Instala un skill desde skills.sh o GitHub usando su ID (owner/repo@skill)
Inputs: skillId (required).
selectSkillC
Recomienda el skill más relevante para una tarea concreta
Inputs: task (required).
uninstallSkillC
Desinstala un skill instalado usando su ID (owner/repo@skill)
Inputs: skillId (required).
updateSkillC
Actualiza un skill instalado usando su ID (owner/repo@skill)
Inputs: skillId (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 6 tools
Each tool has a clearly distinct purpose with no overlap: analyzeProjectStack detects stacks, findSkills searches by keyword, selectSkill recommends for tasks, and install/uninstall/update manage skill lifecycle. The descriptions make it easy to differentiate between analysis, search, recommendation, and management functions.
Tools follow a consistent verbNoun pattern (e.g., analyzeProjectStack, findSkills, installSkill) with clear action-object naming. The minor deviation is 'selectSkill' which uses 'select' instead of a more precise verb like 'recommendSkill', but overall the naming is highly predictable and readable.
With 6 tools, the server is well-scoped for managing skills in the skills.sh ecosystem. It covers analysis, discovery, recommendation, and full lifecycle management (install/update/uninstall), with each tool earning its place without being overwhelming or insufficient for the domain.
The toolset provides complete coverage for the skills management domain: analyzeProjectStack for stack detection, findSkills and selectSkill for discovery and recommendation, and installSkill, updateSkill, uninstallSkill for full CRUD-like lifecycle management. No obvious gaps exist for the stated purpose.
Maintenance
Related MCP Connectors
Search & install 13,000+ AI agent skills from skills-hub.ai inside any MCP tool.
Agent skills for Claude, Codex and Cursor: find, install and load skills from one connector.
Search, install and compose AI agent skills, loops and bundles from the LoopSkill marketplace.
Find, inspect and install reviewed reusable AI-agent capabilities from superskill.sh.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceTransform any AI agent into a domain expert by giving it access to modular, reusable skills through the Model Context Protocol. Brings Claude's Skills format to any MCP-compatible agent, allowing you to create skills once and use them everywhere.67 npm31-
- AlicenseAqualityDmaintenanceConnects AI coding agents to the SkillsMP marketplace, allowing users to search, read, and install over 8,000 community-made skills. It enables agents to gain new capabilities either through on-the-spot instruction or permanent installation without requiring an API key.544 npm10MIT
- AlicenseNot gradedqualityCmaintenanceAutomatically discovers and installs AI skills for your project's tech stack, supporting Claude, Copilot, Codex, and other MCP-compatible agents.13 npm4MIT
- AlicenseAqualityBmaintenanceModule discovery, documentation search, and skill generation for AI agents via the Model Context Protocol.22186 PyPI6GPL 3.0