SkillMD 레지스트리에서 Agent Skills (SKILL.md)를 검색, 검사, 린트 및 설치할 수 있도록 지원합니다.
다른 이름 skillmds/SkillMD, get-skill, skillmds
- 스타
- 144
- Tools
- 5
- 다운로드, 30일
- 1,111
- 최신 버전
- 1.3.11
- 마지막 커밋
- 2026년 11월 10일
- 라이선스
- MIT
SkillMD MCP란?
SkillMD 레지스트리에서 Agent Skills (SKILL.md)를 검색, 검사, 린트 및 설치할 수 있도록 지원합니다. 5개 도구를 제공합니다. 예: skillmd_search, skillmd_get, skillmd_download.
프로젝트 README에서 생성된 요약
SkillMD MCP server 정보
skillmd를 사용하면 AI 클라이언트 내부에서 특화된 에이전트 지침을 검색하고 설치할 수 있습니다. 이 MCP server는 100만 개 이상의 Agent Skills가 포함된 오픈 레지스트리에 대한 접근을 제공합니다. 여기서 Agent Skills는 Claude Code, Cursor, Windsurf와 같은 에이전트에게 특정 기능을 부여하도록 설계된 SKILL.md 파일입니다. 개발자는 대화창을 벗어나지 않고도 채팅 인터페이스를 통해 직접 스킬을 찾고, 검사하고, 배포할 수 있습니다.
사용자는 npx를 이용한 로컬 설치 또는 호스팅된 원격 서버를 통해 연결할 수 있습니다. 이 서버에는 레지스트리 검색, 상세 스킬 정보 조회, 그리고 SHA-256 검증을 거치며 스크립트를 실행하지 않는 안전한 설치 도구가 포함되어 있습니다. 또한 품질과 보안을 보장하기 위해 콘텐츠를 즉석에서 린트하는 기능도 지원합니다. SKILLMD_TOKEN이 있는 사용자는 저장된 스킬을 관리할 수 있으며, 보안 모델은 capability 플래그를 사용하여 스킬이 네트워크 호출을 수행하는지, 스크립트를 실행하는지, 또는 비밀 정보를 읽는지 식별합니다.
프로젝트의 README를 바탕으로 작성되었습니다. 모든 활용 사례는 해당 내용의 인용문과 대조하여 확인합니다.
SkillMD MCP 설치 방법
형식 확인: 2026년 11월 10일Cursor에 추가Goose에 추가Claude Code에 SkillMD MCP 설치
$ claude mcp add --env 'SKILLMD_TOKEN=<YOUR_SKILLMD_TOKEN>' skillmd -- npx -y get-skillCursor에 SkillMD MCP 설치
~/.cursor/mcp.json
{
"mcpServers": {
"skillmd": {
"command": "npx",
"args": [
"-y",
"get-skill"
],
"env": {
"SKILLMD_TOKEN": "<YOUR_SKILLMD_TOKEN>"
}
}
}
}VS Code에 SkillMD MCP 설치
.vscode/mcp.json
{
"servers": {
"skillmd": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"get-skill"
],
"env": {
"SKILLMD_TOKEN": "<YOUR_SKILLMD_TOKEN>"
}
}
}
}VS Code CLI에 SkillMD MCP 설치
$ code --add-mcp '{"name":"skillmd","type":"stdio","command":"npx","args":["-y","get-skill"],"env":{"SKILLMD_TOKEN":"<YOUR_SKILLMD_TOKEN>"}}'Claude Desktop에 SkillMD MCP 설치
claude_desktop_config.json
{
"mcpServers": {
"skillmd": {
"command": "npx",
"args": [
"-y",
"get-skill"
],
"env": {
"SKILLMD_TOKEN": "<YOUR_SKILLMD_TOKEN>"
}
}
}
}Codex에 SkillMD MCP 설치
$ codex mcp add skillmd --env 'SKILLMD_TOKEN=<YOUR_SKILLMD_TOKEN>' -- npx -y get-skillCodex config.toml에 SkillMD MCP 설치
~/.codex/config.toml
[mcp_servers.skillmd] command = "npx" args = ["-y", "get-skill"] [mcp_servers.skillmd.env] SKILLMD_TOKEN = "<YOUR_SKILLMD_TOKEN>"
Gemini CLI에 SkillMD MCP 설치
$ gemini mcp add -s user -e 'SKILLMD_TOKEN=<YOUR_SKILLMD_TOKEN>' skillmd npx -- -y get-skillGemini settings.json에 SkillMD MCP 설치
~/.gemini/settings.json
{
"mcpServers": {
"skillmd": {
"command": "npx",
"args": [
"-y",
"get-skill"
],
"env": {
"SKILLMD_TOKEN": "<YOUR_SKILLMD_TOKEN>"
}
}
}
}HostedMCP가 2026년 11월 16일에 실행 확인
get-skill 1.3.11을(를) 네트워크와 키가 없는 격리된 컨테이너에서 이 명령으로 실행했습니다. 응답하며 도구 7개를 보여 주었습니다.
SkillMD MCP 도구 5
tools/list로 서버에서 직접 읽음skillmd_search읽기 전용Search the SkillMD registry of Agent Skills (SKILL.md files) by task, name or keywords. Returns matching skills with their owner/name slug, description, category, safety verdict and install snippet, best match first.
skillmd_get읽기 전용Fetch one skill by owner/name slug: description, SKILL.md body, provenance (source repo and pinned commit), license, safety verdict and capability flags, plus companion file listing for packs.
skillmd_download읽기 전용Return the full contents of any public skill by owner/name slug: the SKILL.md text plus every companion file for packs, ready to write to disk. Skills are plain-text instructions an agent reads on demand; nothing executes, and every listed skill has passed SkillMD's safety review.
skillmd_trending읽기 전용Top skills on the SkillMD leaderboard, ranked by installs, saves and ratings, optionally within one category and time window.
skillmd_recommend읽기 전용Recommend skills. With based_on set to a skill's owner/name slug, returns the top skills in that skill's category (excluding itself); without it, returns what is trending over the last 30 days.
| skillmd_search | Search the SkillMD registry of Agent Skills (SKILL.md files) by task, name or keywords. Returns matching skills with their owner/name slug, description, category, safety verdict and install snippet, best match first. | 읽기 전용 |
| skillmd_get | Fetch one skill by owner/name slug: description, SKILL.md body, provenance (source repo and pinned commit), license, safety verdict and capability flags, plus companion file listing for packs. | 읽기 전용 |
| skillmd_download | Return the full contents of any public skill by owner/name slug: the SKILL.md text plus every companion file for packs, ready to write to disk. Skills are plain-text instructions an agent reads on demand; nothing executes, and every listed skill has passed SkillMD's safety review. | 읽기 전용 |
| skillmd_trending | Top skills on the SkillMD leaderboard, ranked by installs, saves and ratings, optionally within one category and time window. | 읽기 전용 |
| skillmd_recommend | Recommend skills. With based_on set to a skill's owner/name slug, returns the top skills in that skill's category (excluding itself); without it, returns what is trending over the last 30 days. | 읽기 전용 |
구성
SKILLMD_TOKEN비밀SkillMD personal access token (enables skillmd_list_saved and personalized recommendations)
SKILLMD_APIOverride the registry API base URL
| 이름 | 설명 | 유형 |
|---|---|---|
| SKILLMD_TOKEN | SkillMD personal access token (enables skillmd_list_saved and personalized recommendations) | 비밀 |
| SKILLMD_API | Override the registry API base URL |
자동 검사
2026년 11월 16일에 실행됨전체 보고서 →자동 검사를 통과했습니다. 이는 보안 감사가 아닙니다. 코드를 직접 읽고 서버에 필요한 최소한의 권한만 부여하십시오. 검사 방식
- 소스 저장소 연결 및 접근 가능skillmds/skillmd is public and reachablegithub.com/skillmds/skillmd ↗통과
- 패키지가 이 저장소를 소스로 명시get-skill, skillmds name skillmds/skillmd as sourcenpmjs.com/package/get-skill ↗통과
- 빌드 출처(Sigstore 증명)Sigstore attestation for get-skill, skillmdsnpmjs.com/package/get-skill/v/1.3.11#provenance ↗통과
- 오픈 소스 라이선스 (OSI)MITspdx.org/licenses/MIT.html ↗통과
- 최근 1년 내 커밋 또는 릴리스Last commit or release 2026-11-10github.com/skillmds/skillmd ↗통과
- OpenSSF Scorecard검사되지 않음
- 패키지 이름이 인기 패키지와 유사하지 않음No popular package one edit away from get-skill, skillmds통과
- 패키지 및 해당 종속성에 중요한 보안 권고 없음107 resolved dependencies checked; no critical advisoryosv.dev ↗통과
- 모델에 대한 숨겨진 지침 없음5 tool descriptions and the README read; no override phrases, credential paths or hidden characters통과
- 파괴적인 도구에 라벨 표시됨No tool named like delete, drop or exec통과
- 원격 엔드포인트가 MCP 핸드셰이크에 응답initialize answered with protocol 2025-06-18 in 200 ms; tools/list returned 5 tools통과
README
GitHub에서 보기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: 1,000,000+ skills from 30,000+ 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 |
|---|---|---|
get-skill |
One npm package: the CLI and the MCP server (get-skill, also installed as skillmd) |
npm i -g get-skill |
@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
# Search the registry and install a skill into every agent on your machine
npx get-skill search "pdf"
npx get-skill add anthropic/pdf
# Lint your own skill before you share it
npx get-skill lint ./my-skill
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.
npx get-skill add plugin:skillmd/design
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
npm i -g get-skill
| 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 lint . --format sarif > skillmd.sarif # GitHub Code Scanning
skillmd lint . --strict # warnings fail too
skillmd add owner/repo -a claude-code -g # one agent, global scope
skillmd add some/skill --deny executes_scripts # refuse skills that run code
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: get-skill
Give any MCP-capable agent the whole registry. It can search, inspect, lint and install skills mid-conversation.
# Claude Code
claude mcp add skillmd -- npx -y get-skill
// Claude Desktop, Cursor, VS Code, Windsurf, … (examples/mcp/ has per-client files)
{ "mcpServers": { "skillmd": { "command": "npx", "args": ["-y", "get-skill"] } } }
Or use the hosted remote server, zero install, streamable HTTP:
https://api.skillmd.com/mcp
| 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
npm i @skillmds/core
import { lint } from "@skillmds/core";
const { ok, score, diagnostics, security } = lint(rawSkillMd, { slug: "my-skill" });
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
- uses: skillmds/skillmd/action@v1
with:
path: .
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
skillmd login # token from your skillmd.com account
skillmd publish ./my-skill # blocked on lint errors
skillmd publish ./my-skill --dry-run
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:
[](https://skillmd.com/skills/<you>/<name>)
Guides: Publishing a skill to the registry · Writing skills that get used · What a verified badge means · Skill packs
The registry API
Everything here is a thin client over the public API at api.skillmd.com (GET /v1/search?q=…, GET /v1/skills/<owner>/<name>, …). Described by docs/registry-api.md, skillmd.com/openapi.json and, for AI systems, skillmd.com/llms.txt. Every skill page also has a Markdown twin at …/<name>.md.
What's in the registry
Browse by category: Coding & Dev Tools · AI & ML · DevOps & Infra · Integrations & APIs · Security · Data & Analytics · Web & Frontend · Productivity · Docs & Writing · Design & Media
Or by publisher, official skills from verified publishers, the leaderboard, or what's new. Live counts: skillmd.com/stats.
Security model
Installing a skill writes files and does nothing else. No script execution, strict path containment (slug validation plus zip-slip guards), SHA-256 integrity verification against the registry's content-addressed store, and companion files pinned to GitHub raw hosts. Publishing runs the same lint and scan the CLI does, and every listed skill shows its verdict, capability flags and independent scanner results.
Details in SECURITY.md. Report vulnerabilities to hi@skillmd.com.
Learn more
- The complete guide to AI agent skills
- Agent Skills vs MCP servers
- Claude Code skills vs plugins vs subagents vs commands
- Cursor rules vs Cursor skills
- The case for an open skill format
- Glossary · The SKILL.md format · Getting started
Development
npm ci
npm run build # @skillmds/core, then skillmds
npm test # vitest across both packages, incl. an MCP stdio smoke test
npm run typecheck # strict tsc
See CONTRIBUTING.md for layout, PR guidelines and the release process, and CODE_OF_CONDUCT.md.
License
MIT © SkillMD · skillmd.com · hi@skillmd.com
SkillMD MCP 질문
SkillMD MCP를 Claude Code에 추가하려면 어떻게 하나요?
터미널에서 claude mcp add --env 'SKILLMD_TOKEN=<YOUR_SKILLMD_TOKEN>' skillmd -- npx -y get-skill를 실행합니다. 모든 프로젝트에서 사용할 수 있게 하려면 --scope user를 추가합니다.
SkillMD MCP를 Cursor에 추가하려면 어떻게 하나요?
~/.cursor/mcp.json를 열고 mcpServers 아래에 서버를 추가합니다. 위 설치 섹션에 표시된 Cursor 구성을 사용합니다.
SkillMD MCP는 어떤 도구를 제공하나요?
5개 도구를 제공합니다. 예: skillmd_search, skillmd_get, skillmd_download, skillmd_trending, skillmd_recommend.
SkillMD MCP server는 어떤 도구를 제공하나요?
레지스트리 검색, 상세 스킬 정보 조회, 안전한 설치, 트렌드 및 추천, 저장된 스킬 관리, 즉석 린트 도구를 제공합니다.
스킬을 설치하면 스크립트가 실행되나요?
아니요. 설치 시 파일만 작성하며, SHA-256 무결성 검증 및 zip-slip 경로 방지 기능을 수행합니다. 스크립트는 절대 실행하지 않습니다.
MCP를 통해 SKILL.md 파일을 린트할 수 있나요?
네, skillmd_lint 도구를 사용하여 모든 SKILL.md 콘텐츠를 즉석에서 검증할 수 있습니다.
스킬을 검색하고 설치하려면 계정이 필요한가요?
검색이나 설치에는 계정이 필요하지 않습니다. 토큰은 저장된 스킬 목록 조회나 게시와 같은 작업에만 사용됩니다.