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.

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"
      ]
    }
  }
}
```
Amp

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 below
```
amp mcp add mcp-skills -- npx @koderspa/mcp-skills@latest
```
Claude Code

Use the Claude Code CLI to add the mcp-skills MCP server:
```
claude mcp add mcp-skills npx @koderspa/mcp-skills@latest
```
Claude Desktop

Follow the MCP install guide, use the standard config above.
Cline

Follow the instruction in the section Configuring MCP Servers

Example: Local Setup

Add the following to your cline_mcp_settings.json file:
```
{
  "mcpServers": {
    "mcp-skills": {
      "type": "stdio",
      "command": "npx",
      "timeout": 30,
      "args": [
        "@koderspa/mcp-skills@latest"
      ],
      "disabled": false
    }
  }
}
```
Codex

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.toml and add:
```
[mcp_servers.mcp-skills]
command = "npx"
args = ["@koderspa/mcp-skills@latest"]
```
For more information, see the Codex MCP documentation.
Copilot

Use the Copilot CLI to interactively add the mcp-skills MCP server:
```
/mcp add
```
Alternatively, create or edit the configuration file ~/.copilot/mcp-config.json and add:
```
{
  "mcpServers": {
    "mcp-skills": {
      "type": "local",
      "command": "npx",
      "tools": [
        "*"
      ],
      "args": [
        "@koderspa/mcp-skills@latest"
      ]
    }
  }
}
```
For more information, see the Copilot CLI documentation.
VS Code

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.
Cursor

Click the button to install:

Or install manually:

Go to Cursor Settings -> MCP -> Add new MCP Server. Name to your liking, use command type with the command npx @koderspa/mcp-skills@latest. You can also verify config or add command like arguments via clicking Edit.
Factory

Use the Factory CLI to add the mcp-skills MCP server:
```
droid mcp add mcp-skills "npx @koderspa/mcp-skills@latest"
```
Alternatively, type /mcp within Factory droid to open an interactive UI for managing MCP servers.

For more information, see the Factory MCP documentation.
Gemini CLI

Follow the MCP install guide, use the standard config above.

Goose

Click the button to install:

Or install manually:

Go to Advanced settings -> Extensions -> Add custom extension. Name to your liking, use type STDIO, and set the command to npx @koderspa/mcp-skills@latest. Click "Add Extension".
Kiro

Follow the MCP Servers documentation. For example in .kiro/settings/mcp.json:
```
{
  "mcpServers": {
    "mcp-skills": {
      "command": "npx",
      "args": [
        "@koderspa/mcp-skills@latest"
      ]
    }
  }
}
```
LM Studio

Click the button to install:

Or install manually:

Go to Program in the right sidebar -> Install -> Edit mcp.json. Use the standard config above.
opencode

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
    }
  }
}
```
Qodo Gen

Open Qodo Gen chat panel in VSCode or IntelliJ → Connect more tools → + Add new MCP → Paste the standard config above.

Click Save.
Warp

Go to Settings -> AI -> Manage MCP Servers -> + Add to add an MCP Server. Use the standard config above.

Alternatively, use the slash command /add-mcp in the Warp prompt and paste the standard config from above:
```
{
  "mcpServers": {
    "mcp-skills": {
      "command": "npx",
      "args": [
        "@koderspa/mcp-skills@latest"
      ]
    }
  }
}
```
Windsurf

Follow Windsurf MCP documentation. Use the standard config above.

Overview

AI Agent ↓ MCP Client ↓ mcp-skills (this server) ↓ skills.sh CLI ↓ Installed Skills

Tools

findSkills — Search for skills by keyword

Read-only: Yes Input: Query string Output: List of matching skills with metadata

Uses the skills.sh CLI to search the open skills ecosystem.

installSkill — Install a skill by ID

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 automatically

Installs a skill from skills.sh or GitHub by its ID.

uninstallSkill — Uninstall a skill by ID

Read-only: No (modifies system) Input: Skill ID (format: <code>owner/repo@skill</code>) Output: Uninstallation success/failure message

Removes a previously installed skill by its ID.

updateSkill — Update a skill by ID

Read-only: No (modifies system) Input: Skill ID (format: <code>owner/repo@skill</code>) Output: Update success/failure message

Updates an installed skill to its latest version.

selectSkill — Recommend the most relevant skill for a task

Read-only: Yes Input: Task description Output: Best matching skill with details

Recommends the most relevant skill for a specific task using the skills.sh ecosystem.

analyzeProjectStack — Analyze project stack and recommend skills

Read-only: Yes Input: None (analyzes <code>package.json</code> in the current directory) Output: Detected stack and recommended skills

Analyzes your project's package.json to detect frameworks/libraries and recommends relevant skills.

Resources

Model Context Protocol Documentation

MCP TypeScript SDK

skills.sh

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.

mcp-skills

mcp-skills

What is mcp-skills?

Why this matters

What is skills.sh?

mcp-skills vs skills CLI

Getting started

Quick Installation (Production)

Click the button to install:

Or install manually:

Click the button to install:

Or install manually:

Click the button to install:

Or install manually:

Overview

Tools

Resources

Contributing

Support

License

Reviews