skillmds

Agent Skills는 AI 에이전트에게 새로운 워크플로우를 가르치는 Markdown 파일(SKILL.md)입니다. SkillMD는 린트를 수행하는 레지스트리입니다. 모든 스킬은 검증되고, 보안 점검을 거치며, 콘텐츠가 고정(pin)됩니다. 그리고 이 저장소는 그 일을 처리하는 도구 모음으로, 여러분의 컴퓨터와 레지스트리에서 동일한 엔진을 실행합니다.

CLI

npm i -g skillmds

skillmd lint .                 # validate SKILL.md files — diagnostics + quality score
skillmd scan .                 # what would this skill do? scripts, network, secrets
skillmd search "pdf tools"     # search the registry
skillmd add anthropic/pdf      # install — lints first, never executes scripts
skillmd init my-skill          # scaffold a new skill
skillmd publish ./my-skill     # publish to skillmd.com (blocked on lint errors)

skillmd add는 68개의 에이전트를 자동으로 지원합니다 — Claude Code, Cursor, Codex, Windsurf, Gemini CLI, GitHub Copilot, Cline, Goose, Zed 등 — 머신에서 감지된 모든 에이전트에 해당 에이전트의 디렉터리 규칙에 따라 각 스킬을 기록합니다. skillmd만 입력하면 안내형 대화형 메뉴가 열립니다.

전체 문서: docs/cli.md

Related MCP server: SkillFlow MCP Server

MCP 서버

MCP를 지원하는 모든 에이전트에게 전체 레지스트리를 제공하세요 — 대화 도중에 스킬 검색, 검사, 린트, 설치가 가능합니다:

• # Claude Code
  claude mcp add skillmd -- npx -y skillmds

• // Claude Desktop, Cursor, VS Code, … (examples/mcp/ has per-client files)
  { "mcpServers": { "skillmd": { "command": "npx", "args": ["-y", "skillmds"] } } }

또는 호스팅된 원격 서버를 사용하세요 — 설치가 필요 없고, 스트리밍 HTTP로 동작합니다:

• https://api.skillmd.com/mcp

전체 문서: docs/mcp.md · 레지스트리 항목: com.skillmd/killmd

엔진

npm i @skillmd/core

import { lint } from "@skillmd/core";

const { ok, score, diagnostics, security } = lint(rawSkillMd, { slug: "my-skill" });

Nine 9개 릐트 규칙, 안전한 라인 단위 보안 스너 (network_calls, executes_scripts, reads_secrets, …), 0–100 품질 점수, 및 SARIF/JSON/GitHub 엔notation 포맷를 정합. ESModules, typed, json 외에 의존 없고, Node/brows/엣지 환경에서 안정적인 실행 보장. 규칙 정의: docs/rules.md

스킬을 위한 CI

- uses: skillmds/skillmd/action@v1
  with:
    path: .

저장소 내 모든 스킬을 린트하고 SARIF를 GitHub Code Scanning에 업로드합니다 — PR에서 발견 사항을 바로 확인하세요. 전체 예시: examples/github-action.yml

레지스트리 API

여기의 모든 것은 api.skillmd.com의 공개 API를 위한 가벼운 클라이언트입니다 — GET /v1/search?q=… 식으로 직접 호출할 수 있고, docs/registry-api.md, https://skillmd.com/openapi.json, https://skillmd.com/llms.txt 에서 사용법을 확인 있습니다.

보안 모델

스킬 설치 시 파일만 쓰고 다른 작업은 수행하지 않는다: 스크립트는 은 실하지 않으며, 엄격한 을드링 제한(slug 검증 + zip-slip 가드), , registry의 콘텐츠-주고(e.g.) 토에 대한 SHA-256 무결성 검증, 및 GitHub raw 호스트 pin된 동반 다운로드를 합니다. 자세한 내용은 SECURITY.md 을 참고 — 취약점 보안은 hi@skillmd.com 으로 보네 주세요.

개발

npm ci
npm run build      # @skillmd/core, then skillmds
npm test           # vitest across both packages (19 test files, incl. an MCP stdio smoke test)
npm run typecheck  # strict tsc

구조, PR 가인드라인, 출시 절차는 CONTRIBUTING.md 을 참고하세요.

라이선스

MIT © SkillMD