tech-debt

Scan codebases for TODOs, FIXMEs, and deprecated APIs, then generate a prioritized markdown task list.

29|2|Updated Feb 4, 2026
One-click install
npx skills add https://github.com/agentty-xyz/agentty --skill tech-debt-agentty-xyz
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: tech-debt
Source: https://github.com/agentty-xyz/agentty/tree/main/skills/tech-debt
Command: npx skills add https://github.com/agentty-xyz/agentty --skill tech-debt-agentty-xyz

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Sweep the codebase to detect tech debt items, maintenance gaps, and outdated patterns, returning a prioritized markdown task list of findings.

Core Features & Use Cases

  • Automated discovery: Scan files across modules to surface TODOs, FIXMEs, and deprecated patterns.
  • Prioritized reporting: Rank findings by impact, effort, and risk to guide remediation.
  • Use Case: When maintaining a large Rust/OSS codebase, run this skill to produce an actionable backlog of tech-debt tasks.

Quick Start

Scan the repository for tech debt and output a prioritized markdown task list.

Frequently Asked Questions about tech-debt

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

FAQPage Schema
How do I scan my codebase for tech debt and generate a prioritized backlog?

To scan your codebase for tech debt, this skill analyzes your repository to surface TODOs, FIXMEs, and deprecated patterns, outputting a prioritized markdown task list. Findings are ranked by impact, effort, and risk to guide your remediation.

What is the best way to track outdated patterns and missing tests across large modules?

Tracking outdated patterns and missing tests across large modules requires automated discovery. This skill scans files across your specified scope to identify maintenance gaps and produces a markdown task list with risk weighting to guide targeted fixes.

Can I scope tech debt detection to specific modules instead of the entire repository?

Yes, you can apply tech debt detection within a user-specified scope instead of the entire repository. This allows you to focus the automated discovery on critical modules to efficiently generate a targeted, actionable backlog.

Does the tech debt report include risk weighting for findings like deprecated APIs?

Yes, the tech debt report includes risk weighting for findings like deprecated APIs. It ranks all discovered maintenance gaps and outdated patterns by impact, effort, and risk to produce a prioritized markdown task list for remediation.

What documentation do I need to set up automated tech debt discovery?

Automated tech debt discovery requires scanning project documentation, specifically your AGENTS.md file. It also checks for preference to test coverage to accurately identify maintenance gaps and generate the prioritized markdown task list.

When should I run a tech debt scan on my Rust or open source codebase?

You should run a tech debt scan when maintaining a large Rust or OSS codebase to produce an actionable backlog of tech-debt tasks. It is ideal for surfacing accumulated TODOs and deprecated patterns before they impact project stability.