🔍 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

Quick Start

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

# 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

# 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

LinkedIn · YouTube · GitHub · Book a Call