Search, fetch, lint, and install Agent Skills (SKILL.md) from the SkillMD registry.
Quick Install
Automated & IDE SetupCopy the AI prompt to install this server into Claude Code, Cursor, or another agent — or use 1-click editor setup below.
One-click editor setup isn’t available for this listing yet — we don’t have a confirmed install command, and we’d rather show nothing than point your editor at the wrong package or host. Follow the project’s own setup instructions, linked above.
Manual Client & Custom JSON ConfigExpand JSON â–¾
No confirmed setup config for this listing yet. We only publish a config block when the install details come from the project itself — its README, its docs, or a verified owner. We haven’t found those for skillmd, and we’d rather show nothing than a guess you’d paste into your client. Follow the project’s own setup instructions for the current steps.
Documentation Overview
SkillMD
The registry that lints.
Search, install, lint and publish Agent Skills (SKILL.md) for Claude Code, Cursor, Codex and 60+ other agents.
This repo is the open-source toolchain behind skillmd.com: the CLI, the MCP server, the GitHub Action and the SKILL.md engine they share.
Browse skills · Categories · Publishers · Install guides · Docs · Blog · Stats
What this is
An Agent Skill is a folder with a SKILL.md file: YAML frontmatter (name, description) plus Markdown instructions an agent loads on demand. Claude Code, Cursor, Codex, Gemini CLI, GitHub Copilot, Windsurf and dozens of other agents read the same format, which is what makes a shared registry worth having. If the format is new to you, start with What is an Agent Skill? and the anatomy of a SKILL.md file.
skillmd.com is the open registry of those skills: 25,000+ skills from 470+ publishers, every one of them linted against the format, security-scanned for what it can do, and pinned to a commit. Verdicts, capability flags and independent scanner results sit on every skill page. Installing writes files and does nothing else.
This repository is everything that runs on your machine or in your CI, MIT-licensed:
| Package | What it is | Install |
|---|---|---|
skillmds | One npm package, two binaries: the skillmd CLI and the skillmds MCP server | npm i -g skillmds |
@skillmds/core | The SKILL.md engine: parser, lint rules, security scanner, quality score, SARIF / JSON / GitHub formatters | npm i @skillmds/core |
skillmds/skillmd/action | GitHub Action: lint every skill in a repo, results in GitHub Code Scanning | uses: skillmds/skillmd/action@v1 |
The registry applies the same engine, so a skill that passes locally passes on publish.
Quick start
Plugins
A plugin is a bundle of skills that installs as one unit. In Claude Code it becomes a
real plugin — /plugin lists it, and enable, disable and uninstall work on the whole
set — and on every other agent the skills are installed individually.
To browse them inside Claude Code's Plugins tab instead, add this repository as a
marketplace: skillmds/skillmd. It carries the flagship plugins as real directories
under plugins/, listed in
.claude-plugin/marketplace.json and refreshed
weekly. The tab only understands plugins that live in git, which is why the whole
registry is not in there — every other plugin installs with the command above.
No account needed for any of the above. Skills land in each detected agent's own directory (.claude/skills/, .cursor/skills/, .agents/skills/, …). Per-agent walkthroughs: Claude Code · Cursor · Codex · Gemini CLI · GitHub Copilot · Windsurf · all agents.
The CLI: skillmd
| Command | What it does |
|---|---|
skillmd lint [path] | Validate SKILL.md files. Diagnostics, a 0–100 quality score, --fix for the mechanical ones. |
skillmd scan [path] | What would this skill do? Reports scripts, network calls and secret access. |
skillmd rules [id] | List the lint rules, or explain one. |
skillmd init [name] | Scaffold a new skill from a template. |
skillmd search <query> | Search the registry from the terminal. |
skillmd add <source> | Install from a registry slug, a GitHub repo or a local path. Lints first, never executes scripts. |
skillmd list / remove / update | Manage installed skills across agents. |
skillmd publish [path] | Publish to skillmd.com. Blocked on lint errors. |
skillmd add detects 68 agents by their config directories: Claude Code, Cursor, Codex, Windsurf, OpenCode, Gemini CLI, Antigravity, Kiro, Warp, GitHub Copilot, Cline, Roo Code, Goose, Trae, Qwen Code, Amp, Zed, Continue, Devin, OpenHands, Replit and more. Agents that share the .agents/skills convention are written once. Running plain skillmd opens a guided menu.
Full reference: docs/cli.md · CLI docs on skillmd.com · How one SKILL.md works in every agent
The MCP server: skillmds
Give any MCP-capable agent the whole registry. It can search, inspect, lint and install skills mid-conversation.
Or use the hosted remote server, zero install, streamable HTTP:
| Tool | What the agent gets |
|---|---|
skillmd_search | Registry search with categories, ratings and install snippets |
skillmd_get | Full skill detail: body, provenance, license, security flags |
skillmd_install | Safe install: validated, SHA-256-verified, zip-slip-guarded, never executes scripts |
skillmd_trending / skillmd_recommend | Leaderboard and similar-skill suggestions |
skillmd_list_saved | Your saved skills (with SKILLMD_TOKEN) |
skillmd_lint | Validate any SKILL.md content on the spot |
Full reference: docs/mcp.md · MCP docs on skillmd.com · Using SkillMD over MCP · MCP registry entry: com.skillmd/skillmd
The engine: @skillmds/core
Nine lint rules, a line-aware security scanner, a 0–100 quality score and SARIF / JSON / GitHub-annotation formatters. ESM, typed, no runtime dependency beyond yaml, runs in Node, browsers and edge runtimes.
The scanner classifies every skill into capability flags you can filter or deny on install:
| Flag | Meaning |
|---|---|
docs_only | Nothing executable found. Pure instructions. |
network_calls | Fetches, curls or otherwise talks to the network. |
executes_scripts | Runs commands or bundled scripts. |
reads_secrets | Touches env vars, tokens or credential files. |
untrusted_install | Fetch-and-execute from a non-standard source. |
Rules and scoring: docs/rules.md · Debugging skills: lint, scan, score · Common SKILL.md mistakes
CI for your skills
Lints every skill in the repo and uploads SARIF to GitHub Code Scanning, so findings show up in pull requests. Full example: examples/github-action.yml · action/README.md
Publishing a skill
Published skills get a page at skillmd.com/skills/<you>/<name>, a safety verdict, an install command for every agent, and a live README badge:
Related MCP Servers
Reviews
No reviews yet — be the first to share how this listing worked for you.
Frequently Asked Questions about Skillmd
AllMCPs Directory Badge
Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.
Badge Style:
Live Dynamic SVG Preview
Markdown (GitHub README)
[](https://allmcps.com/mcp/skillmd)HTML Embed
<a href="https://allmcps.com/mcp/skillmd"><img src="https://allmcps.com/api/badge/skillmd?style=directory" alt="Skillmd on AllMCPs" /></a>