What documentation files can this skill update?

The skill can automatically draft and apply updates to README.md, CLAUDE.md, and AGENTS.md, ensuring your project documentation stays in sync with the actual code structure.

Does it support visual diagrams?

Yes, it integrates with a technical diagrams skill to produce Mermaid.js charts for architecture overviews and relationship maps directly within your analysis report.

Is this suitable for large-scale enterprise repositories?

Absolutely. The skill uses a parallel exploration strategy with multiple 'explorer' agents to parse large directory structures and synthesize findings without losing context.

Can it help me fix the problems it finds?

Yes. In Phase 3, the skill extracts actionable items from the report and offers to fix them. Simple fixes are applied directly, while complex architectural changes can be delegated to specialized sub-agents.

How does the caching system work?

It stores exploration findings in a manifest file within the .claude directory. This allows the skill to bypass redundant deep-scans and deliver near-instant reports on subsequent runs within a 24-hour window.

Codebase Analysis & Architecture Mapping

Name: Codebase Analysis & Architecture Mapping
Author: sequenzia

bysequenzia

•

Productivity & Workflow

Generates comprehensive architectural reports and actionable insights to help developers master complex codebases quickly.

Codebase Analysis is a high-performance diagnostic skill for Claude Code designed to automate the process of understanding and documenting large-scale projects. By executing a structured three-phase workflow—deep exploration, multi-dimensional reporting, and post-analysis documentation—it provides developers with architectural maps, tech stack identification, and severity-ranked recommendations. This skill is particularly valuable for onboarding to new repositories, auditing technical debt, or maintaining project-specific documentation like CLAUDE.md and README files through an intelligent, agent-driven synthesis process.

Key Features

01Interactive 'Actionable Insights' workflow that ranks and fixes codebase risks.

02Visual architecture mapping with automated Mermaid.js diagram generation.

03Automated documentation syncing for README.md, CLAUDE.md, and AGENTS.md.

04Smart exploration caching to maintain performance across long-running sessions.

05Multi-phase deep exploration using specialized synthesizer and explorer agents.

0622 GitHub stars

Use Cases

01Automating the maintenance of internal project documentation and agent instructions.

02Performing technical debt audits to identify complexity hotspots and architectural risks.

03Accelerating developer onboarding by providing an instant, high-level map of an unfamiliar project.

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add sequenzia/agent-alchemy codebase-analysis

For use in Claude.ai and ChatGPT

Download Skill