# Skillmd

> Skillmd is an open-source MCP server for developer tools. Search, fetch, lint and install SKILL.md agent skills from the SkillMD registry. It can run locally on your machine or as a hosted remote server.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, API
- **Website:** https://skillmd.com
- **Repository:** https://github.com/skillmds/skillmd
- **MCP Registry name:** com.skillmd/skillmd
- **Categories:** developer tools
- **Listing updated:** 2026-11-14

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://api.skillmd.com/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "skillmd": {
      "url": "https://api.skillmd.com/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

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

## 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

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/skillmd
