Getting a lot of questions across various communities about cleaning up the .md junkyard. /audit skill is a routine check before I end my sessions to clean up junk/stale files/orphaned code. /audit is a safety check. i have a habit of running it before shipping a change, so a mistake gets caught before it reaches real users, not after. It looks for two different kinds of problems: things that will break, and things that are just messy (leftover junk that confuses people later). How it works It has two parts. Part 1, before deploying, it asks three simple questions about the change: 1. What's the fastest way this could break? 2. Did we actually prove it doesn't break that way, or are we just complacent? 3. If it does break anyway, how fast would we find out, seconds, minutes, or not until someone complains? Part 2, (assisting with eyeballing) after making a change, it searches the whole codebase for leftovers: 1. old code nobody uses anymore 2. documentation that no longer matches what the code actually does 3. the same rule written in two different places (which quietly drift apart over time) 4. Everything it finds gets written down in a dated report, so there's a record Why it matters 1. Without this check, a broken change can go live and nobody finds out until it's already failing for real people. 2. Small messes don't stay small. Dead code and outdated docs pile up quietly, and eventually someone trusts something that isn't true anymore. (You need to know your code is trustworthy, imagine making an important code decision based on a junkyard .md file, man! the consequences) How it benefits 1. Fewer surprises in production, catching problems before they ship, not after. 2. The codebase stays trustworthy to read, what the docs say actually matches what the code does. 3. Nothing gets fixed "from memory." Every finding is written down, so it can be checked, tracked, and followed up on later. Measured impact 1. Each with its own dated report. (Can't escape audit logs) 2. Several real problems were found and fixed in the same pass: dead checks removed, broken doc references corrected. (Saves time) 3. Honest limit: not everything it finds gets fixed right away. Some things get flagged and pushed to a to-do list instead of cleaned up on the spot, so it's a good detector, and intentionally so, not a guarantee of a clean result. (Imagine Claude deleting a critical .md file)