skill-lint — Claude Code subagent: what it does, how to install
skill-lint audits SKILL.md files against seven structural quality dimensions, fixing critical defects immediately and flagging minor issues for approval.
no license ★ 276 updated 2026-10-29
/plugin marketplace add gupsammy/Claudest
/plugin install claude-skills@ClaudestWhat skill-lint does
The subagent inspects SKILL.md files after new skills are created or updated. It reviews YAML frontmatter, execution parameters, prompt token density, workflow stages, and directory completeness. It also looks for code snippets that should run as scripts instead of model instructions.
Fixes are split by severity. Critical and major issues get applied automatically without prompts. Minor formatting choices or missing optional folders appear in a summary table so you decide whether to patch them. Once done, the agent verifies changes against a quality checklist.
This agent depends on reference guides inside the plugin directory and saves run summaries into project MEMORY.md. It rejects agent definitions such as AGENT.md because they follow a separate contract.
What it helps with
- audit SKILL.md against structural quality standards
- patch critical YAML frontmatter mistakes automatically
- trim verbose token overhead from skill descriptions
- separate deterministic code blocks into standalone scripts
Example prompts for the agent
- Run skill-lint on
skills/deploy-app/SKILL.md - Audit the new skill in
skills/extract-dataand fix major issues - Check
SKILL.mdstructure and report minor warnings
How to install skill-lint
1Plugin marketplace
/plugin marketplace add gupsammy/Claudest/plugin install claude-skills@Claudest2Manually: put the files in place
.claude/agents/skill-lint.mdFor all projects use ~/.claude/agents/. Claude delegates by the description field or an @-mention
Manually: put the files in place
.codex/agents/skill-lint.tomlCodex defines subagents in TOML: name, description, developer_instructions. Move the Markdown text into developer_instructions by hand. For all projects use ~/.codex/agents/
Manually: put the files in place
.cursor/agents/skill-lint.mdCursor also reads .claude/agents/
Step by step, with commands for each platform: Claude Code subagents: how to create one, call it and keep context clean
Questions about skill-lint
How to install skill-lint in Claude Code?
Run /plugin marketplace add gupsammy/Claudest first, then run /plugin install claude-skills@Claudest.
What does skill-lint do?
It audits a skill's SKILL.md across seven dimensions, automatically rewrites critical and major structural flaws, and asks before changing minor style details.
Can skill-lint audit agent definitions?
No, the linter explicitly declines AGENT.md files because agents adhere to a different structural contract.