Automated Technical Debt Detection with Claude Code /refactor-suggest

Technical debt accumulates silently. A function that started at 20 lines grows to 120. A variable named x makes sense to the original author at 2am but confuses everyone else six months later. Duplicate logic spreads across three files because nobody had time to refactor. The /refactor-suggest skill for Claude Code brings a structured, automated approach to detecting these problems before they become architectural crises. What Is /refactor-suggest? /refactor-suggest is a Claude Code custom skill that performs static analysis across your codebase and surfaces refactoring opportunities ranked by severity. Unlike a linter that checks for style violations, this skill reasons about code structure — identifying patterns that are technically correct but will become maintenance liabilities. Run it against any directory: /refactor-suggest src/ Or target a specific file: /refactor-suggest src/api/user_service.py The output is a prioritized list of findings, each with a severity rating, location,