techdebt-finder

SKILL.md

Tech Debt Finder

Identify duplicated code, inconsistent patterns, and refactoring opportunities.

When to Use

  • "Find duplicate code"
  • "What needs refactoring?"
  • "Are there inconsistent patterns?"
  • Code review prep
  • Pre-refactor analysis

Detection Process

  1. Scan - Grep for common debt indicators
  2. Cluster - Group similar issues
  3. Prioritize - Rank by frequency × impact
  4. Report - Show findings with locations

Quick Patterns

Debt Type Detection Method
Duplicated code Hash-compare function bodies
Similar-but-diff Fuzzy match on structure
Inconsistent naming Regex for mixed conventions
Dead code Unreferenced exports/functions
TODO/FIXME Grep for comment markers
Magic numbers Literals outside const/config
Long functions Line count > threshold
Deep nesting Indentation level analysis

Output Format

## Technical Debt Report

### High Priority (fix soon)
- [DUPLICATE] src/utils/format.ts:23 ↔ src/helpers/fmt.ts:45
  Similar: 87% | Impact: High (called 12 places)

### Medium Priority (plan for)
- [INCONSISTENT] Mixed naming: getUserData vs fetch_user
  Files: api.ts, service.ts, handler.ts

### Low Priority (track)
- [TODO] 23 TODO comments, oldest: 2023-01-15

References

Weekly Installs
8
GitHub Stars
20
First Seen
Feb 3, 2026
Installed on
cursor7
opencode5
gemini-cli5
claude-code5
github-copilot5
kimi-cli5