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/plugins
/plugin install claudelint@patrick-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
