agentskills
CLI to lint, validate, and install Agent Skills (SKILL.md) from the SkillMD registry.
npx agentskills lint ./my-skill
npm i -g agentskills
Commands
agentskills lint [path] (check) | Validate SKILL.md files; print diagnostics and a quality score. |
agentskills scan [path] | Report scripts, network calls, and secret access. |
agentskills rules [id] | List lint rules. |
agentskills init [name] | Create a SKILL.md from a template. |
agentskills search <query> | Search the registry. |
agentskills add <source> | Install a skill (registry slug, GitHub repo, or local path). Lints first. |
agentskills list (ls) | List installed skills. |
agentskills remove <names...> (rm) | Remove installed skills. |
agentskills update [names...] | Update installed skills. |
agentskills publish [path] (submit) | Publish to the registry. Exits non-zero on lint errors. |
agentskills login / logout | Store or remove a token. |
All commands accept --json.
Lint formats: text (default), json, sarif, github. Exit codes: 0 clean, 1 errors (or warnings with --strict).
This package shares its engine with skillmds, which also provides an MCP server.