tech-debt

Scan repositories for debt indicators and maintain a prioritized debt ledger.

277|65|Updated Mar 30, 2026
One-click install
npx skills add https://github.com/pixel-cellar/Claude-Code-Game-Studios --skill tech-debt-pixel-cellar
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: tech-debt
Source: https://github.com/pixel-cellar/Claude-Code-Game-Studios/tree/main/.claude/skills/tech-debt
Command: npx skills add https://github.com/pixel-cellar/Claude-Code-Game-Studios --skill tech-debt-pixel-cellar

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Tracks, classifies, and prioritizes technical debt within codebases by scanning debt indicators, maintaining a debt registry, and recommending remediation plans.

Core Features & Use Cases

  • Debt scanning: identify debt indicators such as TODOs, FIXME, HACK, deprecated APIs, duplicated code, large files, and high-complexity functions; categorize into Architecture Debt, Code Quality Debt, Test Debt, Documentation Debt, Dependency Debt, and Performance Debt.
  • Debt registry: maintain a centralized ledger of debt items with category, affected files, effort estimates, and sprint targets.
  • Prioritization & planning: compute prioritization scores and suggest items to include in the next sprint.

Quick Start

Run the tech-debt scan to build and refresh the debt ledger 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 technical debt across multiple codebases?

To track technical debt across multiple codebases, use the scan subcommand to identify indicators like TODOs, FIXMEs, and deprecated APIs. It maintains a centralized debt ledger with categories, effort estimates, and sprint targets for each project.

What is technical debt prioritization and how does it work?

Technical debt prioritization computes scores for tracked debt items to recommend what to include in the next sprint. It evaluates structured debt entries using category-specific prioritization rules across Architecture, Code Quality, Test, Documentation, Dependency, and Performance Debt.

How do I scan my repository for code quality and technical debt indicators?

Scan your repository for code quality and technical debt indicators by running the scan subcommand. It detects TODOs, HACKs, duplicated code, large files, high-complexity functions, and deprecated APIs, then categorizes them into a structured debt ledger.

Can I maintain a centralized technical debt ledger for sprint planning?

Yes, you can maintain a centralized technical debt ledger for sprint planning. The tool enforces structured debt entries with categories, affected files, and effort estimates, then suggests specific remediation items to target in your next sprint.

What categories of technical debt can I classify in my codebase?

You can classify technical debt into six categories: Architecture Debt, Code Quality Debt, Test Debt, Documentation Debt, Dependency Debt, and Performance Debt. The scan subcommand automatically maps indicators like duplicated code and deprecated APIs to these classifications.

How do I generate a technical debt remediation plan for my projects?

Generate a technical debt remediation plan by using the prioritize and report subcommands. These compute prioritization scores for your categorized debt ledger and output actionable recommendations for sprint planning across your projects.