Agent skill

analyze-tech-debt

Analyze and prioritize technical debt with remediation plans. Use when user says "analyze the technical debt in this codebase", "what's the code quality like in this module", "identify what's slowing down our development", "assess the maintenance burden of this legacy code", "create a plan to pay down our tech debt", or "where should we focus our cleanup efforts".

View SKILL.md on GitHub Repository
Stars 30
Forks 9

Install this agent skill to your Project

npx add-skill https://github.com/Uniswap/ai-toolkit/tree/next/packages/plugins/development-codebase-tools/skills/analyze-tech-debt

SKILL.md

Technical Debt Analyzer

Identify, quantify, and prioritize technical debt with ROI-based remediation plans.

When to Activate

  • User mentions technical debt
  • Code quality assessment needed
  • Understanding what's slowing development
  • Legacy code evaluation
  • Maintenance burden analysis

Debt Categories

Code Debt

  • Duplicated Code: Copy-paste, repeated logic
  • Complex Code: High cyclomatic complexity, deep nesting
  • Poor Structure: Circular dependencies, coupling issues

Architecture Debt

  • Design Flaws: Missing abstractions, violations
  • Technology Debt: Outdated frameworks, deprecated APIs

Testing Debt

  • Coverage Gaps: Untested paths, missing edge cases
  • Test Quality: Brittle, slow, or flaky tests

Documentation Debt

  • Missing API docs, undocumented complex logic

Infrastructure Debt

  • Manual deployments, missing monitoring

Impact Assessment

Calculates real cost:

  • Development velocity impact (hours/month)
  • Quality impact (bug rate, fix time)
  • Risk assessment (critical/high/medium/low)

Output Format

Debt Metrics Dashboard

yaml
cyclomatic_complexity:
  current: 15.2
  target: 10.0
code_duplication:
  percentage: 23%
  target: 5%
test_coverage:
  unit: 45%
  target: 80%

Prioritized Roadmap

  • Quick Wins: High value, low effort (Week 1-2)
  • Medium-Term: Features, refactors (Month 1-3)
  • Long-Term: Architecture changes (Quarter 2-4)

ROI Calculations

Each item includes:

  • Effort estimate
  • Monthly savings
  • ROI percentage
  • Payback period

Prevention Strategy

Includes quality gates:

  • Pre-commit hooks
  • CI pipeline checks
  • Code review requirements
  • Debt budget tracking

Recommended Agent Skills

Expand your agent's capabilities with these related and highly-rated skills.

Uniswap/ai-toolkit

review-plan

Review implementation plans for completeness and feasibility. Use when user says "review this plan before I start", "is this implementation plan complete", "check if this plan aligns with our patterns", "give me feedback on my implementation strategy", or "validate this plan before we execute it".

30 9
Explore
Uniswap/ai-toolkit

plan-implementation

Create implementation plans for features and changes. Use when user says "plan how to implement user authentication", "how should I add dark mode to the app", "what's the best way to refactor the database layer", "create a plan for migrating to the new API", or "I need to implement [feature] - help me plan it out".

30 9
Explore
Uniswap/ai-toolkit

execute-plan

Execute implementation plans step-by-step. Use when user says "execute the plan", "implement the plan we created", "start building based on the plan", "go ahead and implement it", "proceed with the implementation", "execute as a stack", "create a PR stack while implementing", "implement with one PR per step", or references a plan file and wants to begin coding.

30 9
Explore
Uniswap/ai-toolkit

generate-commit-message

Generate well-structured git commit messages. Use when user says "generate commit message", "write a commit", "what should my commit message be", "create commit message for these changes", or needs help crafting conventional commit messages.

30 9
Explore
Uniswap/ai-toolkit

plan-swarm

Refine plans through multi-agent expert discussion. Use when user says "get multiple expert opinions on this plan", "I want different perspectives on this approach", "have the agents discuss this strategy", "refine the plan through collaborative review", or "what would different specialists think about this design".

30 9
Explore
Uniswap/ai-toolkit

create-pr

Create or update pull requests with conventional commits. Use when user says "create a PR for these changes", "submit this for review", "open a pull request", "push these changes and create a PR", "I'm ready to submit this work", or "create PR and link to issue

30 9
Explore

Didn't find tool you were looking for?

Be as detailed as possible for better results