tech-debt

Scan codebases for TODO, FIXME, HACK, and deprecated markers to categorize and prioritize technical debt.

Updated Apr 26, 2026
One-click install
npx skills add https://github.com/solace-ill/vector-flow --skill tech-debt-solace-ill
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: tech-debt
Source: https://github.com/solace-ill/vector-flow/tree/main/.claude/skills/tech-debt
Command: npx skills add https://github.com/solace-ill/vector-flow --skill tech-debt-solace-ill

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Developers and teams often suffer from hidden and accumulating technical debt that slows changes, increases risk, and inflates maintenance costs.

Core Features & Use Cases

  • Scan for debt indicators (TODO, FIXME, HACK, @deprecated markers)
  • Maintain a centralized tech debt register and categorize findings
  • Recommend repayment scheduling and provide visibility into sprint planning
  • Generate reports to track progress over time and inform prioritization

Quick Start

Run a full debt scan to identify indicators across the codebase, generate a prioritized debt register, and propose repayment plans.

Frequently Asked Questions about tech-debt

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I track technical debt across my codebase?

Maintain a technical debt register by scanning your codebase for TODO, FIXME, HACK, and deprecated markers. The tool categorizes these findings into a centralized register that tracks debt indicators and suggests fixes to reduce maintenance costs.

What's the best way to prioritize tech debt for sprint planning?

Prioritize tech debt for sprint planning by generating exported reports that recommend repayment scheduling. This provides visibility into accumulated debt and helps teams schedule fixes effectively during sprints.

How does static analysis find tech debt indicators?

Static analysis finds tech debt indicators by scanning the codebase for specific markers like TODO, FIXME, HACK, and @deprecated annotations. It categorizes these markers to identify hidden debt and suggest appropriate fixes for your team workflow.

Can I generate a debt register for software projects of any size?

You can generate a centralized debt register for software projects of any size. The tool scans for debt indicators, categorizes findings, and exports reports to track progress over time, ensuring teams maintain code quality regardless of scale.

Why does technical debt accumulate and slow down code changes?

Technical debt accumulates from hidden indicators like TODO and FIXME markers that increase risk and inflate maintenance costs. Tracking these debt indicators in a centralized register prevents them from slowing changes and degrading code quality over time.