Skills

npm version License: Apache-2.0 MCP

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:

  Install in Goose

  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:

  Add MCP Server mcp-skills to LM Studio

  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

 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

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

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

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

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