aj-geddes avatar

Technical Debt Assessment

This gives you a structured way to catalog and prioritize technical debt instead of just complaining about it in standups. It scores debt items by severity, effort, and business impact, then calculates which fixes give you the best ROI. The approach covers code smells, architectural issues, missing tests, and security holes. Works well when you're planning refactoring sprints, evaluating a codebase for acquisition, or trying to convince management that yes, you really do need to fix that legacy authentication system. The quantification angle is honest: you're trading guesswork for something you can actually defend in a planning meeting.

skills.sh installs
509
GitHub stars
379
last updated
Aug 21, 2026

Install

$ npx -y skills add aj-geddes/useful-ai-prompts --skill technical-debt-assessment --agent claude-code

Installs into .claude/skills of the current project.

Files

Technical Debt Assessment

Table of Contents

Overview

Systematically identify, measure, and manage technical debt to make informed decisions about code quality investments.

When to Use

  • Legacy code evaluation
  • Refactoring prioritization
  • Sprint planning
  • Code quality initiatives
  • Acquisition due diligence
  • Architectural decisions

Quick Start

Minimal working example:

interface DebtItem {
  id: string;
  title: string;
  description: string;
  category: "code" | "architecture" | "test" | "documentation" | "security";
  severity: "low" | "medium" | "high" | "critical";
  effort: number; // hours
  impact: number; // 1-10 scale
  interest: number; // cost per sprint if not fixed
}

class TechnicalDebtAssessment {
  private items: DebtItem[] = [];

  addDebtItem(item: DebtItem): void {
    this.items.push(item);
  }

Sponsors

Details

Repository
github.com/aj-geddes/useful-ai-prompts
Categories
Code Review & Quality, AI & Agent Building, Productivity & Planning
First seen
Jun 3, 2026

More from aj-geddes/useful-ai-prompts

All 258
1dalestudy avatarskill-creatordalestudy/skillsDaleStudy/skills 저장소의 스킬 생성, 수정, 검증 시 사용. 다음 상황에서 활성화: (1) 새 스킬 생성 요청 시, (2) skills/ 디렉토리 내 SKILL.md 파일 수정 시, (3) SKILL.md 변경 검토 또는 리뷰 시, (4) 스킬 frontmatter 또는 509skills.sh installs
2mvanhorn avatarpp-weather-goatmvanhorn/printing-press-libraryUse this skill whenever the user asks about weather, forecasts, temperature, rain, storms, severe weather alerts, air quality, pollen, UV, or wants an activity 507skills.sh installs
3freestylefly avatarcanghe-slide-deckfreestylefly/canghe-skillsGenerates professional slide deck images from content. Creates outlines with style instructions, then generates individual slide images. Use when user asks to "506skills.sh installs
4ggprompts avatarbubbleteaggprompts/tfeBuild terminal user interfaces with Go and Bubbletea framework. Use for creating TUI apps with the Elm architecture, dual-pane layouts, accordion modes, mouse/k505skills.sh installs
5aj-geddes avatartest-automation-frameworkaj-geddes/useful-ai-promptsDesign and implement scalable test automation frameworks with Page Object Model, fixtures, and reporting. Use for test framework, page object pattern, test arch504skills.sh installs
6longbridge avatarlongbridge-financial-planninglongbridge/skillsPersonal financial planning framework for China / HK / Singapore investors via Longbridge — retirement savings targets (based on current Longbridge account net 504skills.sh installs