Does this skill modify my source code?

No. This skill is explicitly configured to run in a read-only sandbox to ensure that analysis remains non-destructive and safe for any environment.

How long does a typical codebase scan take?

Simple analyses usually complete in 5-30 seconds, while comprehensive scans of large repositories with many files may take between 1 and 3 minutes.

What happens if the MCP tool is not available?

The skill includes a Bash fallback command that can execute the Codex CLI directly, provided you have enabled the appropriate permissions in your environment.

What is the benefit of using Codex for analysis?

Codex acts as an expert consultant, providing high-level architectural insights and identifying hidden patterns that simple grep searches might miss.

Can I use this for dependency auditing?

Yes, it is designed to find outdated packages, circular dependencies, and assess the bundle size impact of various libraries.

Codebase Architecture Analysis

Name: Codebase Architecture Analysis
Author: robbyt

byrobbyt

•

Learning & Documentation

Analyzes complex codebase structures and maps component dependencies using the Codex CLI in a secure, read-only environment.

The Codebase Analysis skill leverages the Codex CLI to provide developers with a comprehensive overview of their project's architecture. It is specifically designed for high-stakes tasks such as onboarding to unfamiliar repositories, documenting legacy systems, and auditing technical debt. By running in a strictly enforced read-only sandbox, it safely extracts component relationships, authentication flows, and dependency trees, providing immediate clarity on how a system is constructed without the risk of accidental modifications.

Key Features

01Support for both MCP-native tools and Bash-based CLI fallbacks

02Secure execution via a mandatory read-only sandbox environment

03Detailed dependency analysis covering direct, transitive, and circular links

0431 GitHub stars

05Automated identification of technical debt and legacy system bottlenecks

06Comprehensive architectural mapping and component relationship discovery

Use Cases

01Performing deep-dive technical audits to identify outdated or bloated packages

02Onboarding developers to large or poorly documented legacy codebases

03Mapping complex data flows and authentication paths across multiple files

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add robbyt/claude-skills codebase-analysis

For use in Claude.ai and ChatGPT

Download Skill