Agent Skills › block/buzz › github-research

github-research

GitHub

使用 gh CLI 搜索 GitHub Issue、PR 和代码，用于调研技术方案、实现模式和决策。提供信号排序建议和标准化 Markdown 报告格式，辅助开发者快速定位相关上下文。

examples/meadow-core/skills/github-research/SKILL.md block/buzz

Trigger Scenarios

需要查找类似实现或技术选型依据查询特定仓库的 Issue 或 PR 状态调研开源项目维护者决策

Install

npx skills add block/buzz --skill github-research -g -y

More Options

Non-standard path

npx skills add https://github.com/block/buzz/tree/main/examples/meadow-core/skills/github-research -g -y

Use without installing

npx skills use block/buzz@github-research

指定 Agent (Claude Code)

npx skills add block/buzz --skill github-research -a claude-code -g -y

安装 repo 全部 skill

npx skills add block/buzz --all -g -y

预览 repo 内 skill

npx skills add block/buzz --list

SKILL.md

Frontmatter

{
    "name": "github-research",
    "description": "Search GitHub issues, PRs, and code using the gh CLI."
}

GitHub Research

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

Commands

# 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

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

Report Format

## 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.