skills.rest
HatmanStack
HatmanStackCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

repo-health

Audit codebase technical debt across architectural, structural, operational, and hygiene vectors.

Updated Feb 20, 2026
Search Tags:#code quality#remediation#technical debt#developer productivity#code audit#codebase health
One-click install
npx skills add https://github.com/HatmanStack/news-investor --skill repo-health-hatmanstack
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: repo-health
Source: https://github.com/HatmanStack/news-investor/tree/main/.claude/skills/repo-health
Command: npx skills add https://github.com/HatmanStack/news-investor --skill repo-health-hatmanstack

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill automates the process of identifying and documenting technical debt within a codebase, providing a clear roadmap for remediation.

Core Features & Use Cases

  • Comprehensive Audit: Assesses technical debt across architectural, structural, operational, and hygiene vectors.
  • Prioritized Findings: Generates a detailed audit document with prioritized issues and quick wins.
  • Use Case: Before onboarding new developers or preparing for a major release, run this Skill to get a clear picture of the codebase's health and identify areas needing immediate attention.

Quick Start

Run the repo-health skill to audit the current codebase for technical debt.

Frequently Asked Questions about repo-health

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

FAQPage Schema
How do I audit my codebase for technical debt?▼

To audit codebase technical debt, you coordinate a comprehensive review across architectural, structural, operational, and hygiene vectors to generate a detailed findings report for pipeline remediation.

What is technical debt remediation and how does an audit help?▼

Technical debt remediation resolves accumulated codebase inefficiencies. An audit identifies and prioritizes these issues across multiple vectors, providing a structured findings report that creates a clear roadmap for codebase health improvements.

How do I identify quick wins during a codebase health check?▼

You identify quick wins during a codebase health check by executing an auditor pass that generates a detailed audit document, highlighting prioritized issues and immediate areas needing attention across architectural and structural vectors.

Can I scope a technical debt audit for specific codebase vectors?▼

Yes, you can scope a technical debt audit by answering scoping questions that identify specific plan parameters, allowing the auditor to target architectural, structural, operational, or hygiene vectors individually.

What is the best way to prepare for a major release by checking codebase health?▼

The best way to prepare for a major release is running a technical debt audit to assess codebase health, which generates a prioritized findings document identifying structural issues and quick wins needing immediate attention.

Does the technical debt audit require agentic capabilities for file system operations?▼

Yes, the technical debt audit requires agentic capabilities to perform file system operations, enabling the auditor to execute plans, analyze the codebase, and write the generated remediation document directly to the file system.

Related Skills

Explore More Software Engineering Skills→
josenaldojosenaldo

process-roadmap

Extract mentorship data from PDF cronogram files into an Obsidian MOC.

Community
Intermediate
Ethical-AI-SyndicateEthical-AI-Syndicate
1

technical-debt-cataloger

Document, prioritize, and plan remediation for technical debt across software projects.

Official
Advanced
prof-danielcprof-danielc

speckit.checker

Run static analysis tools and aggregate results into a prioritized issue report.

Community
Advanced
icartshicartsh
4

code-analyze

Analyze .NET solutions for code quality, security, and dependency issues.

Community
Advanced