v0.1.0 — first release
First public release of claude-skill-lint — a zero-dependency linter for Claude Code skills.
What it does
Audits a ~/.claude/skills directory and flags:
- broken / missing frontmatter (
name,description) - over-long descriptions (loaded into context on every turn)
- bloated bodies that should use progressive disclosure
- dead
reference/links - stale Claude model IDs
Counts only real skills — a top-level <name>.md or a <dir>/SKILL.md.
Highlights
- Zero dependencies (Python 3.8+)
- JSON output, configurable thresholds, non-zero exit on errors (CI / pre-commit friendly)
- 9-test suite + GitHub Actions CI
Install
curl -O https://raw.githubusercontent.com/gesh75/claude-skill-lint/main/skill_lint.py
chmod +x skill_lint.pyMIT licensed.