What problem does it solve? Reference files rot quietly over time: sections bloat past their limits, the same fact ends up in two files, dates pass, and decisions get reversed while old notes stay. This Skill runs scheduled or on-demand scans that flag these issues and hand you a punch-list of suggested fixes — it drafts the cleanup but never auto-deletes or auto-edits anything. ## Core Features & Use Cases - Hygiene Scanning: Walks your file set and flags bloat, duplicated facts, stale content, contradictions, and orphaned links with exact file locations. - Draft-First Punch-List: Outputs a numbered list of suggested fixes you approve with a simple reply like "do 1, 3, 4" — nothing changes without your confirmation. - File Lifecycle Enforcement: Detects duplicate copies (shadows vs orphans), unregistered working directories via the included Python check, and verifies no live file references a candidate before any move. - Use Case: Run a monthly review of your personal knowledge base. The Skill reports that your preferences file has a 34-line section over its 20-line limit, a mortgage rate duplicated across two files, and three unregistered scratch directories — you pick which fixes to apply. ## Quick Start Ask the assistant to run a knowledge hygiene review of my reference files and give me the cleanup punch-list.
