Claude Skill Lint
The linter for Claude Code skill.
Advantage
- Wraps two purpose-built validators — skill-validator for
SKILL.mdstructure and frontmatter, andmarkdownlint-cli2for Markdown hygiene — behind a single command, so you don't need to discover, install, and orchestrate them yourself. csklint installfetches 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 runexecutes 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.
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file csklint-0.1.1.tar.gz.
File metadata
- Download URL: csklint-0.1.1.tar.gz
- Upload date:
- Size: 17.4 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/6.1.0 CPython/3.13.12
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
d73b8e2e6d3db996949dc0fd8a8b6d9826f15fd85884d28c4d2f3ab49196370c
|
|
| MD5 |
c9bdb52cd9c45a2f15a78313ecf88268
|
|
| BLAKE2b-256 |
f5dcdb8c2ccd6f0d7dbb2a94b9be429b1d0bdb0081ab98be55053ff7cb0ed3b1
|
File details
Details for the file csklint-0.1.1-py3-none-any.whl.
File metadata
- Download URL: csklint-0.1.1-py3-none-any.whl
- Upload date:
- Size: 11.4 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/6.1.0 CPython/3.13.12
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
b8340a05e60d3f157a2c15181c0a1b552169c8ee34fc190be913ba51bf761356
|
|
| MD5 |
ef1932875a79920b6efdea77c68870fa
|
|
| BLAKE2b-256 |
37d932165b2d8fd3537c27f4952ecd6d5a615a93c6da64078e8bc7975a1355e5
|
