https://github.com/dotcommander/cclint
Linter for Claude Code agents, commands, and skills
https://github.com/dotcommander/cclint
claude-code cli golang linter
Last synced: 3 months ago
JSON representation
Linter for Claude Code agents, commands, and skills
- Host: GitHub
- URL: https://github.com/dotcommander/cclint
- Owner: dotcommander
- License: mit
- Created: 2025-12-22T22:37:01.000Z (6 months ago)
- Default Branch: main
- Last Pushed: 2026-03-06T01:35:35.000Z (3 months ago)
- Last Synced: 2026-03-06T05:37:31.365Z (3 months ago)
- Topics: claude-code, cli, golang, linter
- Language: Go
- Size: 10.7 MB
- Stars: 13
- Watchers: 1
- Forks: 2
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# cclint
A linter for Claude Code components. Catches schema errors, enforces structure, and flags cross-file problems before they surface as confusing runtime behavior.
Handles agents, commands, skills, plugins, and settings.
## Install
```bash
go install github.com/dotcommander/cclint@latest
```
## Usage
```bash
cclint # lint everything under ~/.claude
cclint agents # one component type
cclint ./path/to/file.md # lint specific files
cclint --staged # only staged files (pre-commit)
cclint --scores # quality scores (0-100)
cclint fmt --write # auto-format component files
```
## What it catches
- Frontmatter schema errors (embedded CUE schemas)
- Size, structure, and naming violations per component type
- Cross-file issues: broken references, orphaned skills, ghost triggers
- Settings validation: hooks, permissions, MCP servers, security
- Delegation anti-patterns in commands and agents
## Baseline mode
For projects with existing violations, adopt incrementally:
```bash
cclint --baseline-create # snapshot current state
cclint --baseline # only fail on new issues
```
Commit `.cclintbaseline.json` and tighten over time.
## Quality scoring
Every component gets a 0-100 score across structural completeness, practices, composition, and documentation. Tier grades A-F. Useful for prioritizing what to fix first.
## More
See `docs/README.md` for setup, CI integration, and contributor guides.