Agent Rules Lint

agent-rules-lint

[](https://pypi.org/project/agent-rules-lint/) [](https://pypi.org/project/agent-rules-lint/) [](https://github.com/Uky0Yang/agent-rules-lint/actions/workflows/ci.yml) [](LICENSE)

Lint AI agent instruction files before they confuse your coding agent.

`agent-rules-lint` is a small, dependency-free Python CLI that scans files such as `AGENTS.md`, `CLAUDE.md`, Cursor rules, and GitHub Copilot instructions for common quality and safety problems.

Why

Recent high-growth developer repos show a clear pattern: teams are adding more agent skills, rule files, memory files, and coding-agent playbooks. The missing piece is a quick quality gate for those instructions.

Bad agent instructions are expensive. They can be too long, vague, contradictory, unsafe, or accidentally include secrets. This tool gives you a fast local and CI check before those rules affect real work.

What It Checks

• Common instruction files:
  • AGENTS.md
  • CLAUDE.md
  • GEMINI.md
  • .cursorrules
  • .cursor/rules/*.md
  • .github/copilot-instructions.md
  • .github/instructions/*.md
• Secret-like values
• Risky shell and Git commands
• Prompt-injection-like language
• Missing title
• Missing purpose, scope, command, or safety guidance
• Vague language
• Files that are too long for practical agent use
• A small set of obvious contradictory rules

Install

Run it without installing:

uvx agent-rules-lint .

Or install it as an isolated CLI:

pipx install agent-rules-lint
agent-rules-lint .

Standard pip installation also works:

python -m pip install agent-rules-lint

For local development:

python -m pip install -e .

Usage

Scan the cur