Claude Skill Check — Development skill for Claude Code
Linter for Claude Code SKILL.md files.
How to install Claude Skill Check
This entry records only its repository, not the path inside it, so there is no
exact command to give. Open MukundaKatta/claude-skill-check and copy the folder into
~/.claude/skills/, or the file into ~/.claude/agents/.
What Claude Skill Check does
Linter for Claude Code SKILL.md files. Python port of the skillint npm package.
Alternatives in Development
- npm 71.9k ★
- Tau — A Python port of Pi’s minimalist coding agent 2.5k ★
- Claude Code Src — 2026.3.31 claude code 意外把包含源码的文件上传到 npm 仓库,版本号是 2.1.88,其中 cli.js.map 文件有 57MB 的体积,claude code 的源码在该文件的 sources 2.2k ★
README
claude-skill-check
[](https://github.com/MukundaKatta/claude-skill-check/actions/workflows/ci.yml) [](https://pypi.org/project/claude-skill-check/) [](https://pypi.org/project/claude-skill-check/) [](LICENSE)
A small Python linter for [Claude Code](https://claude.ai/code) `SKILL.md` files. It checks:
- YAML frontmatter is present and parses cleanly
nameanddescriptionare presentnameis lowercase kebab-case, 1-64 chars, starts with a letterdescriptionlength is reasonable (20-1024 chars after trimming)allowed-toolsis either a string or a list of strings- Common secret patterns (Anthropic/OpenAI keys, AWS access keys, GitHub tokens, PEM blocks) are not leaked in the file
- Unknown frontmatter fields get a warning
- Empty body gets a warning
Install
pip install claude-skill-check
Usage
Lint a single file:
claude-skill-check path/to/SKILL.md
Lint every `SKILL.md` under a directory:
claude-skill-check path/to/skills-dir/
Exit status: `0` on no errors, `1` on any errors, `2` when no skill files were found.
Only show errors
claude-skill-check --quiet path/to/skills-dir/
Use as a library
from claude_skill_check import validate_skill_file
result = validate_skill_file("path/to/SKILL.md")
if not result.ok:
for issue in result.errors:
print(issue.code, issue.message)
Issue codes
| Code | Severity | Meaning |
|---|---|---|
| E000 | error | file not found or not a regular file |
| E001 | error |
Related Skills
Ufiaw
An npm package that will turn your coding agents into waifus when installed
Claude Code Termux
Termux workaround for running Claude Code CLI on Android. The npm package no longer includes a global CLI, so
Setup PM
Configure your preferred package manager (npm/pnpm/yarn/bun)
Skilltotal
Claude Code plugin that scans a package before the agent runs npx, npm install, pip install, uvx or claude mcp
Update Dependencies
What package manager are you using? Please specify (npm, pip, yarn, pnpm, bun).
Random Repo
Pick and clone a random top-100 open-source package from a major package registry (npm, PyPI, crates.io, Go mo
Related Agents
npm Updater
NPM dependency updater agent. Use proactively to check for package updates, analyze changelogs, run security a
Format Lint Analyzer
Detect a repo's file types, filled formatter and linter roles, candidates, package manager, and ignore candida
Nodejs Expert
Use this agent for Node.js ES module patterns, TypeScript configuration and build tooling, monorepo NPM packag