
from tech-debt-skill503
Run a deliberate, file-cited technical debt and architecture audit that outputs a TECH_DEBT_AUDIT.md with prioritized findings and remediation recommendations.
This skill runs a structured, opinionated technical-debt audit of a codebase and produces a written audit (TECH_DEBT_AUDIT.md) with file:line-cited findings, severity tags, effort estimates, and prioritized remediation steps. It mandates orientation (read manifests, map modules) before judgment and uses concrete tooling where available to ground findings.
Use when you need a comprehensive snapshot of code health: architecture decay, test coverage gaps, dependency issues, performance hotspots, and security hygiene. Ideal for repo maintainers preparing refactors, release readiness checks, or pre-onboarding audits.
Designed for Claude Code or similar code-aware agents that can invoke repo tooling, run commands, and write files. Works best when the agent can spawn subagents for very large repos.
Well-crafted static-analysis skill for Claude Code that walks through a 3-phase tech debt audit (orient, audit, deliver). No bundled scripts — it's a pure prompt skill relying on the agent's tool use (git, rg, npm audit, etc.). The SKILL.md is thorough, opinionated, and well-structured with clear anti-patterns called out (no sycophancy, no rewrites, required citations). Installation uses curl | file redirect (not curl | bash), which is minor. No malicious behavior detected.
Impressive skill design. The 'looks bad but is actually fine' required section is a clever anti-sycophancy measure. Phase 1 orientation before judgment is well-structured. Subagent dispatch for large repos is smart. The only ding is the curl-based installation without checksum verification and the fact that as a pure prompt skill with no scripts, its effectiveness is entirely model-dependent.