An AI coding agent skill for deep architectural analysis of open-source projects. Generates professional-grade architecture reports with design insights, trade-off analysis, and Mermaid diagrams.

Compatible with Claude Code, Codex, OpenClaw, and any AI coding agent that supports the skills format.

中文文档

• 一键生成专业级分析报告：迭代20多轮的深度架构分析Skill，我决定开源了
• Claude Code 源码深度架构分析

npx (Recommended)

npx skills add yzddmr6/repo-analyzer

Plugin Marketplace

/plugin marketplace add yzddmr6/repo-analyzer
/plugin install repo-analyzer@repo-analyzer

Manual (Git Clone)

# macOS / Linux
git clone https://github.com/yzddmr6/repo-analyzer.git ~/.claude/skills/repo-analyzer

# Windows
git clone https://github.com/yzddmr6/repo-analyzer.git %USERPROFILE%\.claude\skills\repo-analyzer

• Architecture-level analysis — Focuses on why things are designed the way they are, not just what the code does
• Adaptive report structure — No fixed template; chapters are designed based on each project's unique characteristics
• Parallel subagent analysis — Spawns multiple agents to analyze core modules concurrently for large codebases
• Competitive positioning — Compares design philosophy and technical trade-offs against similar projects
• Mermaid diagrams — Architecture overviews, data flows, and per-module sequence diagrams throughout the report
• Interactive workflow — Asks targeted questions based on project traits before diving into analysis

Simply ask Claude Code to analyze a project:

分析项目 https://github.com/astral-sh/ruff

分析一下 ollama/ollama 这个仓库的架构

对比分析 express 和 fastify

The skill also accepts owner/repo shorthand, full GitHub/GitLab/Gitee URLs, or local paths.

The skill activates automatically when you mention:

分析项目 分析仓库 分析 GitHub 项目分析 源码分析 架构分析 代码分析 学习这个项目 研究这个框架 看看这个库怎么实现的 对比两个项目 项目评测 框架评测

Note: The skill outputs reports in Chinese by default. If you ask in another language, it follows your language.

After scanning the codebase, the skill asks you to choose a depth level:

1. Clone & Scan — Clones the repo (or uses a local path), counts effective lines of code by module
2. External Research — Web searches for reviews, comparisons, and architecture discussions; crawls the official website
3. Adaptive Q&A — Generates targeted questions based on project characteristics, not a fixed checklist
4. Dynamic Report Structure — Designs chapter layout based on your answers and project traits
5. Parallel Deep Analysis — Spawns subagents for each core module, analyzing them concurrently
6. Cross-Validation — Verifies conclusions across modules, checks code read coverage
7. Multi-Source Fusion — Merges research, module analyses, and insights into a cohesive narrative
8. Final Report — Outputs a single Markdown file with Mermaid diagrams

The final report is saved as a single Markdown file at:

~/repo-analyses/{project-name}-{date}/ANALYSIS_REPORT.md

Every report includes (adapted per project):

• Problem Context — What problem does this solve? Why do existing solutions fall short?
• Competitive Positioning — Design philosophy differences vs. alternatives (not feature checklists)
• Project Overview — Architecture at a glance
• Deep Module Analysis — Why > What analysis with trade-offs and industry comparisons
• Evaluation & Takeaways — Honest assessment of strengths, weaknesses, and lessons learned
• Architecture Diagrams — Mermaid charts for system overview and per-module flows

The skill works with Claude Code's built-in tools out of the box. For enhanced research capabilities, these MCP servers are optional:

• Tavily MCP — Website crawling via tavily_crawl
• Brave Search MCP — Alternative web search provider

repo-analyzer/
├── .claude-plugin/
│   └── plugin.json                         # Plugin metadata
├── package.json                            # Package manifest
├── skills/
│   └── repo-analyzer/
│       ├── SKILL.md                        # Main skill definition
│       └── references/
│           ├── analysis-guide.md           # Analysis philosophy & evaluation framework
│           └── module-analysis-guide.md    # Module analysis guide & subagent templates
├── README.md                               # English documentation
├── README.zh.md                            # Chinese documentation
└── LICENSE                                 # MIT License

Contributions are welcome! Feel free to open issues or submit pull requests.

If you'd like to improve the analysis workflow, the core logic lives in skills/repo-analyzer/SKILL.md. The evaluation framework and subagent templates are in the references/ directory.

MIT