github-intel

# 🔍 GitHub Intelligence Analyze any GitHub repository in AI-friendly format. Convert repos to markdown, generate architecture diagrams, understand structure and patterns. ## Features - **Analyze repo structure** — file tree, README, language breakdown, recent activity - **Generate architecture diagrams** — Mermaid flowcharts from codebase structure - **Convert repo to markdown** — entire repository as a single AI-readable document - **Inspect language breakdown** — percentage by language with file counts - **Track recent activity** — latest commits, contributors, release history - **GitHub URL tricks** — hidden features, API shortcuts, search operators - **Control analysis depth** — configurable directory traversal depth - **Limit file count** — cap files for large repos - **Read-only guarantee** — never executes code from repositories - **Public API access** — no token needed (optional token for higher rate limits) ## Requirements | Variable | Required | Description | |----------|----------|-------------| | `GITHUB_TOKEN` | ❌ | Optional — increases rate limit from 60 to 5000 req/hr. Get from [GitHub Settings](https://github.com/settings/tokens) | ## Quick Start ```bash 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 ``` ## Commands ### Repo Analyzer ```bash # 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 ``` ### Repo to Markdown ```bash # 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 ``` ## Output Format (Analyzer) ``` # 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 ``` ## References | File | Description | |------|-------------| | `references/github-tricks.md` | URL hacks, API shortcuts, search operators | ## Script Reference | Script | Description | |--------|-------------| | `{baseDir}/scripts/repo_analyzer.py` | Full repository analysis with diagrams | | `{baseDir}/scripts/repo_to_markdown.py` | Convert repo to single markdown document | ## ⚠️ Security **This tool is READ-ONLY. It NEVER:** - Executes code from repositories - Runs scripts, makefiles, or build commands - Evaluates any content from repos - Writes to any repository All analysis is static file reading only. ## Data Policy This skill fetches public data from GitHub's API. No data is stored locally beyond the analysis output. --- Built by [M. Abidi](https://www.agxntsix.ai) [LinkedIn](https://www.linkedin.com/in/mohammad-ali-abidi) · [YouTube](https://youtube.com/@aiwithabidi) · [GitHub](https://github.com/aiwithabidi) · [Book a Call](https://cal.com/agxntsix/abidi-openclaw)