cyberneticlibrary

Validate Claude Code skill files

claude-skill-lintskillsetup L10
shinytoyrobots/claude-skills-linter
What it does

Validate Claude skill files for structural defects

Best for

Production skill repos need deterministic validation before publishing; catches hallucinated context bugs CI cannot see.

Inputs
  • · skill directory path
  • · config file (auto-detect)
Outputs
  • · error/warning report (stdout/JSON)
  • · exit code
Requires
  • · Node.js 20+
Preconditions

npm or npx installed; Node 20+

Failure modes
  • · Missing config → auto-detect fails
  • · Circular dependencies undetected if indirect
Trust signals
  • · Real 139-file suite: 32 broken refs + 11 orphans caught <2s
  • · Anthropic official skills: 14 errors + 24 warnings across 72 files