Systematic Code Refactoring
luongnv89/claude-howto
Guides refactoring in phases based on Martin Fowler's method: research, test coverage check, planning and small tested steps, with your approval at each phase.
Audits a codebase for technical debt across nine dimensions and writes TECH_DEBT_AUDIT.md with file-cited findings, severity, effort estimates and priorities.
Install Tech Debt Audit
$ npx skills add code-yeongyu/oh-my-openagent --skill tech-debt-audit -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install code-yeongyu/oh-my-openagent tech-debt-audit --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/code-yeongyu/oh-my-openagent.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/tech-debt-audit .claude/skills/tech-debt-audit && rm -rf skills-srcUse ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.
Claude Code skills documentation · loads skills from .claude/skills/
Install the "tech-debt-audit" agent skill from https://github.com/code-yeongyu/oh-my-openagent/tree/dev/.agents/skills/tech-debt-audit into .claude/skills/tech-debt-audit/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "tech-debt-audit", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/code-yeongyu/oh-my-openagent/tree/dev/.agents/skills/tech-debt-auditType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add code-yeongyu/oh-my-openagent --skill tech-debt-audit -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install code-yeongyu/oh-my-openagent tech-debt-audit --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/code-yeongyu/oh-my-openagent.git skills-src && mkdir -p .agents/skills && cp -r skills-src/.agents/skills/tech-debt-audit .agents/skills/tech-debt-audit && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "tech-debt-audit" agent skill from https://github.com/code-yeongyu/oh-my-openagent/tree/dev/.agents/skills/tech-debt-audit into .agents/skills/tech-debt-audit/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "tech-debt-audit", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add code-yeongyu/oh-my-openagent --skill tech-debt-audit -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install code-yeongyu/oh-my-openagent tech-debt-audit --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/code-yeongyu/oh-my-openagent.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/.agents/skills/tech-debt-audit .cursor/skills/tech-debt-audit && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "tech-debt-audit" agent skill from https://github.com/code-yeongyu/oh-my-openagent/tree/dev/.agents/skills/tech-debt-audit into .cursor/skills/tech-debt-audit/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "tech-debt-audit", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/code-yeongyu/oh-my-openagent.git --path .agents/skills/tech-debt-audit--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add code-yeongyu/oh-my-openagent --skill tech-debt-audit -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install code-yeongyu/oh-my-openagent tech-debt-audit --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/code-yeongyu/oh-my-openagent.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/.agents/skills/tech-debt-audit .gemini/skills/tech-debt-audit && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "tech-debt-audit" agent skill from https://github.com/code-yeongyu/oh-my-openagent/tree/dev/.agents/skills/tech-debt-audit into .gemini/skills/tech-debt-audit/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "tech-debt-audit", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install code-yeongyu/oh-my-openagent tech-debt-auditInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add code-yeongyu/oh-my-openagent --skill tech-debt-audit -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/code-yeongyu/oh-my-openagent.git skills-src && mkdir -p .github/skills && cp -r skills-src/.agents/skills/tech-debt-audit .github/skills/tech-debt-audit && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "tech-debt-audit" agent skill from https://github.com/code-yeongyu/oh-my-openagent/tree/dev/.agents/skills/tech-debt-audit into .github/skills/tech-debt-audit/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "tech-debt-audit", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add code-yeongyu/oh-my-openagent --skill tech-debt-audit -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install code-yeongyu/oh-my-openagent tech-debt-audit --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/code-yeongyu/oh-my-openagent.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/.agents/skills/tech-debt-audit .opencode/skills/tech-debt-audit && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "tech-debt-audit" agent skill from https://github.com/code-yeongyu/oh-my-openagent/tree/dev/.agents/skills/tech-debt-audit into .opencode/skills/tech-debt-audit/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "tech-debt-audit", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
Facts
- Skill name
tech-debt-audit- GitHub stars
- 70k
- Token cost
- ~2.4k tokens
- SKILL.md length
- 919 words
- Files
- 1
- Skills in repo
- 44
- Repo updated
- First seen
- Licence
- Custom licence
At a glance
Audits a codebase for technical debt across nine dimensions and writes TECH_DEBT_AUDIT.md with file-cited findings, severity, effort estimates and priorities.
- Works in 4 steps: Orient → Audit Across 9 Dimensions → Deeper Dives (Parallel Sub-Agents) → …
- Getting a codebase health check before a refactoring or cleanup sprint
- SKILL.md covers Output, Phase 0: Orient, Phase 1: Audit Across 9… and Phase 2: Deeper Dives…, plus 3 more sections
- Needs API_KEY
What it does
The agent first orients itself: it maps the language stack from file globs, reads package.json for dependencies and build tooling, checks recent git history for the most-changed files and finds the largest files, treating files that are both high-churn and large as hot zones. It then audits nine dimensions using grep, language-server diagnostics and ast-grep patterns, and every finding has to cite file, line and column.
The excerpt lists thresholds for flagging problems, such as files over 500 lines, functions over 80 lines or more than four levels of nesting, classes with over 15 methods, import cycles, dead exports and long blocks of commented-out code. The TECH_DEBT_AUDIT.md result holds an executive summary, a short architecture model, a findings table with severity and effort in hours, the top five priorities, a checklist of quick wins under 30 minutes, a section for patterns that look bad but are intentional, and open questions for the maintainer.
When your agent uses it
- Getting a codebase health check before a refactoring or cleanup sprint
- Finding god files, import cycles and dead exports in a project
- Producing a prioritized, file-cited debt list to hand to maintainers
Example prompts
- “Do a tech debt audit on this repo and write the report to TECH_DEBT_AUDIT.md.”
- “Find the worst technical debt in this codebase and cite file and line for each item.”
- “Give me quick wins under 30 minutes from a code health check of the services folder.”
Requirements
- ast-grep (the sg command)
- Git history for churn analysis
- The OMO tool set: grep, glob, bash and lsp_diagnostics
Workflow steps
4 steps, taken from the step headings in SKILL.md.
- Orient
- Audit Across 9 Dimensions
- Deeper Dives (Parallel Sub-Agents)
- Synthesize & Deliver
What it can do on your machine
Read from SKILL.md and the folder at commit cbd7dd2. It shows what the files ask for, not the result of running them.
Tool permissions
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Runs code
No scripts in the folder and no shell commands in SKILL.md.
From the folder's file list and the shell code blocks in SKILL.md.
Network
No URLs in SKILL.md.
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names these keys or tokens, usually read from environment variables:
API_KEY
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
Context cost
Tech Debt Audit loads about 2.4k tokens when it runs. Until then it costs about 133 tokens; SKILL.md has 919 words of instructions outside code blocks.
Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.
Safety
Auto-check: notes
The automated check noted patterns worth knowing about, such as sudo or a known installer.
- NoteMentions a .env fileSKILL.md:101
- `grep(".env|process.env|Bun.env")` — env var usage
Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.
SKILL.md
Its licence (Custom licence) doesn't allow us to republish the file, so here is its outline and opening line. It has 919 words (~2,378 tokens).
“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.”
- name
- tech-debt-audit
Files
Just SKILL.md in .agents/skills/tech-debt-audit of code-yeongyu/oh-my-openagent.
Open the folder on GitHubat commit cbd7dd2
Compare with similar skills
Tech Debt Audit next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| Tech Debt Audit this skillcode-yeongyu/oh-my-openagent | 70k | — | ~2.4k | Automated safety check: Notes | Custom licence | |
| Systematic Code Refactoringluongnv89/claude-howto | 42k | — | ~3k | Automated safety check: Pass | MIT | |
| Code Refactoring Workflowluongnv89/claude-howto | 42k | — | ~3.1k | Automated safety check: Pass | MIT | |
| Code Review Skillawesome-skills/code-review-skill | 2.1k | — | ~2.8k | Automated safety check: Notes | MIT | |
| Qt C++ Code Reviewx-tools-author/x-tools | 1.1k | 2 repos | ~4.3k | Automated safety check: Pass | BSD-3-Clause | |
| Skill Doctorwarpdotdev/common-skills | 606 | 2 repos | ~2.6k | Automated safety check: Pass | MIT |
Similar skills
Code Refactoring Workflow
luongnv89/claude-howto
Guides systematic, test-backed refactoring in the style of Martin Fowler, moving through research, planning and small incremental changes with your approval at each phase.
Code Review Skill
awesome-skills/code-review-skill
Provides comprehensive code review guidance for React 19, Vue 3, Angular 17+, Svelte 5, Rust, TypeScript, Java, Java 8, PHP, Ruby, Rails, Python, Django, FastAPI, Go, C/.NET, Kotlin, Swift, Dart…
Qt C++ Code Review
x-tools-author/x-tools
Read-only review of Qt6 C++ code that combines a deterministic lint script with six parallel analysis agents and reports only high-confidence issues.
Skill Doctor
warpdotdev/common-skills
Grades agent skills by scoring agent conversations for efficiency, code quality, procedure compliance, and verbosity, then drafts concrete skill edits and a shareable report.
Tech Debt Analyzer
ailabs-393/ai-labs-claude-skills
This skill should be used when analyzing technical debt in a codebase, documenting code quality issues, creating technical debt registers, or assessing code maintainability.
More from code-yeongyu/oh-my-openagent
All 44 skills in this repoast-grep Structural Search
code-yeongyu/oh-my-openagent
Searches and rewrites code by syntax-tree shape across 25 languages with ast-grep, for codemods, structural queries and YAML lint rules, using a Python wrapper script.
Browser Control with Omowright
code-yeongyu/oh-my-openagent
Drives a real browser through the omowright library, either the user's own signed-in browser or a separate browser the code launches, for forms, QA, screenshots and scraping.
Codex Plugin QA
code-yeongyu/oh-my-openagent
Tests the omo Codex plugin in an isolated CODEX_HOME with a local mock model, proving hooks fired through app-server notifications without touching ~/.codex.
Coding Agent Session Finder
code-yeongyu/oh-my-openagent
Finds, reads and reconstructs past coding-agent sessions across Codex, Claude, OpenCode, Senpi and many other local agent logs.
LSP Setup
code-yeongyu/oh-my-openagent
Detects which languages a project uses, installs the matching language server, writes its config and checks it with a real call so diagnostics and go-to-definition work.
OpenCode QA Toolkit
code-yeongyu/oh-my-openagent
Tests the opencode coding agent itself: its CLI, server, plugin hooks and events, the terminal UI under tmux, and its SQLite session database, using tested helper scripts.
Related
Works with
Categories
Questions about Tech Debt Audit
What does Tech Debt Audit do?
Audits a codebase for technical debt across nine dimensions and writes TECH_DEBT_AUDIT.md with file-cited findings, severity, effort estimates and priorities. json for dependencies and build tooling, checks recent git history for the most-changed files and finds the largest files, treating files that are both high-churn and large as hot zones. It then audits nine dimensions using grep, language-server diagnostics and ast-grep patterns, and every finding has to cite file, line and column.
When should I use Tech Debt Audit?
Tech Debt Audit fits situations like: getting a codebase health check before a refactoring or cleanup sprint; finding god files, import cycles and dead exports in a project; producing a prioritized, file-cited debt list to hand to maintainers.
How do I install Tech Debt Audit in Claude Code?
Run `npx skills add code-yeongyu/oh-my-openagent --skill tech-debt-audit -a claude-code`. Or copy the skill folder (.agents/skills/tech-debt-audit in code-yeongyu/oh-my-openagent) into .claude/skills/tech-debt-audit in your project. Claude Code loads it when a task matches its description.
How do I install Tech Debt Audit in Codex?
Run `npx skills add code-yeongyu/oh-my-openagent --skill tech-debt-audit -a codex`. Or copy the skill folder (.agents/skills/tech-debt-audit in code-yeongyu/oh-my-openagent) into .agents/skills/tech-debt-audit in your project. Codex loads it when a task matches its description.
Can I use Tech Debt Audit in Cursor, Gemini CLI or GitHub Copilot?
Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add code-yeongyu/oh-my-openagent --skill tech-debt-audit -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/tech-debt-audit, .gemini/skills/tech-debt-audit, .github/skills/tech-debt-audit and .opencode/skills/tech-debt-audit in your project.
What does Tech Debt Audit need to run?
Going by SKILL.md and its folder, Tech Debt Audit needs credentials named API_KEY. Our summary lists: ast-grep (the sg command); Git history for churn analysis; The OMO tool set: grep, glob, bash and lsp_diagnostics.
Does Tech Debt Audit access the network?
SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.
Is Tech Debt Audit safe to install?
Our automated static check of SKILL.md found notes only (mentions a .env file), nothing it rates as a warning. It is not a guarantee. Review the folder before installing.
What licence does Tech Debt Audit use?
Tech Debt Audit has a licence file (the repository's licence) that doesn't match a standard licence. Read it on GitHub before reusing the skill.
How many tokens does Tech Debt Audit use?
About 2.4k tokens (SKILL.md is roughly 9.5k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.
What are the alternatives to Tech Debt Audit?
Skills that share tags, products or a category with Tech Debt Audit: Systematic Code Refactoring (luongnv89/claude-howto, 42k stars), Code Refactoring Workflow (luongnv89/claude-howto, 42k stars), Code Review Skill (awesome-skills/code-review-skill, 2.1k stars) and Qt C++ Code Review (x-tools-author/x-tools, 1.1k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
Who maintains Tech Debt Audit?
code-yeongyu (a GitHub user) maintains it in code-yeongyu/oh-my-openagent, which has 69,850 GitHub stars. The repository holds 44 skills in this directory. The repository was last updated on October 7, 2026.
Source: code-yeongyu/oh-my-openagent on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.