tech-debt
Scans your project for tech debt, TODOs, and inconsistent patterns, generating a prioritized task list.
Install
mkdir -p .claude/skills/tech-debt-agentty-xyz && curl -L -o skill.zip "https://agentskills.codes/api/skills/download/19385" && unzip -o skill.zip -d .claude/skills/tech-debt-agentty-xyz && rm skill.zipInstalls to .claude/skills/tech-debt-agentty-xyz
Activation
This is the description your AI agent reads to decide when to run this skill — the better it matches your request, the more reliably it fires.
Sweep the codebase for tech debt and return a prioritized markdown task list of findings.Key capabilities
- →Traverse project directories to identify tech debt
- →Detect TODO, FIXME, HACK, and XXX comments
- →Identify outdated API usage and legacy code paths
- →Flag inconsistent error handling and missing documentation
- →Analyze dependency versions and unused code
- →Generate a prioritized markdown task list
How it works
The skill traverses target directories, reads project conventions from AGENTS.md, and analyzes code for maintenance issues. Findings are categorized by priority and returned as a structured markdown task list.
Inputs & outputs
When to use tech-debt
- →Identify stale patterns
- →List TODOs and FIXMEs
- →Standardize error handling
- →Find missing documentation
About tech-debt
Traverses project directories to find TODO/FIXME comments, outdated API usage, and inconsistent error handling. It generates a prioritized markdown report to guide cleanup efforts based on local and project-wide conventions.
Sweep the codebase for tech debt and return a prioritized markdown task list of findings.
When not to use it
- →When the codebase lacks any project conventions or architecture documentation
- →When the user requires automated code refactoring rather than a task list
Prerequisites
Limitations
- →Requires manual implementation of the generated task list
- →Scope is restricted to the provided directory or full codebase
How it compares
Unlike a generic search, this skill prioritizes findings based on project-specific conventions and defined risk criteria.
Compared to similar skills
tech-debt side by side with the closest alternatives in the catalog.
| Skill | Installs | Updated | Safety | Difficulty |
|---|---|---|---|---|
| tech-debt (this skill) | 0 | 3mo | No flags | Intermediate |
| antfu | 6 | 5mo | Review | Intermediate |
| backfill-feature | 0 | 4mo | Review | Advanced |
| effective-go | 323 | 1y | No flags | Beginner |
Try saying
Example prompts that trigger this skill in your AI assistant.
You might also like
antfu
antfu
Anthony Fu's opinionated tooling and conventions for JavaScript/TypeScript projects. Use when setting up new projects, configuring ESLint/Prettier alternatives, monorepos, library publishing, or when the user mentions Anthony Fu's preferences.
backfill-feature
0xdeafcafe
Use when the user says "/backfill-feature", "backfill the ADR", "this feature has no ADR", "I need to document what's already there before I change it", or wants to capture an existing feature's architectural rationale and behaviour *before* modifying it. Reads the relevant code, drafts a reverse-en
effective-go
openshift
Apply Go best practices, idioms, and conventions from golang.org/doc/effective_go. Use when writing, reviewing, or refactoring Go code to ensure idiomatic, clean, and efficient implementations.
solid-principles
SmidigStorm
Enforce SOLID principles (Single Responsibility, Open/Closed, Liskov Substitution, Interface Segregation, Dependency Inversion) in object-oriented design. Use when writing or reviewing classes and modules.
typescript-review
metabase
Review TypeScript and JavaScript code changes for compliance with Metabase coding standards, style violations, and code quality issues. Use when reviewing pull requests or diffs containing TypeScript/JavaScript code.
deepwiki-rs
sopaco
AI-powered Rust documentation generation engine for comprehensive codebase analysis, C4 architecture diagrams, and automated technical documentation. Use when Claude needs to analyze source code, understand software architecture, generate technical specs, or create professional documentation from any programming language.