Analyze any GitHub repository in AI-friendly format. Convert entire repos to single markdown documents, generate architecture diagrams with Mermaid, inspect structure trees, language breakdowns, and recent activity. Includes GitHub URL tricks, API shortcuts, and advanced search techniques. Read-only analysis — never executes code from repositories. Built for AI agents — Python stdlib only, no dependencies. Use for repository analysis, code architecture review, open source research, GitHub intelligence, repo documentation, and codebase understanding.
Analyze any GitHub repository in AI-friendly format. Convert repos to markdown, generate architecture diagrams, understand structure and patterns.
| Variable | Required | Description |
|---|---|---|
GITHUB_TOKEN | ❌ | Optional — increases rate limit from 60 to 5000 req/hr. Get from GitHub Settings |
PY=~/.openclaw/workspace/.venv/bin/python3
# Analyze a repository
$PY skills/github-intel/scripts/repo_analyzer.py https://github.com/anthropics/claude-code
# Convert repo to single markdown
$PY skills/github-intel/scripts/repo_to_markdown.py https://github.com/openai/openai-python
# Deep analysis
$PY skills/github-intel/scripts/repo_analyzer.py https://github.com/user/repo --depth 3
# Basic analysis
$PY scripts/repo_analyzer.py https://github.com/owner/repo
# Deep directory traversal
$PY scripts/repo_analyzer.py https://github.com/owner/repo --depth 3
# With authentication for higher rate limits
GITHUB_TOKEN=ghp_xxx $PY scripts/repo_analyzer.py https://github.com/owner/repo
# Convert full repo
$PY scripts/repo_to_markdown.py https://github.com/owner/repo
# Limit files for large repos
$PY scripts/repo_to_markdown.py https://github.com/owner/repo --max-files 50
# Output to file
$PY scripts/repo_to_markdown.py https://github.com/owner/repo > repo.md
# Repository: owner/repo
## Structure
├── src/
│ ├── index.ts
│ └── ...
├── README.md
└── package.json
## README
[Full README content]
## Language Breakdown
- TypeScript: 78.2%
- JavaScript: 15.1%
- Shell: 6.7%
## Architecture (Mermaid)
graph TD
A[CLI Entry] --> B[Command Parser]
...
## Recent Activity
- 2 days ago: feat: add streaming support
- 5 days ago: fix: handle timeout errors
| File | Description |
|---|---|
references/github-tricks.md | URL hacks, API shortcuts, search operators |
| Script | Description |
|---|---|
{baseDir}/scripts/repo_analyzer.py | Full repository analysis with diagrams |
{baseDir}/scripts/repo_to_markdown.py | Convert repo to single markdown document |
This tool is READ-ONLY. It NEVER:
All analysis is static file reading only.
This skill fetches public data from GitHub's API. No data is stored locally beyond the analysis output.
Built by M. Abidi
LinkedIn · YouTube · GitHub · Book a Call