github-repo-search

name	github-repo-search
description	Search a specific GitHub repository for code using gh search and fetch file contents via gh api without cloning. Use when given a repo URL and query to locate logic in remote repos.

GitHub Repo Search (No Clone)

Use this skill to locate code in a specific GitHub repo by URL, summarize matches, and deep-read a chosen file via the GitHub API.

Requirements

• gh CLI installed and authenticated (gh auth status).
• Network access to GitHub.

Inputs to Collect

• Repo URL (e.g. https://github.com/OWNER/REPO)
• Search query (the string or pattern to search)

If any input is missing, ask the user.

Workflow

1. Parse repo

   • Extract OWNER and REPO from the URL.

2. Search code in the repo

   • Run:

     gh search code --repo OWNER/REPO "<query>"
     

   • Prefer JSON output for structured parsing:

     gh search code --repo OWNER/REPO "<query>" --json path,repository,sha,url,textMatches
     

3. Summarize results

   • If zero results, report and ask for a refined query.
   • If multiple files match, list them with paths and brief snippets (from textMatches if present), then ask which file to Deep Read.
   • If a single file matches, proceed to Deep Read confirmation.