Install
$ agentstack add mcp-pdugan20-claudelint ✓ scanned · ✓ verified, works with Claude Code, Cursor, and more.
Security review
✓ PassedNo issues found. Passed automated security review. · v0.1.0 How review works →
- ✓ Prompt-injection patterns
- ✓ Secret / credential exfiltration
- ✓ Dangerous shell & filesystem operations
- ✓ Untrusted network calls
- ✓ Known-malicious package signatures
What it can access
- ✓ Network access No
- ✓ Filesystem access No
- ✓ Shell / process execution No
- ✓ Environment & secrets No
- ✓ Dynamic code execution No
From automated source analysis of v0.1.0. “Used” means the capability is present in the source — more access means more to trust, not that it’s unsafe.
Verified badge
Passed review? Show it. Paste this badge into your README, it links to the public security report.
Reliability & compatibility
Declared compatibility
Compatibility is declared by the source manifest. End-to-end runtime verification is coming, see below.
We're building live execution health for every listing: tool-call success rate, median latency, uptime, and last-checked timestamps, measured, not self-reported. It isn't live yet, so we don't show numbers we can't stand behind.
How agent discovery & health will work →About
claudelint
[](https://github.com/pdugan20/claudelint/actions) [](https://www.npmjs.com/package/claude-code-lint) [](https://claudelint.com) [](https://codecov.io/gh/pdugan20/claudelint) [](https://nodejs.org) [](https://opensource.org/licenses/MIT)
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](CONTRIBUTING.md)
- [Changelog](CHANGELOG.md)
Source & license
This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.
- Author: pdugan20
- Source: pdugan20/claudelint
- License: MIT
- Homepage: https://www.claudelint.com
Install and usage instructions live in the source repository linked above.
Reviews
No reviews yet, be the first.
Write a review
Versions
- v0.1.0 Imported from the upstream source.