skills.rest
justsml
justsmlCOMMUNITY
Explore all skills by this author →
Website𝕏@justsmlGitHub

codebase-health

Run architecture, debt, and performance tracks to generate a prioritized roadmap.

1|Updated Feb 27, 2026
Search Tags:#architecture#performance#codebase#roadmap#refactor#tech debt#assessment
One-click install
npx skills add https://github.com/justsml/ai-team-skills --skill codebase-health
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: codebase-health
Source: https://github.com/justsml/ai-team-skills/tree/main/codebase-health
Command: npx skills add https://github.com/justsml/ai-team-skills --skill codebase-health

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Assess a codebase's health by running architecture, debt, and performance tracks and synthesizing a prioritized roadmap.

Core Features & Use Cases

  • Architecture mapping to visualize dependencies, data flows, and boundaries.
  • Debt inventory to surface complexity, dead code, dependency risk, and test gaps.
  • Performance profiling to identify algorithmic, I/O, and memory bottlenecks.

Quick Start

Ask the codebase-health skill to run architecture, debt, and performance tracks on your repository and generate a prioritized roadmap.

Frequently Asked Questions about codebase-health

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

FAQPage Schema
How do I assess tech debt and codebase health for a large repository?▼

Assess codebase health by running architecture, debt, and performance tracks to surface complexity, dead code, dependency risk, and test gaps, then synthesize the findings into a prioritized refactor roadmap.

What is the best way to create a refactor roadmap from architecture and performance analysis?▼

Create a refactor roadmap by executing architecture mapping to visualize data flows and boundaries, inventorying debt, and profiling performance bottlenecks to produce a prioritized CODEBASE-HEALTH.md report.

How do I map codebase architecture to identify dependency boundaries and data flows?▼

Map codebase architecture by running the architecture track to visualize dependencies, trace data flows, and define system boundaries, assembling the results into a structured health assessment output directory.

Can I run a codebase health assessment on a medium-sized repository, or is it only for large repos?▼

Codebase health assessments are applicable to both medium and large repositories where governance, refactor planning, and performance improvements are needed to manage architecture and technical debt.

How do I inventory technical debt to find dead code and dependency risks?▼

Inventory technical debt by running the debt track to surface code complexity, identify dead code, evaluate dependency risks, and highlight test gaps across the repository for prioritized remediation.

What's the process for profiling performance bottlenecks during a codebase health check?▼

Profile performance bottlenecks by running the performance track to identify algorithmic, I/O, and memory issues, then compile the results into a comprehensive codebase health and governance roadmap.

Related Skills

Explore More Software Engineering Skills→
WindXRanWindXRan

tech-debt

Scan codebase indicators, maintain a debt register, and generate sprint-ready reports.

Community
Intermediate
vndkubivndkubi

technical-debt-analysis

Identify and prioritize technical debt with effort estimates and business impact.

Community
Advanced
eyadsibaieyadsibai
7

Code Quality

Analyzes code quality including style, complexity, dead code, and type hints.

Community
Advanced
MatrixFounderMatrixFounder
4

skill-adversarial-performance

Audit code for performance bottlenecks against a checklist of anti-patterns.

Community
Intermediate