{"repo":"aka-luan/doc-cleanup","free":true,"listed":false,"github":"https://github.com/aka-luan/doc-cleanup","clone":"git clone https://github.com/aka-luan/doc-cleanup.git","description":"Agent skill that audits and cleans agent-facing markdown docs — archives completed-work history, fixes stale facts and contradictions, keeps only live verified facts.","language":null,"stars":40,"topics":["agent-skills","ai-agents","claude","claude-code","developer-tools","documentation"],"license":"MIT","category":"docs-static-sites","readme_excerpt":"doc-cleanup An agent skill that finds and removes context rot from your repo's markdown docs. Your CLAUDE.md / AGENTS.md ecosystem is quietly lying to your agents. Every \"read this before you code\" doc accumulates finished checklists, executed plans, dead file paths, and facts the code outgrew months ago. Agents pay for that twice: once in context tokens on every session , and again in wrong conclusions — because a stale fact in an \"authoritative\" doc beats a correct fact the agent never thought to look up. doc-cleanup is a skill (a SKILL.md playbook) that audits every markdown doc in a repo, verifies each claim against the actual code, reports what's hurting your agents, and — after you approve — archives the history and rewrites the live docs down to current facts. Results from its first production run A real Next.js/Hono monorepo, 3 weeks of agent-driven development, docs faithfully updated the whole time — and still: Doc (agent required-reading) Before After --- ---: ---: --- Roadmap / milestones 445 lines 33 lines −93% Design-system spec 443 lines 181 lines −59% Pricing plan 197 lines 52 lines −74% Total required reading 1,085 lines 266 lines −75% Nothing was lost — 919 lines of history moved verbatim to docs/archive/ , still greppable, no longer in every session's context. The line count wasn't even the important part. The audit caught, in one pass: - A pricing doc stating the enabled payment methods two different ways in the same file , one with a line reference that n","default_branch":null,"files":null,"tree":[],"storefront":"/r/aka-luan","claimed":false,"request_supported":{"post":"https://gitbuyer.com/r/aka-luan/doc-cleanup/request-supported","requests":0},"note":"indexed from public GitHub; nothing is for sale on this page. Clone it from GitHub. Paid listings live at /search."}