SkillMD documentation

SkillMD is the open, safety-reviewed registry of Agent Skills. A skill is one SKILL.md file that any compatible agent loads on demand. Learn the format, install skills from the CLI, and wire the registry into your agent over MCP.

Get started Read the format spec Browse skills

Guides

Start

Getting started

Install the CLI and add your first skill, or scaffold and publish one of your own.

Reference

SKILL.md format

The frontmatter fields, body rules, lint checks, and quality score a skill is measured against.

Reference

CLI reference

Every skillmd command and flag: lint, scan, search, add, publish, and more.

Integrate

MCP server

Connect the registry to Claude, Cursor, and other MCP clients. Seven tools over stdio.

Quick start

Install the CLI, find a verified skill, and drop it into your agent's skills directory:

# install the CLI
npm i -g skillmds

# find a skill, then add it to your agent
skillmd search "pdf extraction" --verified
skillmd add anthropic/docx -a claude-code

No -a flag? The CLI installs to whichever agent directories it detects, defaulting to Claude Code. See the CLI reference.

Per-agent guides

Each agent keeps skills in its own directory. These guides are plain text, so an agent can read them directly over HTTP:

Claude Code

.claude/skills

Cursor

.cursor/skills

Codex

.codex/skills

Windsurf

.windsurf/skills

OpenCode

.opencode/skills

All agents

Index of every guide.

For machines

Building an agent that reads SkillMD directly? Two entry points are designed for you:

/llms.txt: a compact, linkable map of the registry and its API.
https://api.skillmd.com/v1/search?q=<query>: JSON search that returns a raw_url per result, a direct fetch of the installable SKILL.md.