What is github-search?

Perfect for Development Agents needing efficient GitHub repository and code discovery capabilities. Search GitHub for repos, code, and usage examples using gh CLI. Capabilities: repo discovery, code search, finding library usage patterns, issue/PR search. Actions: search, find, discover repos/code/e

How do I install github-search?

Run the command: npx killer-skills add samhvw8/dotfiles. It works with Cursor, Windsurf, VS Code, Claude Code, and 19+ other IDEs.

What are the use cases for github-search?

Key use cases include: Searching repositories with specific keywords or topics, Debugging issues by finding related code snippets or PRs, Automating GitHub data retrieval for analysis or reporting purposes.

Which IDEs are compatible with github-search?

This skill is compatible with Cursor, Windsurf, VS Code, Trae, Claude Code, OpenClaw, Aider, Codex, OpenCode, Goose, Cline, Roo Code, Kiro, Augment Code, Continue, GitHub Copilot, Sourcegraph Cody, and Amazon Q Developer. Use the Killer-Skills CLI for universal one-command installation.

Are there any limitations for github-search?

Requires GitHub API access or command line installation. Limited to 30 results per query by default. May require additional processing for complex or nuanced search queries.

github-search

Install github-search, an AI agent skill for AI agent workflows and automation. Explore features, use cases, limitations, and setup guidance.

SKILL.md

Readonly

Upstream Repository Material

The section below comes from the upstream repository. Use it as supporting material alongside the fit, use-case, and installation summary on this page.

Upstream Source

GitHub Search

Name: github-search
Availability: InStock
Author: samhvw8

Quick Commands

Goal	Command
Search repos	`gh search repos "<query>" --limit 30`
Search code	`gh search code "<query>" --limit 30`
Search issues	`gh search issues "<query>" --limit 30`
Search PRs	`gh search prs "<query>" --limit 30`

Direct API Search (Web-Exact Results)

For complex queries where gh search repos gives different results than web:

bash
1# Template - URL-encodes query automatically
2gh api "search/repositories?q=$(printf '%s' 'YOUR_QUERY_HERE' | jq -sRr @uri)&sort=updated&per_page=30" --jq '.items[].full_name'

Example - Multi-language with exclusions:

bash
1gh api "search/repositories?q=$(printf '%s' 'stars:>500 language:rust language:go language:TypeScript language:javascript -topic:ethereum -topic:cryptocurrency -topic:blockchain -topic:bitcoin -topic:web3' | jq -sRr @uri)&sort=updated&per_page=10" --jq '.items[].full_name'

Why use this?

gh search repos is a convenience wrapper with its own query parsing
gh api search/repositories hits the raw API, matching web behavior exactly
Required when combining: multiple languages + topic exclusions + star filters

Common jq extractions:

Output	jq filter
Names only	`--jq '.items[].name'`
Full names	`--jq '.items[].full_name'`
With stars	`--jq '.items[] \| "\(.full_name) ⭐\(.stargazers_count)"'`
URLs	`--jq '.items[].html_url'`
Full JSON	(omit --jq)

Patterns

Finding Repositories

When you see: User wants to find projects/repos by criteria Use: gh search repos

bash
1# Basic search with stars
2gh search repos "stars:>500 language:rust" --sort=stars --limit=50
3
4# Multiple languages (OR logic)
5gh search repos "language:rust language:go language:typescript"
6
7# Exclude topics
8gh search repos "stars:>1000 -topic:cryptocurrency -topic:blockchain"
9
10# By topic
11gh search repos "topic:cli topic:terminal stars:>100"
12
13# Recently updated
14gh search repos "language:python pushed:>2024-01-01"

Output formats:

bash
1--json name,url,description,stargazersCount  # JSON output
2--web                                         # Open in browser

Finding Code Examples

When you see: User wants to know how to use a library Use: gh search code

bash
1# Find usage patterns
2gh search code "from zod import" --limit=20
3gh search code "import { z } from 'zod'" --limit=20
4
5# In specific file types
6gh search code "useQuery" extension:tsx --limit=30
7
8# In specific paths
9gh search code "tanstack/query" path:src/ extension:ts
10
11# Exact phrase
12gh search code '"createTRPCRouter"' extension:ts

Pro tip: Combine with repo filter for focused results:

bash
1gh search code "pattern" repo:owner/repo

Finding Issues/Discussions

When you see: User looking for bug reports, feature requests, or discussions Use: gh search issues or gh search prs

bash
1# Open issues with label
2gh search issues "is:open label:bug repo:facebook/react"
3
4# PRs by author
5gh search prs "author:username is:merged"
6
7# Issues mentioning error
8gh search issues '"connection refused" language:go'

Query Qualifiers Reference

Repo Search

Qualifier	Example	Description
`stars:`	`stars:>1000`, `stars:100..500`	Star count
`forks:`	`forks:>100`	Fork count
`language:`	`language:rust`	Primary language
`topic:`	`topic:cli`	Repository topic
`-topic:`	`-topic:blockchain`	Exclude topic
`pushed:`	`pushed:>2024-01-01`	Last push date
`created:`	`created:>2023-01-01`	Creation date
`license:`	`license:mit`	License type
`archived:`	`archived:false`	Archive status
`is:`	`is:public`, `is:private`	Visibility

Code Search

Qualifier	Example	Description
`extension:`	`extension:ts`	File extension
`path:`	`path:src/`	File path
`repo:`	`repo:owner/name`	Specific repo
`language:`	`language:javascript`	Code language
`filename:`	`filename:package.json`	File name

Common Flags

Flag	Description
`--limit N`	Number of results (max 1000)
`--sort X`	Sort by: stars, forks, updated, best-match
`--order X`	asc or desc
`--json FIELDS`	JSON output with specific fields
`--web`	Open results in browser

Common Use Cases

"Find popular X repos"

bash
1gh search repos "language:X stars:>500" --sort=stars --limit=50

"How do people use library Y"

bash
1gh search code "import Y" extension:ts --limit=30
2gh search code "from Y import" extension:py --limit=30

"Find repos like Z but exclude crypto"

bash
1gh search repos "topic:Z -topic:cryptocurrency -topic:blockchain -topic:web3"

"Find recent active projects"

bash
1gh search repos "language:go pushed:>2024-06-01 stars:>100" --sort=updated

Tips

Quote the query when it contains special chars: gh search repos "stars:>500"
Multiple languages = OR: language:rust language:go matches either
Use --json for scripting: --json name,url,stargazersCount
Date ranges: pushed:2024-01-01..2024-06-01
Numeric ranges: stars:100..500
Use gh api for complex queries: When gh search repos gives unexpected results, use gh api search/repositories?q=... for exact web parity

github-search — for Claude Code github-search, dotfiles, community, for Claude Code, ide skills, gh search repos "<query>" --limit 30, gh search code "<query>" --limit 30, gh search issues "<query>" --limit 30, gh search prs "<query>" --limit 30, gh search repos

About this Skill

Features

# Core Topics

Skill Overview

Core Value

Ideal Agent Persona

↓ Capabilities Granted for github-search

! Prerequisites & Limits

About The Source

Browser Sandbox Environment

⚡️ Ready to unleash?

FAQ & Installation Steps

? Frequently Asked Questions