ai-assist-tech-debt

Audit repositories for technical debt across 22 dimensions with a 5-tier framework.

87|12|Updated Sep 17, 2024
One-click install
npx skills add https://github.com/jparkerweb/ai-assist-skills --skill ai-assist-tech-debt
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ai-assist-tech-debt
Source: https://github.com/jparkerweb/ai-assist-skills/tree/main/skills/ai-assist-tech-debt
Command: npx skills add https://github.com/jparkerweb/ai-assist-skills --skill ai-assist-tech-debt

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This audit helps engineering teams quickly identify and prioritize technical debt across code quality, architecture, infrastructure, processes, and operational readiness, turning complex debt into actionable remediation.

Core Features & Use Cases

  • 22-dimension, 5-tier debt assessment with severity-ranked findings and a weighted health score.
  • Prioritized remediation plan with concrete actions and owners.
  • Cross-repo applicability for multi-language codebases and monorepos.

Quick Start

Run a comprehensive tech debt audit on the project to generate a prioritized findings report.

Frequently Asked Questions about ai-assist-tech-debt

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

FAQPage Schema
How do I audit technical debt across my entire codebase?

To audit technical debt, this Skill scans your repository to identify and rank issues across code quality, architecture, infrastructure, processes, and operational readiness. It delivers a weighted health score with severity-ranked findings and concrete file evidence.

What is the best way to prioritize technical debt remediation?

Prioritizing technical debt remediation is handled by applying a 22-dimension, 5-tier framework to your codebase. This generates a prioritized remediation plan featuring concrete actions and assigned owners based on severity-ranked findings.

Can I run a tech debt audit on a multi-language monorepo?

Yes, you can run a tech debt audit on a multi-language monorepo. The assessment offers cross-repo applicability, automatically detecting stack characteristics to evaluate code quality and architecture across diverse codebases.

How does the technical debt health score calculation work?

The technical debt health score calculation works by evaluating 22 distinct dimensions across 5 tiers. It assesses code quality, architecture, infrastructure, quality processes, and operational readiness, weighting the findings to deliver a final score.

Does the technical debt audit provide specific code locations for findings?

Yes, the technical debt audit provides specific code locations for findings. It surfaces discovered debt areas with concrete file and line evidence alongside actionable remediation steps to guide immediate fixes.