Technical Debt Assessment

technical-debt-assessment

Assess, quantify, and prioritize technical debt using code analysis, metrics, and impact analysis. Use when planning refactoring, evaluating codebases, or making architectural decisions.

aj-geddes/useful-ai-prompts·399installs351stars

SKILL.md

Full skill instructions

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);
  }

  calculatePriority(item: DebtItem): number {
    const severityWeight = {
      low: 1,
      medium: 2,
      high: 3,
      critical: 4,
    };
// ... (see reference guides for full implementation)

Reference Guides

Detailed implementations in the references/ directory:

Guide	Contents
Technical Debt Calculator	Technical Debt Calculator
Code Quality Scanner	Code Quality Scanner

Best Practices

✅ DO

Quantify debt impact
Prioritize by ROI
Track debt over time
Include debt in sprints
Document debt decisions
Set quality gates

❌ DON'T

Ignore technical debt
Fix everything at once
Skip impact analysis
Make emotional decisions

Install skill

Copy and run in your terminal

npx -y skills add https://github.com/aj-geddes/useful-ai-prompts --skill technical-debt-assessment

View on GitHub

technical-debt-assessment

nodejs-express-server
Build production-ready Express.js servers with middleware, authentication, routing, and database integration. Use when creating REST APIs, managing requests/responses, implementing middleware chains, and handling server logic.
3.3K installs
code-review-analysis
Perform comprehensive code reviews with best practices, security checks, and constructive feedback. Use when reviewing pull requests, analyzing code quality, checking for security vulnerabilities, or providing code improvement suggestions.
2.4K installs
rest-api-design
Design RESTful APIs following best practices for resource modeling, HTTP methods, status codes, versioning, and documentation. Use when creating new APIs, designing endpoints, or improving existing API architecture.
2.1K installs
architecture-diagrams
Create system architecture diagrams using Mermaid, PlantUML, C4 model, flowcharts, and sequence diagrams. Use when documenting architecture, system design, data flows, or technical workflows.
2K installs

More skills from aj-geddes

aj-geddes/useful-ai-prompts

jenkins-pipeline

Build Jenkins declarative and scripted pipelines with stages, agents, parameters, and plugins. Implement multi-branch pipelines and deployment automation.

351 1.8K

View

aj-geddes/useful-ai-prompts

ansible-automation

Infrastructure automation and configuration management using Ansible playbooks, roles, and inventory. Use for deploying applications, patching, and managing servers.

351 1.7K

View

aj-geddes/useful-ai-prompts

ios-swift-development

Develop native iOS apps with Swift. Covers MVVM architecture, SwiftUI, URLSession for networking, Combine for reactive programming, and Core Data persistence.

351 1.5K

View

aj-geddes/useful-ai-prompts

android-kotlin-development

Develop native Android apps with Kotlin. Covers MVVM with Jetpack, Compose for modern UI, Retrofit for API calls, Room for local storage, and navigation architecture.

351 1.5K

View

aj-geddes/useful-ai-prompts

wireframe-prototyping

Create wireframes and interactive prototypes to visualize user interfaces and gather feedback early. Use tools and techniques to communicate design ideas before development.

351 1.4K

View

aj-geddes/useful-ai-prompts

Develop lightweight Flask APIs with routing, blueprints, database integration, authentication, and request/response handling. Use when building RESTful APIs, microservices, or lightweight web services with Flask.

351 1.4K

View

aj-geddes/useful-ai-prompts

nginx-configuration

Configure Nginx web server for high-performance reverse proxy, load balancing, SSL/TLS, caching, and API gateway functionality.

351 1.4K

View

aj-geddes/useful-ai-prompts

markdown-documentation

Master markdown formatting, GitHub Flavored Markdown, README files, and documentation formatting. Use when writing markdown docs, READMEs, or formatting documentation.

351 1.3K

View

aj-geddes/useful-ai-prompts

css-architecture

Organize CSS using BEM, SMACSS, and CSS-in-JS patterns. Use when building scalable, maintainable styling systems with proper naming conventions.

351 712

View

aj-geddes/useful-ai-prompts

penetration-testing

Ethical hacking and security testing methodologies using penetration testing tools, exploit frameworks, and manual security validation. Use when assessing application security posture and identifying exploitable vulnerabilities.

351 712

View

aj-geddes/useful-ai-prompts

event-sourcing

Implement event sourcing and CQRS patterns using event stores, aggregates, and projections. Use when building audit trails, temporal queries, or systems requiring full history.

351 711

View

aj-geddes/useful-ai-prompts

responsive-web-design

Create responsive layouts using CSS Grid, Flexbox, media queries, and mobile-first design. Use when building adaptive interfaces that work across all devices.

351 699

View