csklint 0.1.0

The linter for Claude Code skill.

Claude Skill Lint

The linter for Claude Code skill.

Advantage

• Wraps two purpose-built validators — skill-validator for SKILL.md structure and frontmatter, and markdownlint-cli2 for Markdown hygiene — behind a single command, so you don't need to discover, install, and orchestrate them yourself.
• csklint install fetches and installs both tools (a Go binary and an npm package) for you, verifying the binary's SHA-256 checksum before installing it, on macOS, Debian, and Ubuntu.
• csklint run executes as a pytest suite, so failures show up as familiar pytest output and slot straight into CI pipelines or pre-commit hooks without extra tooling.

Quickstart

Install the CLI:

pip install csklint

Install the tools it depends on (skill-validator and markdownlint-cli2):

csklint install

Lint your skills (defaults to ~/.claude/skills):

csklint run

A passing run prints a pytest summary ending in ... passed; a failing skill reports the offending file and the validator's error output.

How do I...

How do I lint skills in a different directory?

Pass the directory as an argument:

csklint run path/to/skills

How do I use this in CI?

Run csklint install once per CI run, then csklint run <skills_dir>; both exit non-zero on failure so the step fails the build.

- run: csklint install
- run: csklint run skills/

How do I install without root privileges?

csklint install writes skill-validator to /usr/local/bin, which typically requires root. Re-run the command with sudo if it reports a permission error.

Credits

This package was created with Cookiecutter and the yukihiko-shinoda/cookiecutter-pypackage project template.