Skip to content
OpenSmartRoute
Skillv1.0.0

techdebt

Find and fix technical debt including duplicated code, dead code, outdated patterns, and code smells. Run at the end of sessions to clean up.

by meleantonio(0) 0 installs
Free
Sign in to install

Free account. Installing gives you the manifest plus copy-paste snippets.

See reviews

About

Imported from meleantonio/awesome-econ-ai-stuff (_skills/engineering/techdebt/SKILL.md). Install upstream with npx skills add meleantonio/awesome-econ-ai-stuff --skill techdebt. Copyright stays with the author.

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

Use it

Copy one of these into your project. Installing also returns the manifest and these snippets.

yaml
targets:
  - https://api.opensmartroute.ai/api/v1/registry/meleantonio-awesome-econ-ai-stuff-techdebt/manifest   # or paste the manifest below

Manifest

An Open Capability Manifest: the router reads it to know what this does, what it costs and when to pick it.

meleantonio-awesome-econ-ai-stuff-techdebt.ocm.jsonjson
{
  "ocm": "1",
  "id": "meleantonio-awesome-econ-ai-stuff-techdebt",
  "kind": "skill",
  "name": "techdebt",
  "description": "Find and fix technical debt including duplicated code, dead code, outdated patterns, and code smells. Run at the end of sessions to clean up.",
  "publisher": "meleantonio",
  "version": "1.0.0",
  "capabilities": {
    "domains": [
      "coding"
    ],
    "tags": [
      "skill-md",
      "refactoring",
      "code-quality",
      "maintenance",
      "skills-sh"
    ],
    "languages": [
      "en"
    ]
  },
  "quality_prior": 0.6,
  "examples": [
    "Find and fix technical debt including duplicated code, dead code, outdated patterns, and code smells. Run at the end of sessions to clean up."
  ],
  "primary": false,
  "metadata": {
    "source": {
      "provider": "skills.sh",
      "repository": "https://github.com/meleantonio/awesome-econ-ai-stuff",
      "path": "_skills/engineering/techdebt/SKILL.md",
      "ref": "HEAD",
      "url": "https://github.com/meleantonio/awesome-econ-ai-stuff/blob/HEAD/_skills/engineering/techdebt/SKILL.md",
      "key": "meleantonio/awesome-econ-ai-stuff/_skills/engineering/techdebt/SKILL.md"
    },
    "compatibility": "['claude-code', 'cursor', 'codex', 'gemini-cli']"
  },
  "instructions": "# Technical Debt Finder\n\nIdentify and fix technical debt in the codebase.\n\n## What to Look For\n\n### Code Duplication\n- Functions with similar logic that could be consolidated\n- Copy-pasted code blocks\n- Repeated patterns that should be abstracted\n\n### Dead Code\n- Unused imports\n- Unused functions or classes\n- Commented-out code blocks\n- Unreachable code paths\n\n### Outdated Patterns\n- Deprecated API usage\n- Old-style string formatting (% or .format) vs f-strings\n- Type hints using `typing.List` instead of `list`\n- Missing type hints on public functions\n\n### Code Smells\n- Functions longer than 5",
  "cost": {
    "context_tokens": 435
  }
}

Fetch it by URL: GET /api/v1/registry/meleantonio-awesome-econ-ai-stuff-techdebt/manifest?version=1.0.0

Reviews

Star ratings from people who tried it. One review per account; edit yours any time.

No reviews yet. Install it, try it, and be the first to rate it.