claude-code-lint

claudelint

A linter for Claude Code projects. Validates CLAUDE.md files, skills, settings, hooks, MCP servers, plugins, and more.

Quick Start

Install

npm install -g claude-code-lint
claudelint init       # Creates .claudelintrc.json and .claudelintignore
claudelint check-all  # Validate your project

Or install as a project dependency:

npm install --save-dev claude-code-lint
npx claudelint init
npx claudelint check-all

Claude Code Plugin

Use claudelint as a Claude Code plugin for interactive validation via slash commands.

Inside Claude Code, add the marketplace and install the plugin:

/plugin marketplace add pdugan20/pdugan20-plugins
/plugin install claudelint@pdugan20-plugins

Or run claudelint install-plugin for guided setup.

To trial the plugin for a single session without registering the marketplace:

claude --plugin-url https://github.com/pdugan20/claudelint/releases/latest/download/claudelint-plugin.zip

The plugin's skills run the claudelint CLI, so install the npm package first either way.

See the Plugin Guide for team setup, plugin scopes, and troubleshooting.

What It Checks

• CLAUDE.md -- Size limits, import syntax, circular references, frontmatter
• Skills -- Frontmatter schema, structure, referenced files, security
• Settings -- JSON schema, permissions, tool names, hook configuration
• Hooks -- Event names, script existence, type validation
• MCP Servers -- Transport types, URLs, environment variables
• Plugins -- Manifest schema, directory structure, cross-references

CLI

claudelint check-all                    # Validate everything
claudelint check-all --fix              # Auto-fix issues
claudelint check-all --strict           # Zero-tolerance mode
claudelint validate-skills --path .     # Validate specific component
claudelint list-rules                   # Browse all rules
claudelint format --check               # Check formatting

Plugin Skills

After installing as a plugin, use skills via /skill-name or natural language:

Skill	Description
validate-all	Validate all project files
validate-cc-md	Validate CLAUDE.md files
validate-skills	Validate skill structure and content
validate-settings	Validate settings.json
validate-hooks	Validate hooks.json
validate-mcp	Validate MCP server configuration
validate-plugin	Validate plugin.json manifest
format-cc	Format Claude Code files
optimize-cc-md	Interactively optimize CLAUDE.md

Documentation

Full documentation is available at claudelint.com.

Rule documentation is auto-generated from inline metadata in each rule's source code. Run npm run docs:generate to regenerate pages after modifying rules.

Quick Links

• Getting Started
• Configuration
• Rules Overview
• Plugin Usage
• Programmatic API
• Custom Rules
• Contributing
• Changelog