# Using SkillMD Skills with Claude Code

> skillmd.com is an open registry of Agent Skills (SKILL.md files). Every listed skill passes a safety review before it is publicly visible. This guide covers Claude Code.

## Where Claude Code looks for skills
- Project scope: ./.claude/skills/<skill-name>/SKILL.md
- Global scope: ~/.claude/skills/<skill-name>/SKILL.md

## Install a skill (CLI)
npm i -g skillmds
skillmd add <owner>/<name> -a claude-code        # project scope
skillmd add <owner>/<name> -a claude-code -g     # global scope

## Install a skill (manual)
Copy the SKILL.md from https://skillmd.com/skills/<owner>/<name> into .claude/skills/<skill-name>/SKILL.md.

## Install via MCP
claude mcp add skillmds -- npx -y skillmds
Then ask the agent to install a skill by name.

## Find skills
- https://skillmd.com/search?q=<query>
- JSON API: https://api.skillmd.com/v1/search?q=<query>
- Human guide: https://skillmd.com/agents/claude-code
- All agent guides: https://skillmd.com/agents.txt