agents-md-fixer
AGENTS.md fixer
Goal
Make AGENTS.md a tiny pointer file. It should mostly be bare path pointers
into docs/*.md, not prose. The longer AGENTS.md grows, the worse AI coding
agents perform: they skim, prioritize poorly, and miss the load-bearing
rules. This skill audits AGENTS.md and returns an aggressively tightened
version, with the manager (the invoking agent) exercising judgment about
what is important for this repo versus frivolous.
AGENTS.md is written for AI agents, not humans. Do NOT use Markdown links
([text](path)); reference docs by bare path (docs/PYTHON_STYLE.md) so the
file stays plain for the agents that read it. Clickability on GitHub is a
human concern and is not a goal here.
Size guidance (line count is a rough proxy, not a contract; "line" means a non-blank text line in the rendered Markdown):