spec-gen-analyze-codebase

Analyze codebases with spec-gen to extract architecture, call graphs, and refactoring issues.

270|34|Updated Jan 31, 2026
One-click install
npx skills add https://github.com/clay-good/spec-gen --skill spec-gen-analyze-codebase
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: spec-gen-analyze-codebase
Source: https://github.com/clay-good/spec-gen/tree/main/examples/mistral-vibe/skills/spec-gen-analyze-codebase
Command: npx skills add https://github.com/clay-good/spec-gen --skill spec-gen-analyze-codebase

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Analyzing large codebases to extract architecture, call graphs, refactoring hotspots, and duplication typically requires time-consuming manual exploration. This skill automates that process, delivering a deterministic overview without relying on large language models.

Core Features & Use Cases

  • Performs a full static analysis of a project using spec-gen to generate architecture summaries, call graphs, and refactoring suggestions.
  • Reports top refactoring issues, code duplication, and detected domains to guide architectural decisions.
  • Produces a concise, shareable report suitable for project kickoffs, architecture reviews, and CI-quality gates.

Quick Start

Tell me which project directory to analyze and I will run a full static analysis with spec-gen.

Frequently Asked Questions about spec-gen-analyze-codebase

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

FAQPage Schema
How do I generate a call graph and architecture summary for a large codebase?

Static analysis automates codebase analysis to extract architecture, call graphs, and refactoring hotspots. You provide a local project directory to generate a deterministic overview of code structure and dependencies without relying on large language models.

Can I use static analysis to find code duplication and refactoring issues in Python and Go?

Yes, static analysis detects code duplication and refactoring issues across Python, Go, JavaScript, TypeScript, and other supported languages. It reports top refactoring issues and detected domains to guide architectural decisions.

Do I need a local spec-gen server to run codebase analysis?

Yes, running codebase analysis requires a local spec-gen MCP server. The tool connects to this server to perform deterministic static analysis and extract call graphs, architecture summaries, and duplication reports.

What is the best way to get a deterministic overview of code structure without using LLMs?

Using a language-agnostic static analysis tool is the best way to get a deterministic code structure overview. It extracts architecture and call graphs directly from the source code, ensuring consistent results without LLM variability.

Can I use codebase analysis reports for architecture reviews and CI quality gates?

Yes, codebase analysis produces a concise, shareable report suitable for project kickoffs, architecture reviews, and CI-quality gates. The report includes refactoring issues, code duplication, and detected domains.

Does static analysis work for multiple programming languages in the same project?

Static analysis is language-agnostic and supports JavaScript, TypeScript, Python, Go, and other languages. It provides a unified overview of code structure and dependencies across mixed-language projects.