improve-codebase-architecture

Analyze codebase architecture and generate before/after HTML reports.

Updated Jan 29, 2026

Search Tags:#code analysis #refactoring #testability #HTML report #codebase architecture

Ready to run

npx skills add https://github.com/nkabbara/dotfiles --skill improve-codebase-architecture-nkabbara

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: improve-codebase-architecture
Source: https://github.com/nkabbara/dotfiles/tree/main/exact_dot_agents/exact_skills/exact_mattpocock/exact_improve-codebase-architecture
Command: npx skills add https://github.com/nkabbara/dotfiles --skill improve-codebase-architecture-nkabbara

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill helps identify and present opportunities to improve the architecture of a codebase, making it easier to test and navigate.

Core Features & Use Cases

Codebase Analysis: Scans a codebase for architectural friction and potential deepening opportunities.
Visual Reporting: Generates a visual HTML report that showcases before/after architectural changes.
Interactive Process: Engages users in an interactive process to discuss and select the best deepening opportunity.

Quick Start

Use the improve-codebase-architecture skill to scan your codebase for architectural improvements.

Frequently Asked Questions about improve-codebase-architecture

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

FAQPage Schema

How do I analyze my codebase architecture to find refactoring opportunities?▼

To analyze your codebase architecture for refactoring opportunities, you can scan your codebase for architectural friction and deepening potential to enhance testability and navigability.

What is the best way to visualize codebase architecture improvements before and after refactoring?▼

Visualizing codebase architecture improvements requires generating an HTML report that uses Mermaid for diagram generation and Tailwind for styling to showcase before and after comparisons.

How do I improve code testability and navigability during a codebase review?▼

Improving code testability and navigability during a codebase review involves identifying architectural deepening opportunities through an interactive process to discuss and select the best refactoring approach.

Do I need Mermaid and Tailwind to generate codebase architecture reports?▼

Yes, generating visual HTML reports for codebase architecture analysis requires Mermaid for diagram generation and Tailwind for styling to properly present the before and after comparisons.

Can I use this codebase architecture analysis for any programming language?▼

The codebase architecture analysis scans for structural friction and deepening opportunities, but the metadata does not specify compatibility restrictions for particular programming languages.