repo-analyzer
yzddmr6/repo-analyzer · skills.sh
Open source Repository Open in the app JSON README (API)
About
Skill publicada por yzddmr6/repo-analyzer no skills.sh. Instale com: npx skills add yzddmr6/repo-analyzer@repo-analyzer
Details
- Kind
- Agent skills
- Publisher
- yzddmr6
- Origin
- skillssh
- Category
- ferramentas
- Stars
- 491
- Forks
- 74
- Last push
- 2026-04-27T03:22:27Z
- Repository state
- ativo
- License
- MIT
- Added
- 2026-10-06 04:46:10
- Updated
- 2026-10-06 04:46:10
- Origin id
yzddmr6/repo-analyzer/repo-analyzer
README
# 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.
**[中文文档](https://github.com/yzddmr6/repo-analyzer/blob/HEAD/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](https://github.com/yzddmr6/repo-analyzer/blob/HEAD/LICENSE)