Skip to main content
Generalspences10

techdebt-finder

Find technical debt patterns in codebases. Use when asked to find duplicated code, inconsistent patterns, or refactoring opportunities.

Stars
33
Source
spences10/claude-code-toolkit
Updated
2026-04-29
Slug
spences10--claude-code-toolkit--techdebt-finder
View on GitHubRaw SKILL.md

// install — copy + paste into any project

mkdir -p .claude/skills && curl -fsSL https://raw.githubusercontent.com/spences10/claude-code-toolkit/HEAD/plugins/devops-skills/skills/techdebt-finder/SKILL.md -o .claude/skills/techdebt-finder.md

Drops the SKILL.md into .claude/skills/techdebt-finder.md. Works with Claude Code, Cursor, and any agent that loads SKILL.md files from .claude/skills/.

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