SkillMD

Lint, search, and install Agent Skills — a CLI, an MCP server, and the SKILL.md engine behind skillmd.com.

---

Agent Skills are Markdown files (`SKILL.md`) that teach AI agents new workflows. SkillMD is **the registry that lints**: every skill is validated, security-scanned, and content-pinned — and this repo is the toolchain that does it, the same engine on your machine and on the registry.

Package	What it is
`skillmds`	One npm package, two binaries: the skillmd CLI and the skillmds MCP server
`@skillmd/core`	The SKILL.md engine: parser, lint rules, security scanner, quality score, SARIF/JSON/GitHub formatters
`skillmds/skillmd/action`	GitHub Action: lint skills in CI, results in GitHub Code Scanning

The 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 registr