claude-pre-commit

Experimental: This repository is an experiment to lint .claude configuration files.

Pre-commit hooks for validating Claude Code configuration files - SKILL.md, hooks, subagent configs, and settings.

Features

• Validates SKILL.md files (YAML frontmatter + markdown)
• Validates JSON configuration files (settings.json, hooks.json, .mcp.json)
• Security checks for shell scripts
• Auto-fix support for common issues
• Multiple search scopes (global, local, both, git)

Installation

git clone https://github.com/freddo1503/claude-pre-commit
cd claude-pre-commit
cargo build --release

Usage

# Check all Claude Code files
claude-check check

# Check specific scope
claude-check check --scope global
claude-check check --scope local

# Auto-fix issues
claude-check fix

# Install git hook
claude-check install-hook

# See all options
claude-check --help

Pre-commit Integration

Add to .pre-commit-config.yaml:

repos:
  - repo: https://github.com/freddo1503/claude-pre-commit
    rev: v0.1.0
    hooks:
      - id: claude-check

Development Status

Current: v0.1.0 - Foundation complete

Completed:

• Cargo workspace structure
• Core validation engine
• File discovery
• CLI implementation

In Progress:

• SKILL.md validator
• JSON schema validation
• Shell script security analysis

License

MIT License - see LICENSE for details.