agentlint
Lint, score, and optimize your AI agent configuration files.
agentlint analyzes CLAUDE.md, AGENTS.md, Cursor rules, and other AI agent configs — and tells you exactly what's wrong and how to fix it.
Install
pip install agentlint
Usage
# Lint a file and show issues
agentlint lint CLAUDE.md
# Score your config from 0-100
agentlint score CLAUDE.md
# Generate an optimized version
agentlint optimize CLAUDE.md # saves to CLAUDE.optimized.md
agentlint optimize CLAUDE.md --ai # uses Claude API for smarter suggestions
# Show diff of what optimize would change
agentlint diff CLAUDE.md
# Scan entire directory for all config files
agentlint scan .
Lint Rules
| Code | Severity | Description |
|---|---|---|
TOO_LONG |
❌ Error | File exceeds 80 lines — Claude starts ignoring instructions |
TOKEN_WASTE |
⚠️ Warning | Personality instructions waste tokens with little effect |
DUPLICATE_RULE |
⚠️ Warning | Same instruction repeated more than once |
CONTRADICTION |
❌ Error | Conflicting instructions cause unpredictable behavior |
MISSING_COMMANDS |
❌ Error | No shell commands defined — agent can't verify its work |
MISSING_STACK |
❌ Error | No tech stack defined — agent may make wrong assumptions |
AT_MENTION_ABUSE |
⚠️ Warning | Excessive @file refs embed large files every session |
NO_VERIFY_STEP |
❌ Error | No instructions for verifying changes work |
VAGUE_INSTRUCTION |
⚠️ Warning | Instruction too vague to be reliably actionable |
BLOAT_DETECTED |
⚠️ Warning | Lengthy procedures belong in skill files, not base config |
MISSING_NEVER |
⚠️ Warning | No prohibition rules — negative constraints are highly effective |
INSTRUCTION_LIMIT |
⚠️ Warning | Estimated 150+ instructions — models lose track |
Scoring
| Category | Points | What it measures |
|---|---|---|
| Length & Density | 25 | File size, no token waste, no duplicates |
| Specificity | 25 | Concrete rules, no vague/contradicting instructions |
| Structure | 25 | Headers, bullets, code blocks, no bloat |
| Completeness | 25 | Stack, commands, verify step, never rules |
License
MIT
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
agentlint_dev-0.1.0.tar.gz
(40.1 kB
view details)
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file agentlint_dev-0.1.0.tar.gz.
File metadata
- Download URL: agentlint_dev-0.1.0.tar.gz
- Upload date:
- Size: 40.1 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/6.2.0 CPython/3.9.12
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
26e59260072129ef5e23c1c49d251cdd3a24b4c09149c7c02ba4bb6b0d990209
|
|
| MD5 |
c286d997b78a8f22258be77f8135cc1a
|
|
| BLAKE2b-256 |
327d642c07ff35138531c0cd2a1c6c41f04d821e449295d4e68df9522e05b040
|
File details
Details for the file agentlint_dev-0.1.0-py3-none-any.whl.
File metadata
- Download URL: agentlint_dev-0.1.0-py3-none-any.whl
- Upload date:
- Size: 17.7 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/6.2.0 CPython/3.9.12
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
bd29c4da7b9ee2a17f93d58cfe43270c91cdefbfb879fb335f1869edf5951c2b
|
|
| MD5 |
7a9006567a6bdf061ee9c71c02f7bae5
|
|
| BLAKE2b-256 |
1f3e702afc2ef2b298cfad9b4849710f5d9e841c9359384b3d3b4c56a572cdaa
|
