improve-codebase-architecture

Analyze codebase architecture and generate a visual HTML report of refactoring candidates.

Updated Jun 20, 2026
One-click install
npx skills add https://github.com/samuel-morrissey/skills --skill improve-codebase-architecture-samuel-morrissey
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: improve-codebase-architecture
Source: https://github.com/samuel-morrissey/skills/tree/main/skills/improve-codebase-architecture
Command: npx skills add https://github.com/samuel-morrissey/skills --skill improve-codebase-architecture-samuel-morrissey

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill identifies opportunities to deepen codebase architecture, improving testability and maintainability.

Core Features & Use Cases

  • Codebase Analysis: Scans the codebase for shallow modules and potential refactoring opportunities.
  • Visual Report: Generates a visual HTML report showcasing architectural improvements.
  • Interactive Feedback: Allows users to select candidates for further exploration and design refinement.

Quick Start

Run the improve-codebase-architecture skill to analyze your codebase and generate a report.

Frequently Asked Questions about improve-codebase-architecture

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

FAQPage Schema
How do I identify refactoring opportunities to improve codebase architecture and testability?

Codebase architecture analysis identifies shallow modules and surfaces refactoring opportunities to improve testability. It scans your codebase structure to highlight areas where deepening modules would enhance maintainability.

What is a visual report for codebase architecture analysis?

A visual report for codebase architecture analysis is an HTML document showcasing architectural improvement opportunities. It presents identified shallow modules and allows interactive selection of refactoring candidates for further exploration.

How do I find shallow modules in my codebase for refactoring?

Finding shallow modules involves scanning the codebase architecture for deepening opportunities. The analysis identifies these shallow structures and presents them as interactive refactoring candidates within a generated visual report.

Do I need to understand design vocabulary to analyze codebase architecture?

Yes, analyzing codebase architecture requires understanding codebase structure and design vocabulary. This prerequisite knowledge is needed to interpret the visual HTML report and effectively explore the suggested refactoring candidates.

Can I interactively select refactoring candidates after a codebase analysis?

Yes, you can interactively select refactoring candidates after codebase analysis. The process generates a visual HTML report that allows users to select specific shallow modules for further exploration and design refinement.