A small Python linter for Claude Code SKILL.md files. It checks:

• YAML frontmatter is present and parses cleanly
• name and description are present
• name is lowercase kebab-case, 1-64 chars, starts with a letter
• description length is reasonable (20-1024 chars after trimming)
• allowed-tools is 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

pip install claude-skill-check

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.

claude-skill-check --quiet path/to/skills-dir/

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)

Add this step to any workflow:

- uses: actions/checkout@v5
- uses: MukundaKatta/claude-skill-check@v1
  with:
    paths: .claude/skills

The action runs the same checks as the CLI and fails the workflow on any errors. Inputs: paths (default .), quiet (default false), python-version (default 3.12).

pip install -e '.[dev]'
pytest

MIT