Overview
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, LSP, and language-native tooling. Produces TECH_DEBT_AUDIT.md with severity, effort estimates, and prioritized fixes. U…”. The project has 69k 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`). Produces a grounded, citable `TECH_DEBT_AUDIT.md` artifact.
What’s inside
The SKILL.md for tech-debt-audit is organised into these sections:
- Output
- Phase 0: Orient
- Standard (always run)
- 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
- 7. Error Handling & Observability
- 8. Security Hygiene
Installation
Add tech-debt-audit to your agent with:
git clone https://github.com/code-yeongyu/oh-my-openagent ~/.claude/skills/tech-debt-auditReview a skill’s source before installing it — skills can instruct your agent to run commands. This command comes from the skill’s public repository, which is the source of truth for setup steps. New to skills? Read how to install Claude Code skills.
Supported agents
- Codex — declared in the repository topics
- Cursor — declared in the repository topics
- OpenCode — declared in the repository topics
License
code-yeongyu has not declared a standard open-source license for this repository (Other). Confirm the terms with the author before reusing it.
Strengths
- Ships in code-yeongyu/oh-my-openagent, an established project with 69,248 GitHub stars
- Works with Codex, Cursor, OpenCode
- Actively maintained — repository updated in the last 30 days
- Its repository gained 2,357 GitHub stars over the last 52 days
Things to check
- No license declared — confirm terms with the author before reuse
Author
Topics
Alternatives to tech-debt-audit
Similar skills from other repositories:
Frequently asked questions
- What does tech-debt-audit do?
- Thorough, file-cited technical debt audit across 9 dimensions using AST-grep (tree-sitter), grep, LSP, and language-native tooling. 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.
- Which agents does tech-debt-audit work with?
- tech-debt-audit lists Codex, Cursor, and OpenCode — named in its SKILL.md, its plugin marketplace or its repository topics. Skills use the portable SKILL.md format, so other agents that read that format may load it too.
- Where does tech-debt-audit come from?
- tech-debt-audit ships inside code-yeongyu/oh-my-openagent, a repository that contains 49 catalogued skills in total. The repository's 69,248 GitHub stars apply to that whole collection, not to this skill on its own.