Agent skill · data analytics · aradotso
tech-debt-skill
tech-debt-skill — an agent skill for coding agents.
Why this skill is useful
Adds a comprehensive tech debt audit script that evaluates codebases across multiple dimensions, producing actionable insights not typically available in standard tools.
What it needs
Requires claude installed locally. About 6k tokens when loaded. Last updated 2026-07-09. 70 stars on the source repository.
What this skill does
bash mkdir -p ~/.claude/skills/tech-debt-audit curl -o ~/.claude/skills/tech-debt-audit/SKILL.md \ https://raw.githubusercontent.com/ksimback/tech-debt-skill/main/SKILL.md bash mkdir -p .claude/skills/tech-debt-audit curl -o .claude/skills/tech-debt-audit/SKILL.md \ https://raw.githubusercontent.com/ksimback/tech-debt-skill/main/SKILL.md bash claude --print "/skills" grep tech-debt-audit /tech-debt-audit /tech-debt-audit src/payments Before Phase 2, tell me what surprised you in Phase 1 and what you want to investigate that isn't in the dimensions list. markdown Executive summary 3 Critical findings, 12 High, 31 Medium, 18 Low Largest debt concentration: src/payments/ (3 of 3 Critical findings) Estimated remediation effort for Critical+High: ~6 engineer-weeks Mental model src/payments/ is the core revenue path. processor.ts has grown to own routing, validation, retry, and reconciliation — functions that arrived incrementally and were never extracted... Findings ID Category File:Line Severity Effort Description Recommendation ------ --------------------- ------------------------------- ---------- -------- ---------------------------------------------------------- --------------------------------------------------------- F001 Architectural decay src/payments/processor.ts:1240 Critical L 1,400-line god class: routing, validation, retry, recon Extract retry + reconciliation into separate services F002 Type & contract src/api/handlers.ts:88 High S req.body typed as any, propagates to 6 call sites Add zod schema at boundary; infer type downstream ... Top 5 1. F001 — Decompose payments/processor.ts: the retry and reconciliation logic has different failure modes and deployment cadence than routing. Extracting them reduces blast radius for the most-changed file in the repo. 2. ... …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills aradotso/tech-debt-skill