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