Development
claudelint
A linter for Claude Code projects. Validates CLAUDE.md files, skills, settings, hooks, MCP servers, plugins, and more.
Plugin Signal74/100Solid
maintained100
capable67
documented75
adopted24
Install on Claude Code
Auto-invoked ships a router so the right skill fires automatically as you prompt. No remembering which skill to call.
Normal is the plain upstream plugin, installed as-is. You invoke its skills yourself.
The plugin> /plugin marketplace add pdugan20/claudelint> /plugin install claudelint@claudelintAuto-invocation> /plugin marketplace add flowy-sh/flowy-core> /plugin install flowy-core> /plugin install flowy-claudelint
Stats
12
Stars
4
Forks
Active
Maintenance
TypeScript
Language
MIT
License
10h ago
Last commit
7mo ago
Created
Repo: pdugan20/claudelint
What's inside
Skill(9 skills)
/format-ccFormats Claude Code files with markdownlint, prettier, and shellcheck. Use when user asks to "format my files", "fix markdown formatting", "clean up CLAUDE.md", or "check shell scripts". Auto-fixes markdown, JSON, YAML formatting and analyzes shell script quality./optimize-cc-mdInteractively helps users optimize their CLAUDE.md files. Use when user asks to "optimize my CLAUDE.md", "my CLAUDE.md is too long", "improve organization", or "split my CLAUDE.md". Runs validation, explains issues conversationally, and helps create @import files to reduce size/validate-allRuns comprehensive claudelint validation on all Claude Code project files. Use when user asks to "check everything", "run all validators", "full audit", "validate my entire project", or "what's wrong with my config". Validates CLAUDE.md, skills, settings, hooks, MCP servers, and
Agent(13 agents)
claude-md-optimizerUse this agent when the user wants to autonomously validate and optimize their CLAUDE.md files. This agent runs claudelint validation, analyzes results, and makes targeted improvements to reduce file size, fix import issues, remove generic content, and improve organization.agent-body-too-shortAgent body content should meet minimum length requirementsagent-descriptionAgent description must be at least 10 characters
Command(1 command)
Hook(1 hook)
Badges
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 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
File tree
FAQ
claudelint is a Claude Code plugin of 9 hand-picked skills with a FLOW.md router. Install it once and the right skill fires as you prompt, with no slash command to remember. It is built for development work. It includes format-cc, optimize-cc-md, validate-all. Free and open source.
- What is claudelint?
- A linter for Claude Code projects. Validates CLAUDE.md files, skills, settings, hooks, MCP servers, plugins, and more.
- How do I install claudelint?
- Run these in Claude Code: /plugin marketplace add pdugan20/claudelint then /plugin install claudelint@claudelint. Then prompt normally.
- Does claudelint auto-invoke its skills?
- Yes. It ships a FLOW.md router that Flowy's hook fires, so the matching skill runs as you prompt. You never name a skill.
- Is claudelint free?
- Yes. Flowy is free and open source, with nothing gated. You can read every skill in full before you install.
Is this plugin yours?
Claim it with GitHubSubmit a pluginPromote it