claude-code-lint
v0.2.0
Published
Comprehensive linter and programmatic API for Claude Code projects - validates CLAUDE.md files, skills, settings, hooks, MCP servers, plugins, and more
Maintainers
Readme
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 projectOr install as a project dependency:
npm install --save-dev claude-code-lint
npx claudelint init
npx claudelint check-allClaude 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/claudelint
/plugin install claudelint@pdugan20-pluginsOr run claudelint install-plugin for guided setup.
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 formattingPlugin 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.
