codebase-analysis

Analyze codebases with Codex in a read-only sandbox.

42|2|Updated Nov 20, 2025
One-click install
npx skills add https://github.com/robbyt/claude-skills --skill codebase-analysis-robbyt
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: codebase-analysis
Source: https://github.com/robbyt/claude-skills/tree/main/plugins/gemini/skills/codebase-analysis
Command: npx skills add https://github.com/robbyt/claude-skills --skill codebase-analysis-robbyt

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Deep architectural analysis of codebases using Gemini's codebase_investigator to help you understand structure, dependencies, and debt without touching the code.

This Skill is ideal for onboarding unfamiliar code, mapping components, and identifying technical debt.

Core Features & Use Cases

  • Architecture overview: Generate a high-level map of components and dependencies.
  • Dependency relationships: Identify direct vs. transitive dependencies and hotspots.
  • Technical debt signals: Surface architecture smells and debt risk for planning.
  • Use Case: Onboard to a legacy repo and quickly form an architectural overview.

Quick Start

Run Gemini's codebase_investigator on your project to obtain an analysis report. Do not make any changes. Respond with analysis only.

Frequently Asked Questions about codebase-analysis

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

FAQPage Schema
How do I analyze a codebase to understand its architecture and dependencies?

Codebase analysis uses AI-driven investigation to map components, dependencies, and technical debt in read-only mode. Run the Skill on your project to generate an architecture overview without modifying code.

Can I analyze a legacy codebase to identify technical debt and architecture problems?

Yes. The Skill surfaces architecture smells, debt signals, and dependency hotspots in legacy systems, helping you prioritize refactoring and understand risk areas before making changes.

What do I need to run codebase analysis on my project?

Provide a read-only sandbox environment with your codebase. The Skill executes via MCP Codex CLI or Bash fallback and produces analysis only—no modifications occur.

How does codebase analysis differ from manual code review?

Automated analysis quickly maps dependencies and structural patterns across large codebases without human review latency, surfacing debt and bottlenecks that manual inspection might miss or take longer to identify.

What are the limitations of read-only codebase analysis?

The Skill performs static analysis only and cannot execute code, trace runtime behavior, or validate dynamic dependencies. It excels at structural and architectural discovery, not behavioral verification.

Can I use codebase analysis to onboard new team members to unfamiliar codebases?

Yes. The Skill generates high-level component maps and dependency overviews that help new developers quickly grasp structure and design patterns without deep manual exploration.

Related Skills