tech-debt

Analyze repository technical debt and generate a prioritized TECH_DEBT.md remediation plan.

19|3|Updated Mar 11, 2026
One-click install
npx skills add https://github.com/dirien/yet-another-agent-harness --skill tech-debt-dirien
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: tech-debt
Source: https://github.com/dirien/yet-another-agent-harness/tree/main/.claude/skills/tech-debt
Command: npx skills add https://github.com/dirien/yet-another-agent-harness --skill tech-debt-dirien

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Systematically identifies, scores, and prioritizes technical debt across architecture, testing, documentation, and infrastructure to produce an actionable remediation plan that accelerates safe development and onboarding.

Core Features & Use Cases

  • Comprehensive scoring: Evaluates categories using a 0–10 rubric with impact and effort to calculate priorities.
  • Delegation to specialized checks: Integrates with code-quality, linting, security, dependency, and design-principles skills when available to enrich findings.
  • Remediation roadmap: Generates a TECH_DEBT.md with executive summary, scorecard, prioritized P1–P4 actions, and success metrics for sprint planning.
  • Use Case: Run on a legacy microservice repository to discover high-impact, low-effort fixes for the upcoming cleanup sprint and produce tracked remediation items.

Quick Start

Run the tech-debt skill to analyze the repository and generate a prioritized TECH_DEBT.md remediation plan.

Frequently Asked Questions about tech-debt

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I prioritize technical debt remediation across architecture, testing, and infrastructure?

Technical debt remediation is prioritized by analyzing repository findings across architecture, testing, documentation, and infrastructure, scoring categories using a 0–10 rubric with impact and effort to calculate priorities and generate a remediation plan.

How do I generate a technical debt report for sprint planning?

Generate a technical debt report by analyzing the repository to produce a TECH_DEBT.md file containing an executive summary, scorecard, prioritized P1–P4 actions, and success metrics tailored for sprint planning.

Can I use existing CI configuration and test frameworks to score technical debt?

You can use existing CI configuration, configured linters, and test frameworks to score technical debt findings. The analysis optionally leverages these tools to enrich the evaluation and produce an actionable remediation plan.

Do I need git availability to analyze repository technical debt?

Git availability is required to analyze repository technical debt. The analysis depends on git to evaluate architecture, testing, documentation, and infrastructure categories and generate the prioritized remediation roadmap.

What is the best way to identify high-impact, low-effort technical debt fixes?

Identify high-impact, low-effort fixes by applying a comprehensive 0–10 scoring rubric that evaluates impact and effort across technical debt categories, calculating priorities to surface actionable items for the upcoming cleanup sprint.

Does technical debt analysis integrate with code-quality, linting, and security checks?

Technical debt analysis delegates to available specialized skills for code-quality, linting, security, dependency, and design checks to enrich findings and produce a comprehensive prioritized remediation plan.