tech-debt

Scan codebases for debt indicators and generate a prioritized risk register.

Updated Apr 9, 2026
One-click install
npx skills add https://github.com/CarlosQ96/robot-crawler --skill tech-debt-carlosq96
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: tech-debt
Source: https://github.com/CarlosQ96/robot-crawler/tree/main/.agents/skills/tech-debt
Command: npx skills add https://github.com/CarlosQ96/robot-crawler --skill tech-debt-carlosq96

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Track, categorize, and prioritize technical debt across the codebase. Scans for debt indicators, maintains a debt register, and recommends repayment scheduling.

Core Features & Use Cases

  • Scan codebase for debt indicators (TODO, FIXME, HACK, @deprecated) and log findings into a debt register.
  • Classify findings into Architecture Debt, Code Quality Debt, Test Debt, Documentation Debt, Dependency Debt, and Performance Debt.
  • Generate prioritized recommendations and prepare sprint-ready tasks for repayment scheduling.

Quick Start

Run the tech-debt workflow to identify and register debt across the repository.

Frequently Asked Questions about tech-debt

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

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

To track and prioritize technical debt, you need to scan your repository for indicators like TODO and FIXME tags, classify them into categories such as architecture or test debt, and generate a prioritized risk register for sprint planning.

What are the main categories of technical debt I should look for during static analysis?

The main categories of technical debt to analyze are architecture debt, code quality debt, test debt, documentation debt, dependency debt, and performance debt, which together form a comprehensive risk register.

How do I prepare sprint-ready tasks for repaying technical debt?

You prepare sprint-ready tasks for repaying technical debt by categorizing codebase findings into a structured debt register with clear rationale, enabling prioritized scheduling and actionable development workflows.

Can I scan for TODO and FIXME comments to build a debt register?

Yes, you can scan for TODO, FIXME, HACK, and deprecated tags to log code quality debt findings directly into a structured debt register, providing clear rationale for each identified item.

What is the best way to categorize dependency and documentation debt for risk prioritization?

The best way to categorize dependency and documentation debt is to analyze codebase indicators, classify them into distinct debt types, and produce a prioritized risk register ensuring governance and sprint planning readiness.