aaddrick/gh-cli-search/gh-search

Trust tier 3
  • community
Source check pending

Checking that the SKILL.md file is still in the repository.

Use when searching GitHub via CLI for issues, PRs, repos, code, or commits - provides correct syntax for exclusions, qualifiers, quoting, and platform-specific handling to avoid command failures

Install

npx vskill@latest install aaddrick/gh-cli-search/gh-search

SKILL.md

GitHub CLI Search

Overview

Search GitHub from the command line using gh search subcommands. The key principle: Always use `--` before queries with exclusions to prevent shell interpretation of - prefixes.

When to Use

Use this skill when:

  • Searching GitHub via gh CLI for issues, PRs, repos, code, or commits
  • User requests searches with exclusions (NOT, minus prefix)
  • Constructing complex queries with multiple qualifiers
  • Queries contain spaces or special characters

Subcommands Quick Reference

SubcommandUse ForCommon Flags
gh search issuesIssues (add --include-prs for PRs too)--label, --state, --author, --assignee
gh search prsPull requests only--label, --state, --author, --draft, --merged
gh search reposRepositories--language, --stars, --topic, --owner
gh search codeCode within files--repo, --language, --filename
gh search commitsCommit messages--repo, --author, --committer

Critical Syntax Rules

1. Exclusions Require -- Flag

Unix/Linux/Mac:

bash
gh search issues -- "bug -label:duplicate"

PowerShell:

powershell
gh --% search issues -- "bug -label:duplicate"

Why: The - prefix gets interpreted as a command flag without --. PowerShell needs --% to stop parsing.

2. Quoting Rules

Multi-word queries need quotes:

bash
gh search issues "memory leak"

Entire query with spaces should be quoted:

bash
gh search issues "bug label:urgent created:>2024-01-01"

Qualifier values with spaces need inner quotes:

bash
gh search prs -- 'security label:"bug fix"'
3. Qualifier Syntax

Inline qualifiers (use within search query):

bash
gh search repos "react stars:>1000 language:typescript"

Flag-based (use as separate flags):

bash
gh search repos "react" --language typescript --stars ">1000"

Can mix both:

bash
gh search issues "crash" --label bug created:>2024-01-01

Common Qualifiers

Comparison Operators
  • >, >=, <, <= - Numeric: stars:>100, comments:>=5
  • .. - Ranges: stars:10..50, created:2024-01-01..2024-12-31
Special Values
  • @me - Current user: author:@me, assignee:@me, owner:@me
  • Dates use ISO8601: created:>2024-01-01 or created:2024-01-01..2024-12-31
Field-Specific Search
  • in:title - Search in title only
  • in:body - Search in body only
  • in:comments - Search in comments only
Exclusions
  • -qualifier:value - Exclude: -label:bug, -language:javascript
  • NOT keyword - For words only: "hello NOT world"

Examples

Find your open issues without bug label:

bash
gh search issues -- "is:open author:@me -label:bug"

Find popular Python ML repos updated recently:

bash
gh search repos "machine learning" --language python --stars ">1000" --updated ">2024-01-01"

Find PRs with specific label and text:

bash
gh search prs -- 'security label:"bug fix" created:>2024-01-01'

Search code in organization repos:

bash
gh search code "TODO" --owner myorg --language javascript

Common Mistakes

MistakeProblemFix
gh search issues -label:bug-label interpreted as flagAdd --: gh search issues -- "-label:bug"
gh search repos machine learningSearches "machine" OR "learning"Quote it: "machine learning"
in:title outside quotesShell interprets : oddlyInclude in query: "crash in:title"
Mixing @ with valueInvalid syntaxUse @me or username, not both: author:@me ✓, author:@username ✗ (drop @)
PowerShell without --%Parsing breaks with exclusionsAdd gh --% before command

Output Options

All subcommands support:

  • --limit <n> - Max results (default: 30, max: 1000)
  • --json <fields> - JSON output for scripting
  • --web - Open results in browser
  • --sort <field> - Sort by: comments, created, reactions, updated, stars, etc.
  • --order asc|desc - Sort direction (default: desc)

Real-World Impact

Correct syntax prevents:

  • Command failures from misinterpreted flags
  • Missing results from incorrect exclusions
  • Errors from unquoted spaces
  • Platform-specific parsing issues

Security

  • Security scanPassed, 100 of 100Pattern checks on the skill's files.
  • Model reviewPassed

See the full security report

Quality evaluation

  • Task evaluationPassed, 83 of 100Effective. 1 run. Evaluated 7 months ago.

See evaluation results

Source

Popularity

Repository stars
3
7-day trend score
7

Stars and forks are for the whole GitHub repository, not this skill alone. Refreshed 17 Mar 2026, 7 months ago.

Works with

Any agent vskill installs to: 56 targets in all. These 39 have a page on this site.

  • Claude Code
  • Cursor
  • GitHub Copilot
  • Windsurf
  • Codex
  • Gemini CLI
  • Cline
  • Amp
  • Roo Code
  • Goose
  • Continue
  • Kilo Code
  • Junie
  • Trae
  • OpenHands
  • Qwen Code
  • AI Agent
  • Tabnine Chat
  • Sourcegraph Cody
  • Amazon Q
  • Firebase Genkit
  • Sweep
  • Devin
  • Phind
  • Mentat
  • Claude Desktop
  • Aider
  • GPT Pilot
  • Plandex
  • bolt.new
  • v0
  • Replit Agent
  • Anse
  • TypingMind
  • BetterChatGPT
  • LibreChat
  • Warp AI
  • Pieces
  • Fig AI
Embed badge
vskill VERIFIED badge
[![vskill VERIFIED](https://verified-skill.com/api/v1/skills/aaddrick/gh-cli-search/gh-search/badge)](https://verified-skill.com/skills/aaddrick/gh-cli-search/gh-search)

Something wrong with this skill or its page? Tell us.