Tech Debt Audit
Produces a file-cited technical debt report across nine dimensions with fix priorities.
Test report
- Verdict
- Tested · Works
- Score
- Tested
- Jul 11, 2026
- Environment
- Claude Code 2.x (agent harness)
- Upstream re-checked
- Aug 10, 2026 · afadf6d
Installed verbatim (single-file skill, clean YAML frontmatter) and A/B-tested on a TypeScript sample seeded with 8 debt patterns: the skill arm found all 8 including the innerHTML XSS vector that the no-skill baseline missed (baseline: 6/8, plus a few extra valid findings). Trigger keywords are specific and fire cleanly on audit/health-check requests. Note: the doc is written for the oh-my-openagent runtime — it references sg/ast-grep, lsp_diagnostics and task() tooling with no Claude Code fallback, so the methodology degrades to plain grep without them.
Scored on four weighted criteria — install, triggering, output vs. baseline, docs. How scoring works
- Installs cleanly 5/5
- Triggers reliably 4/5
- Output vs. baseline 6/10
- Docs & honesty 3/5
What Tech Debt Audit does
Thorough, file-cited technical debt audit across 9 dimensions using AST-grep (tree-sitter), grep, language-native tooling, and optionally CodeGraph knowledge graph. Produces TECH_DEBT_AUDIT.md with severity, effort estimates, and prioritized fixes. Use when asked for codebase health check, tech debt audit, architecture review, code quality assessment, or cleanup planning. Triggers: 'tech…
How to install Tech Debt Audit
git clone https://github.com/code-yeongyu/oh-my-openagent
cd oh-my-openagent
mkdir -p ~/.claude/skills
cp -r .agents/skills/tech-debt-audit ~/.claude/skills/tech-debt-audit
Skills live in ~/.claude/skills/ (global) or .claude/skills/
(per-project). Restart Claude Code after installing.
Commands — how to trigger Tech Debt Audit
-
/tech-debt-auditProduces a file-cited technical debt report across nine dimensions with fix priorities.
It also activates on plain-language prompts like these:
-
Audit this codebase for technical debt -
Give me a prioritized cleanup plan for this repo -
Check code health and flag architecture problems
Frequently asked questions
- Is the Tech Debt Audit skill free?
- Yes. The skill itself is free from code-yeongyu/oh-my-openagent. SkillProof publishes the install command and an independent test verdict at no cost.
- Does Tech Debt Audit work with Claude Code?
- We tested it with Claude Code 2.x (agent harness) on Jul 11, 2026. Verdict: Tested · Works. Installed verbatim (single-file skill, clean YAML frontmatter) and A/B-tested on a TypeScript sample seeded with 8 debt patterns: the skill arm found all 8 including the innerHTML XSS vector that the no-skill baseline missed (baseline: 6/8, plus a few extra valid findings). Trigger keywords are specific and fire cleanly on audit/health-check requests. Note: the doc is written for the oh-my-openagent runtime — it references sg/ast-grep, lsp_diagnostics and task() tooling with no Claude Code fallback, so the methodology degrades to plain grep without them.
- What is the Tech Debt Audit SkillProof Score?
- 7.2/10 — installs cleanly 5/5, triggers reliably 4/5, output vs. baseline 6/10, docs & honesty 3/5.
- How do I install Tech Debt Audit?
- Copy the install command from this page, run it in your terminal, and restart Claude Code. Skills live in ~/.claude/skills/ (global) or .claude/skills/ inside a project.
- Can I use Tech Debt Audit with Cursor, Copilot, Gemini CLI, Codex or other AI tools?
- The SKILL.md format is native to Claude (Claude Code, Desktop, claude.ai). The instructions inside adapt to other assistants: Cursor rules, GitHub Copilot instructions, Windsurf rules, Custom GPTs, AGENTS.md for OpenAI Codex, and GEMINI.md for Google Gemini CLI — our conversion guides cover each, and the free converter on the tools page does the wrapping for you.