ksimback/tech-debt-skill ? reverse-engineered prompt

Build me a Claude Code skill that audits an entire codebase for tech debt, not just a quick code review.

I want one command, /tech-debt-audit, that scans the repo and writes a TECH_DEBT_AUDIT.md report in the root. The report should call out the most important problems first, give a severity and rough effort estimate for each one, and cite the exact file and line so I can check it myself. It should also include a short summary of what the codebase seems to be, a ranked list of what to fix first, some quick wins, and a section for things that look bad at first but are actually fine.

Make it smart enough to look at the whole repository, notice the structure, and use whatever checks make sense for the project’s stack. If there’s an existing audit, update it instead of starting from scratch, and mark what’s new or resolved. Keep it practical, specific, and focused on things I’d actually want to fix.