Can I use this for onboarding new developers?

Yes, one of its primary use cases is creating a 'Codebase Map' and documentation that helps new team members understand project structure, tech stacks, and established patterns quickly.

How does this skill differ from standard code analysis?

Unlike basic linters, this skill uses a multi-phase discovery process and Gemini's large context window to understand high-level architectural patterns, intent, and long-term scalability across the entire codebase.

What kind of technical debt does it identify?

It catalogs TODO/FIXME comments, detects dead code, identifies circular dependencies, and surfaces inconsistent implementations of patterns like error handling or API design.

Does it require specific project types?

No, it is designed to be polyglot and supports various structures including monoliths, microservices, and monorepos by identifying package managers and configuration files during the discovery phase.

Gemini Codebase Architect

Name: Gemini Codebase Architect
Author: Expanly

byExpanly

0•

Developer Tools

Performs multi-phase codebase architecture analysis to identify technical debt, map dependencies, and create strategic refactoring roadmaps.

The Gemini Codebase Architect skill provides a structured, seven-phase workflow for conducting deep architectural reviews of entire repositories. By leveraging Gemini's large context window, it moves from initial discovery and mapping to deep analysis of circular dependencies, outdated packages, and architectural drift. This skill is ideal for teams onboarding new members, planning major system migrations, or conducting due diligence, resulting in clear Architectural Decision Records (ADRs) and prioritized technical debt inventories.

Key Features

01Automated technical debt inventory capturing TODOs and deprecated patterns

020 GitHub stars

03Comprehensive dependency auditing for security, age, and duplication

04Scalability assessments tailored to specific growth plans and performance SLAs

05Structured 7-phase review workflow with user interaction checkpoints

06Structural mapping to detect circular dependencies and module boundary violations

Use Cases

01Performing technical due diligence for pre-acquisition or pre-scaling assessments

02Planning major refactors by identifying core bottlenecks and architectural inconsistencies

03Accelerating developer onboarding by generating comprehensive codebase maps and pattern documentation

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add expanly/expanly-claude-code-agents comprehensive-architecture-review

For use in Claude.ai and ChatGPT

Download Skill