# AGENTS.md Configuration Smell Checker

Canonical tool: https://repoagentkit.com/agents-md-smell-checker

Repo Agent Kit screens an `AGENTS.md` or `CLAUDE.md` file for six configuration smells defined in the 2026 paper “Configuration Smells in AGENTS.md Files: Common Mistakes in Configuring Coding Agents”:

1. Context Bloat
2. Skill Leakage
3. Lint Leakage
4. Blind Reference
5. Init Fossilization
6. Conflicting Instructions

The file is analyzed locally in the browser and is not uploaded. The checker records only bounded anonymous product actions such as running the screen, copying the summary, or opening the broader private checker.

## Method boundary

The paper defines a 200-line threshold for Context Bloat and a one-commit threshold for Init Fossilization. This tool applies those thresholds directly when the required input is available.

The paper used language-model heuristics followed by manual review for Skill Leakage, Lint Leakage, Blind Reference, and Conflicting Instructions. Repo Agent Kit instead uses disclosed deterministic browser-local proxies for those four categories. Results are early-warning review prompts, not a reproduction of the paper’s evaluation and not automatic verdicts.

Primary source: https://arxiv.org/abs/2606.15828

Replication package: https://doi.org/10.5281/zenodo.20600327