What problem does it solve? Developers who inherit or generate code with AI often cannot explain what their own codebase does, leaving dead code, undocumented functions, and blind spots that erode confidence. This Skill enforces comprehension-driven trimming: every function you keep, you can defend. ## Core Features & Use Cases - Function Inventory Mapping: Walks the source tree, extracts every function with LOC, docstrings, and callgraph data, and flags DEAD, LARGE, and UNDOCUMENTED candidates in an AUDIT.md report. - Comprehension Quiz: Interactively quizzes you on each function, classifying answers as OWNED, FUZZY, or BLIND, with shortcuts like skip, blind, show, and done. - Test-Guarded Trimming: Attempts deletion of BLIND and DEAD functions first, runs your test suite after every change, and falls back to guided rewrites when functions turn out to be load-bearing. - Use Case: After an AI assistant scaffolds a Python project, run this audit to discover that 6 of 47 functions are dead, delete them with tests confirming safety, and rewrite the 4 functions you could not explain. ## Quick Start Audit my codebase with root ./src and test command pytest tests/ -x -q, then quiz me on every function and trim what I cannot explain.
