format-tech-debt

Convert tech debt assessments into prioritized, ROI-driven refactoring tasks.

1|Updated Jan 25, 2019

Search Tags:#code quality #architecture #performance #refactoring #dependencies #technical debt #prioritization #ROI

One-click install

npx skills add https://github.com/nathanvale/dotfiles --skill format-tech-debt

Or copy as Structured Prompt for Agent▼

Please help me install this Agent Skill.
Skill: format-tech-debt
Source: https://github.com/nathanvale/dotfiles/tree/main/.claude/plugins/marketplaces/user-marketplace/plugins/task-streams/skills/format-tech-debt
Command: npx skills add https://github.com/nathanvale/dotfiles --skill format-tech-debt

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires bun, and includes scripts (resource) and references (resource) components.

What problem does it solve?

Technical debt often accumulates without clear prioritization, leading to slower development, increased bugs, and missed deadlines. This skill transforms raw tech debt assessments into actionable, ROI-driven refactoring tasks, ensuring that efforts are focused on the most impactful improvements.

Core Features & Use Cases

ROI-Based Prioritization: Calculates Return on Investment for each debt item, prioritizing based on development velocity impact, business risk, and effort.
Comprehensive Refactoring Plan: Generates detailed remediation steps, including preparation, implementation, validation, and deployment strategies.
Quantified Impact: Extracts and quantifies business impact (e.g., users affected, performance degradation, compliance risks) and risk of deferring.
Use Case: You have a code quality report highlighting several areas of high cyclomatic complexity and code duplication. Use this skill to convert these findings into prioritized refactoring tasks, complete with estimated effort, success metrics, and a clear migration strategy, making it easy to justify and plan the work.

Quick Start

Use the format-tech-debt skill to analyze the attached 'Q4-debt-assessment.md' and generate prioritized refactoring tasks.