tech-debt-audit

tech-debt-audit is an open-source workflow skill for Claude Code and compatible agents, published by code-yeongyu. Its author describes it as: “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 es…”. The project has 68k stars on GitHub and ships custom license terms, so review them before reuse. Add it to your setup with `git clone https://github.com/code-yeongyu/oh-my-openagent ~/.claude/skills/tech-debt-audit`.

What tech-debt-audit does

Model-agnostic technical debt audit for oh-my-openagent (OMO). Uses OMO's built-in tools (`grep`, `glob`, `bash` with `sg`, `read`, `lsp_diagnostics`, `task`) plus **optional CodeGraph MCP** for enhanced code graph analysis when available. Produces a grounded, citable `TECH_DEBT_AUDIT.md` artifact.

Installation

Add tech-debt-audit to your agent with:

git clone https://github.com/code-yeongyu/oh-my-openagent ~/.claude/skills/tech-debt-audit

Always review a skill's source before installing it. This command comes from the skill's public repository; the linked repo is the source of truth for exact setup steps.

What's inside

The SKILL.md for tech-debt-audit is organised into these sections:

• CodeGraph Enhancement (Optional)
• Output
• Phase 0: Orient
• Standard (always run)
• CodeGraph Enhancement (if available)
• Phase 1: Audit Across 9 Dimensions
• 1. Architectural Decay
• 2. Consistency Rot
• 3. Type & Contract Debt
• 4. Test Debt
• 5. Dependency & Config Debt
• 6. Performance & Resource Hygiene

When to use it

Reach for tech-debt-audit when you want workflow help from your agent without writing the same instructions every session. Load the skill and the agent picks it up automatically for relevant tasks.

Strengths

• Ships in code-yeongyu/oh-my-openagent, an established project with 68,032 GitHub stars
• Actively maintained (recent commits)

Things to check

• No license declared — confirm terms with the author before reuse

Topics

Frequently asked questions

What does tech-debt-audit do?

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 debt', 'technical debt', 'debt audit', 'code health', 'technical debt audit', 'codebase health check', 'find tech debt', 'debt analysis', 'audit code quality'.

How do I install tech-debt-audit?

Run git clone https://github.com/code-yeongyu/oh-my-openagent ~/.claude/skills/tech-debt-audit in your agent, then reload your skills. Review the source at https://github.com/code-yeongyu/oh-my-openagent before installing.

Is tech-debt-audit free to use?

tech-debt-audit is publicly available on GitHub, but code-yeongyu has not declared a standard open-source license (Other). Confirm the terms with the author before reusing it.

Where does tech-debt-audit come from?

tech-debt-audit ships inside code-yeongyu/oh-my-openagent, a repository that contains 46 catalogued skills in total. The repository's 68,032 GitHub stars apply to that whole collection, not to this skill on its own.