improve-codebase-architecture

Analyze codebase architecture and generate before/after HTML reports.

Updated Jan 29, 2026
One-click install
npx skills add https://github.com/nkabbara/dotfiles --skill improve-codebase-architecture-nkabbara
Or copy as Structured Prompt for Agent
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.