Back to search
repo-analyzer
MarketplaceWorks with Claude CodeGitHub
Deep architectural analysis of open-source projects with professional reports
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Checked today
Badge for your README
Markdown
[](/listings/yzddmr6--repo-analyzer)HTML
<a href="/listings/yzddmr6--repo-analyzer"><img src="/api/listings/yzddmr6--repo-analyzer/badge.svg" alt="findsafeskills safety rating" /></a>Install
Install instructions from the README
As written by the repo's author. findsafeskills has not verified these steps.
**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
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
.claude-plugin/marketplace.json · Manifest · 18 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
- {
- "name": "repo-analyzer",
- "description": "Deep architectural analysis of open-source projects with professional reports",
- "owner": {
- "name": "yzddmr6"
- },
- "plugins": [
- {
- "name": "repo-analyzer",
- "description": "Deep architectural analysis of open-source projects with professional reports",
- "version": "1.0.0",
- "source": "./",
- "author": {
- "name": "yzddmr6"
- }
- }
- ]
- }
README.md · README · 145 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
- # Repo Analyzer
- 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](https://claude.ai/claude-code), [Codex](https://github.com/openai/codex), [OpenClaw](https://github.com/anthropics/openclaw), and any AI coding agent that supports the skills format.
- **[中文文档](README.zh.md)**
- ## Related Articles
- - [一键生成专业级分析报告:迭代20多轮的深度架构分析Skill,我决定开源了](https://mp.weixin.qq.com/s/sOPHFaNS8pIkhB4F-FysTQ)
- - [Claude Code 源码深度架构分析](https://mp.weixin.qq.com/s/GjZ-tFBVwfJwK11F1lP5TQ)
- ## Quick Install
- **npx (Recommended)**
- ```bash
- npx skills add yzddmr6/repo-analyzer
- ```
- **Plugin Marketplace**
- ```
- /plugin marketplace add yzddmr6/repo-analyzer
- /plugin install repo-analyzer@repo-analyzer
- ```
- **Manual (Git Clone)**
- ```bash
- # 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
- ```
- ## Features
- - **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
- ## Usage
- 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.
- ### Trigger Keywords
- 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.
- ## Analysis Modes
- After scanning the codebase, the skill asks you to choose a depth level:
- | Mode | Core Module Coverage | Secondary Coverage | Best For |
- |------|---------------------|-------------------|----------|
- | **Quick** | >= 30% | >= 10% | Getting a high-level overview |
- | **Standard** (default) | >= 60% | >= 30% | Regular architecture analysis |
- | **Deep** | >= 90% | >= 60% | Studying every design decision |
- ## How It Works
- 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
- ## Report Output
- 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
- ## Optional Dependencies
- 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](https://github.com/tavily-ai/tavily-mcp) — Website crawling via `tavily_crawl`
- - [Brave Search MCP](https://github.com/anthropics/anthropic-quickstarts/tree/main/brave-search-mcp) — Alternative web search provider
- ## File Structure
- ```
- 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
- ```
- ## Contributing
- 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.
- ## License
- [MIT](LICENSE)
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.