# Claudelint

> A linter for Claude Code projects. Validates CLAUDE.md files, skills, settings, hooks, MCP servers, and plugins.

- **Type:** MCP server
- **Install:** `agentstack add mcp-pdugan20-claudelint`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [pdugan20](https://agentstack.voostack.com/s/pdugan20)
- **Installs:** 0
- **Category:** [Developer Tools](https://agentstack.voostack.com/c/developer-tools)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [pdugan20](https://github.com/pdugan20)
- **Source:** https://github.com/pdugan20/claudelint
- **Website:** https://www.claudelint.com

## Install

```sh
agentstack add mcp-pdugan20-claudelint
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## 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

```bash
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:

```bash
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:

```text
/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:

```bash
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](https://claudelint.com/integrations/claude-code-plugin) 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

```bash
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](https://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](https://claudelint.com/guide/getting-started)
- [Configuration](https://claudelint.com/guide/configuration)
- [Rules Overview](https://claudelint.com/guide/rules-overview)
- [Plugin Usage](https://claudelint.com/integrations/claude-code-plugin)
- [Programmatic API](https://claudelint.com/api/overview)
- [Custom Rules](https://claudelint.com/development/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](https://github.com/pdugan20)
- **Source:** [pdugan20/claudelint](https://github.com/pdugan20/claudelint)
- **License:** MIT
- **Homepage:** https://www.claudelint.com

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-pdugan20-claudelint
- Seller: https://agentstack.voostack.com/s/pdugan20
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.