github-deep-research

npx skills add HezaoHezao/poirot --skill github-deep-research --agent claude-code

Same command for any agent — swap --agent for codex, cursor, copilot.

# GitHub Deep Research Multi-round research combining GitHub API, `web_search`, and `browse_page` to produce comprehensive markdown reports on any GitHub repository. > **Poirot note:** The original deer-flow skill uses a bundled > `scripts/github_api.py` helper. Poirot doesn't bundle that script, so this > version uses `bash` with `curl` to the GitHub API directly + `gh` CLI when > available. ## When to Use - User provides a GitHub repository URL - User asks for comprehensive analysis, timeline reconstruction, competitive analysis, or in-depth investigation of an open source project - User wants to understand a project's architecture, history, or community ## Research Workflow - Round 1: GitHub API (repo metadata, README, file tree, contributors, commits) - Round 2: Discovery (web search for overview, competitors) - Round 3: Deep Investigation (architecture, timeline, community sentiment) - Round 4: Deep Dive (commit history, issues/PRs for feature evolution) ## Round 1 — GitHub API ### Setup ```bash # Resolve owner/repo from remote URL REMOTE_URL=$(git remote get-url origin 2>/dev/null || echo "") # Or user provides owner/repo directly OWNER="owner" REPO="repo" ``` ### Repo metada

Resolve owner/repo from remote URL
Or user provides owner/repo directly
Repo summary
curl -s "https://api.github.com/repos/$OWNER/$REPO" | python3 -c "
import sys, json
r = json.load(sys.stdin)
README
curl -s "https://api.github.com/repos/$OWNER/$REPO/readme" | python3 -c "
import sys, json, base64
Recent commits