Now liveThe Skillselion MCP - thousands of ranked skills, loaded into your agent mid-task. No install.Get it →
meleantonio avatar

Techdebt

  • 51 installs
  • 590 repo stars
  • Updated June 23, 2026
  • meleantonio/awesome-econ-ai-stuff

Helps with ai & agent building tasks.

About

techdebt is a Claude Code skill for ai & agent building. It helps solo builders move faster with AI-assisted coding.

  • techdebt
  • AI & Agent Building
  • AI-coding skill

Techdebt by the numbers

  • 51 all-time installs (skills.sh)
  • +4 installs in the week ending Aug 4, 2026 (Skillselion tracking)
  • Ranked #7,219 of 16,546 AI & Agent Building skills by installs in the Skillselion catalog
  • Data as of Aug 5, 2026 (Skillselion catalog sync)
npx skills add https://github.com/meleantonio/awesome-econ-ai-stuff --skill techdebt

Add your badge

Show developers this skill is listed on Skillselion. Paste this into your README.

Listed on Skillselion
Installs51
repo stars590
Last updatedJune 23, 2026
Repositorymeleantonio/awesome-econ-ai-stuff

What it does

Helps with ai & agent building tasks.

Files

SKILL.mdMarkdownGitHub ↗

Technical Debt Finder

Identify and fix technical debt in the codebase.

What to Look For

Code Duplication

  • Functions with similar logic that could be consolidated
  • Copy-pasted code blocks
  • Repeated patterns that should be abstracted

Dead Code

  • Unused imports
  • Unused functions or classes
  • Commented-out code blocks
  • Unreachable code paths

Outdated Patterns

  • Deprecated API usage
  • Old-style string formatting (% or .format) vs f-strings
  • Type hints using typing.List instead of list
  • Missing type hints on public functions

Code Smells

  • Functions longer than 50 lines
  • Too many parameters (more than 5)
  • Deep nesting (more than 3 levels)
  • Magic numbers without constants
  • Overly complex conditionals

Missing Best Practices

  • Missing docstrings on public functions
  • Missing error handling
  • Hardcoded values that should be config
  • Missing tests for critical paths

Workflow

1. Scan the Codebase

  • Look for patterns matching the issues above
  • Prioritize by impact and ease of fix

2. Report Findings

  • List issues by category
  • Include file paths and line numbers
  • Estimate severity (high/medium/low)

3. Fix Issues

  • Start with high-severity, easy fixes
  • Create atomic commits for each fix
  • Run tests after each change

4. Verify

  • Run linter: ruff check .
  • Run tests: pytest
  • Ensure no new issues introduced

Arguments

Optionally specify a directory or file to focus on.

Usage:

  • /techdebt - Scan entire project
  • /techdebt src/ - Scan specific directory
  • /techdebt src/utils.py - Scan specific file

Output

Provide a summary of:

  • Issues found (by category)
  • Issues fixed
  • Remaining items for future sessions

Related skills

This week in AI coding

Five minutes, every Monday - the tools, releases and tactics for developers.

unsubscribe anytime.