tech-debt-audit

Solid

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'.

AI & Automation 68,941 stars 5670 forks Updated today NOASSERTION

Install

View on GitHub

Quality Score: 83/100

Stars 20%
100
Recency 20%
100
Frontmatter 20%
70
Documentation 15%
100
Issue Health 10%
50
License 10%
100
Description 5%
100

Skill Content

# Tech Debt Audit Protocol 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. ## Output Write results to `TECH_DEBT_AUDIT.md` in the repo root with: 1. **Executive Summary** — 3-5 sentences: overall health, worst dimension, quick wins count 2. **Mental Model** — the repo's architecture in 1 paragraph (what it does, stack, module boundaries) 3. **Findings Table** — columns: ID, Category, File:Line, Severity (Critical/High/Medium/Low), Effort (Hours), Description, Recommendation 4. **Top 5 Priorities** — ranked by impact/effort ratio 5. **Quick Wins Checklist** — items under 30 minutes each 6. **"Looks Bad But Is Fine"** — patterns that look like debt but are intentional 7. **Open Questions** — things the maintainer should clarify ## Phase 0: Orient ### Standard (always run) 1. `glob("**/*.ts")` / `glob("**/*.py")` / etc — map the language stack 2. `glob("**/package.json")` + `read()` — dependencies and build tooling 3. `bash("git log --oneline -200")` — churn: find highest-change files 4. `glob("**/*")` + basic math — find largest files (>300 LOC are candidates) 5. Cross-reference high-churn + large = debt hot zones 6. Write the mental model paragraph in your own working context ## Phase 1: Audit Across 9 Dimensions Use OMO tools for each dimension. Run parallel tool calls within each dimension. Every f...

Details

Author
code-yeongyu
Repository
code-yeongyu/oh-my-openagent
Created
9 months ago
Last Updated
today
Language
TypeScript
License
NOASSERTION

Integrates with

Similar Skills

Semantically similar based on skill content — not just same category

Data & Documents Listed

tech-debt-audit

Tech debt and architecture audit for .NET repos. Produces plans/TECH_DEBT_AUDIT.md with file-cited findings, severity, and effort estimates. Supports module scoping and focused-mode shortcuts (crap, dead-code, duplicates, suppressions, solid) for single-dimension audits. Does not auto-invoke. Triggers on: tech debt audit, debt audit, codebase health check, architecture review, code quality assessment, audit tech debt, tech debt scan, code health, crap analysis, crap score, dead code audit, find dead code, unused types, dup-scan, code duplication, duplicate code, find duplicates, DRY violations, review code suppressions, audit pragma warnings, pragma warning disable, suppression cleanup, code hygiene, SOLID violations, solid review.

2 Updated today
e128
Code & Development Featured

assess-technical-debt

Assess project-wide structural technical debt: complexity hotspots, deprecated API usage, duplication clusters, and architecture rot. Ranks findings by impact and refactor effort into a report at .turbo/technical-debt.md. Use when the user asks to "assess technical debt", "find technical debt", "review technical debt", "what should we refactor", "find refactoring candidates", "where is the code rot", or "what's our worst code". Analysis-only — does not modify code.

402 Updated 2 days ago
tobihagemann
Code & Development Listed

tech-debt

Identify, categorize, and prioritize technical debt across seven dimensions. Generates remediation plans with effort estimates. Offered by /draft:new-track for refactor tracks.

40 Updated 1 weeks ago
drafthq