# Github Research

> Search GitHub issues, PRs, and code using the gh CLI.

- Skill: `block/github-research` (Agent Skill)
- Install (CLI): `npx skillmds@latest add block/github-research`
- Raw SKILL.md: https://api.skillmd.com/api/skills/block/github-research/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Research & Search
- Author: block (https://skillmd.com/u/block)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/block/github-research

---


# GitHub Research

Search GitHub for prior art, implementation patterns, and maintainer decisions.

## Commands

```bash
# Search issues
gh search issues "topic" --repo owner/repo --limit 20 \
  --json number,title,state,url

# Search merged PRs (highest signal)
gh search prs "topic" --repo owner/repo --merged --limit 20 \
  --json number,title,url

# Search code (use query syntax for path filtering)
gh search code "pattern path:src/" --repo owner/repo --limit 20 \
  --json path,textMatches

# Get full issue or PR details
gh issue view 123 --repo owner/repo --json number,title,body,comments
gh pr view 456 --repo owner/repo --json number,title,body,reviews,files
```

## Rate Limits

- Search API: 30 requests/minute
- Check with: `gh api rate_limit --jq '.resources.search'`

## Signal Ranking

1. Merged PRs — decisions that shipped
2. Maintainer comments — authoritative
3. Closed issues with solutions — problems solved
4. Open issues — current problems (lower signal)

## Report Format

```markdown
## Research: [Topic]

### Summary
- Key finding 1 [#123]
- Key finding 2 [PR #456]

### Findings
1. **#123: [Title]** — [summary]. URL: https://...
2. **PR #456: [Title]** — [what it changed]. URL: https://...

### Gaps
- [What you looked for but didn't find]
```

Always include URLs. If nothing relevant exists, say so.