github-search
Search GitHub code, repositories, issues, and PRs via gh CLI
When & Why to Use This Skill
The GitHub Search skill empowers Claude to interact directly with the GitHub CLI (gh), enabling advanced searching of code, repositories, issues, and pull requests. By leveraging GitHub's powerful search syntax, it helps developers and teams quickly locate technical information, track project progress, and explore codebases without leaving their workflow, significantly enhancing productivity in software development and maintenance.
Use Cases
- Codebase Exploration: Quickly find specific code snippets, function definitions, or implementation patterns across multiple repositories using language and owner filters.
- Issue and PR Management: Efficiently track bug reports, feature requests, or pending pull requests by searching for specific labels, authors, or status updates to streamline project management.
- Dependency and Repository Research: Discover new repositories or analyze existing ones by searching for specific topics, stars, or recent activity to inform architectural decisions.
| name | github-search |
|---|---|
| description | Search GitHub code, repositories, issues, and PRs via gh CLI |
| allowed-tools | [Bash, Read] |
GitHub Search Skill
When to Use
- Search code across repositories
- Find issues or PRs
- Look up repository information
Instructions
gh search <type> <query> [flags]
Parameters
<type>: Search type -code,repos,issues,prs<query>: Search query (supports GitHub search syntax)--owner: (optional) Filter by repo owner (all search types)--repo: (optional) Filter by repo name (code/issues/prs only)--limit: (optional) Max results to fetch--: (optional) Use before the query when it contains a-qualifier, e.g.-- "bug -label:critical"
Examples
# Search code
gh search code "authentication language:python"
# Search issues
gh search issues "bug label:critical" --owner "anthropics"
# Search pull requests in a repo
gh search prs "is:open review:required" --repo "cli/cli"
Requirements
Requires GitHub CLI (gh) to be installed and authenticated (gh auth status or gh auth login).