Skip to content
MCP server

Skillmd

Search, fetch, lint and install SKILL.md agent skills from the SkillMD registry

Install
Pricing
Open source
Platforms
CLI, API
Runs
Locally or Remotely
Version
1.3.11
Listing updated
3 days ago

About Skillmd

Skillmd is an open-source MCP server for developer tools. It can run locally on your machine or as a hosted remote server.

The registry behind this server claims over a million skills from tens of thousands of publishers, each linted against the SKILL.md format, security-scanned for what it can do and pinned to a commit. Every skill page shows capability flags such as running scripts, making network calls or reading secrets, and installing only writes files.

The server ships inside the MIT-licensed get-skill npm package, which is also the skillmd command line. It runs over stdio, or you can use the hosted endpoint. A SKILLMD_TOKEN is optional and unlocks a saved-skills list and personalised recommendations. Skills land in each detected agent's own directory, such as .claude/skills or .cursor/skills.

Beyond search and install, the same engine can lint your own skill (with a 0-100 quality score and automatic fixes for mechanical issues) and scan what a skill would do. The README also describes plugins that bundle several skills and install as one unit.

Install

Run in a terminal

claude mcp add --transport http skillmd https://api.skillmd.com/mcp

Add to Settings → Connectors → Add custom connector

https://api.skillmd.com/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "skillmd": {
      "url": "https://api.skillmd.com/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "skillmd": {
      "type": "http",
      "url": "https://api.skillmd.com/mcp"
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "skillmd": {
      "serverUrl": "https://api.skillmd.com/mcp"
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "skillmd": {
      "type": "http",
      "url": "https://api.skillmd.com/mcp"
    }
  }
}

Configuration

  • SKILLMD_TOKENSkillMD personal access token (enables skillmd_list_saved and personalized recommendations)
  • SKILLMD_APIOverride the registry API base URL

Tools this server provides (1)

Taken from the project documentation; the running server may differ.

skillmd_list_saved
Lists the skills saved to your account; needs a SKILLMD_TOKEN

What it does

Registry search
Finds skills by task, category or agent from the hosted registry.
Install into agents
Writes skills into the directories of each agent detected on your machine.
Linting
Validates SKILL.md files and reports a quality score, with a fix option for mechanical issues.
Capability scanning
Reports scripts, network calls and secret access a skill would use.
Hosted or local
Runs over stdio via npm or as a hosted streamable HTTP server.
Plugin bundles
Installs groups of skills as a single unit.

Good for

  • Find a skill for a task and install it into Claude Code or Cursor
  • Lint a SKILL.md before publishing it
  • Check what a third-party skill can do before installing
  • Run skill linting in CI with the GitHub Action

Pricing

Open source

Free to search, save, install and publish; toolchain is MIT-licensed

Prices change. Check skillmd.com before you buy.

Skillmd FAQ

Does it cost anything?

The site says searching, saving, installing and publishing are free.

Do I need an account?

No account is needed for search and install; an optional personal access token adds saved skills and recommendations.

Which agents does it install to?

The README names Claude Code, Cursor, Codex, Gemini CLI, GitHub Copilot and Windsurf, among more than 60 agents.

What licence is the toolchain under?

MIT.

Is Skillmd free?

Yes. Skillmd is open source, so you can use and self-host it for free.

How do I add Skillmd to Claude Code?

Run this command in your terminal: claude mcp add --transport http skillmd https://api.skillmd.com/mcp

What are the best alternatives to Skillmd?

The closest alternatives to Skillmd are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

Alternatives to Skillmd

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 464K GitHub stars
    • Developer tools
  2. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  3. GitHub

    MCP server

    Official MCP server connecting AI assistants to GitHub repos, issues and workflows

    Not checked yet
    • Remote
    • Open source
    • 34.5K GitHub stars
    • Developer tools
  4. MCP toolkit giving coding agents symbol-level code retrieval and editing

    Runs locally
    • Open source
    • 31.5K GitHub stars
    • Developer tools
  5. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory
  6. Ouroboros

    MCP server

    Spec-first layer that pins requirements and verifies results of AI coding agent work

    Runs locally
    • Open source
    • 6.4K GitHub stars
    • Developer tools