{"id":"08cc4482-8b52-4187-83e3-932e83cd0309","shortId":"RkDJrY","kind":"skill","title":"github-navigator","tagline":"GitHub operations via gh CLI. CRITICAL: Use instead of WebFetch for any `github.com` URL or GitHub repo path like `owner/repo`. Use when the user asks to inspect repositories, files, issues, pull requests, releases, Actions runs, or repository structure. Use when the user says 's","description":"# GitHub Navigator\n\nUse `gh` for GitHub work. Prefer command discovery over memorizing flags.\n\nThis is an execution skill. Use `gh` instead of generic web fetching for GitHub tasks, inspect `gh --help` when syntax is uncertain, then execute with tight guardrails. Keep the main flow lean and load [REFERENCES.md](REFERENCES.md) only when you need concrete examples, installation steps, or GraphQL details.\n\n## When to Use\n\nActivate when:\n\n- the user gives a `github.com` URL\n- the user names a repo path like `facebook/react` or `owner/repo`\n- the user asks about repository files, issues, PRs, releases, workflows, or metadata\n- the user wants to understand the architecture or structure of a GitHub-hosted codebase\n\n## Core Rules\n\n- Always prefer `gh` over `WebFetch` for GitHub content and operations.\n- Use `gh api` for raw file content, directory listings, and API-only endpoints.\n- Use `gh` subcommands (`issue`, `pr`, `release`, `run`, `workflow`, `repo`) when a dedicated command exists.\n- Use `gh <domain> --help` before guessing flags or subcommands.\n- Limit each command pattern to 2 attempts; if it still fails, stop and report the error.\n\n## Command Routing\n\n| User Intent | Primary Command Path |\n|-------------|----------------------|\n| fetch file or list directory | `gh api repos/OWNER/REPO/contents/...` |\n| inspect issues | `gh issue ...` |\n| inspect pull requests | `gh pr ...` |\n| inspect releases | `gh release ...` |\n| inspect Actions runs or workflows | `gh run ...` or `gh workflow ...` |\n| inspect repo metadata or clone/fork | `gh repo ...` |\n| endpoints without a dedicated subcommand | `gh api ...` |\n\nUse dedicated subcommands first. Fall back to `gh api` only when needed.\n\n## Execution Pattern\n\n1. Identify the command domain from the request.\n2. Check the relevant help output if the exact syntax is not already obvious.\n3. Substitute the user's repo, path, issue number, PR number, or other arguments.\n4. Run the command.\n5. If it fails, adjust once based on the error message.\n6. If it fails again, stop and report the error instead of trying blind variations.\n\n## Deep Analysis Mode\n\nWhen the user wants to understand a codebase deeply, clone it locally for inspection instead of making many remote API calls.\n\nDefault flow:\n\n1. Clone with depth 1 to `/tmp/github-navigator/OWNER-REPO/`\n\n   ```bash\n   git clone --depth 1 https://github.com/OWNER/REPO.git /tmp/github-navigator/OWNER-REPO\n   ```\n\n2. Inspect the repository for:\n   - tech stack signals (`package.json`, `go.mod`, `Cargo.toml`, `pom.xml`, `requirements.txt`, etc.)\n   - high-level directory structure\n   - entry points and primary modules\n   - README, docs, examples, and contribution files\n   - architectural patterns worth calling out\n\n3. Summarize the findings in plain language.\n4. Keep the clone for follow-up questions unless cleanup is requested.\n\nUse a full clone only if the user explicitly needs commit history or deeper git analysis.\n\n## Safety\n\nAlways confirm before executing state-changing or destructive commands, including:\n\n- creating, closing, or reopening issues\n- creating, merging, or closing pull requests\n- deleting, archiving, or transferring repositories\n- setting secrets or triggering workflows\n- any use of `--force`, `--yes`, or similar bypass flags\n\n## Authentication and Recovery\n\n- Check `gh auth status` when the task touches private repos or write operations.\n- Use `gh auth login` if the client is not authenticated.\n- If permissions are insufficient, use `gh auth refresh -s repo -s workflow -s read:org` as appropriate.\n- If a command fails, read the error, check help, retry once, then stop.\n- If `gh` is not installed, point the user to [REFERENCES.md](REFERENCES.md) for installation guidance.\n\n## Reference Handoff\n\nUse [REFERENCES.md](REFERENCES.md) when you need:\n\n- concrete example commands for common tasks\n- install and auth setup details\n- troubleshooting reminders\n- GraphQL examples or other lower-frequency patterns\n\n---\n\n> **License:** MIT\n> **See also:** [REFERENCES.md](REFERENCES.md)","tags":["github","navigator","agent","skills","arvindand","agent-skills","ai-agents","ai-tools","claude-code","developer-tools","github-copilot","llm"],"capabilities":["skill","source-arvindand","skill-github-navigator","topic-agent-skills","topic-ai-agents","topic-ai-tools","topic-claude-code","topic-developer-tools","topic-github-copilot","topic-llm","topic-mcp","topic-opencode","topic-skills"],"categories":["agent-skills"],"synonyms":[],"warnings":[],"endpointUrl":"https://skills.sh/arvindand/agent-skills/github-navigator","protocol":"skill","transport":"skills-sh","auth":{"type":"none","details":{"cli":"npx skills add arvindand/agent-skills","source_repo":"https://github.com/arvindand/agent-skills","install_from":"skills.sh"}},"qualityScore":"0.455","qualityRationale":"deterministic score 0.46 from registry signals: · indexed on github topic:agent-skills · 11 github stars · SKILL.md body (4,039 chars)","verified":false,"liveness":"unknown","lastLivenessCheck":null,"agentReviews":{"count":0,"score_avg":null,"cost_usd_avg":null,"success_rate":null,"latency_p50_ms":null,"narrative_summary":null,"summary_updated_at":null},"enrichmentModel":"deterministic:skill-github:v1","enrichmentVersion":1,"enrichedAt":"2026-04-24T07:03:31.091Z","embedding":null,"createdAt":"2026-04-23T13:04:11.464Z","updatedAt":"2026-04-24T07:03:31.091Z","lastSeenAt":"2026-04-24T07:03:31.091Z","tsv":"'/owner/repo.git':392 '/tmp/github-navigator/owner-repo':384,393 '1':286,378,382,389 '2':209,294,394 '3':308,429 '4':322,436 '5':326 '6':337 'action':37,249 'activ':111 'adjust':330 'alreadi':306 'also':609 'alway':158,466 'analysi':353,464 'api':170,179,233,271,280,374 'api-on':178 'appropri':549 'architectur':147,424 'archiv':489 'argument':321 'ask':28,131 'attempt':210 'auth':512,525,539,593 'authent':507,532 'back':277 'base':332 'bash':385 'blind':350 'bypass':505 'call':375,427 'cargo.toml':404 'chang':472 'check':295,510,557 'cleanup':446 'cli':8 'client':529 'clone':364,379,387,439,452 'clone/fork':262 'close':478,485 'codebas':155,362 'command':56,194,206,220,225,289,325,475,552,587 'commit':459 'common':589 'concret':101,585 'confirm':467 'content':165,174 'contribut':422 'core':156 'creat':477,482 'critic':9 'dedic':193,268,273 'deep':352 'deeper':462 'deepli':363 'default':376 'delet':488 'depth':381,388 'destruct':474 'detail':107,595 'directori':175,231,411 'discoveri':57 'doc':419 'domain':290 'endpoint':181,265 'entri':413 'error':219,335,346,556 'etc':407 'exact':302 'exampl':102,420,586,599 'execut':64,84,284,469 'exist':195 'explicit':457 'facebook/react':126 'fail':214,329,340,553 'fall':276 'fetch':72,227 'file':32,134,173,228,423 'find':432 'first':275 'flag':60,201,506 'flow':91,377 'follow':442 'follow-up':441 'forc':501 'frequenc':604 'full':451 'generic':70 'gh':7,51,67,77,160,169,183,197,232,237,242,246,253,256,263,270,279,511,524,538,564 'git':386,463 'github':2,4,19,48,53,74,153,164 'github-host':152 'github-navig':1 'github.com':16,117,391 'github.com/owner/repo.git':390 'give':115 'go.mod':403 'graphql':106,598 'guardrail':87 'guess':200 'guidanc':576 'handoff':578 'help':78,198,298,558 'high':409 'high-level':408 'histori':460 'host':154 'identifi':287 'includ':476 'inspect':30,76,235,239,244,248,258,368,395 'instal':103,567,575,591 'instead':11,68,347,369 'insuffici':536 'intent':223 'issu':33,135,185,236,238,315,481 'keep':88,437 'languag':435 'lean':92 'level':410 'licens':606 'like':22,125 'limit':204 'list':176,230 'load':94 'local':366 'login':526 'lower':603 'lower-frequ':602 'main':90 'make':371 'mani':372 'memor':59 'merg':483 'messag':336 'metadata':140,260 'mit':607 'mode':354 'modul':417 'name':121 'navig':3,49 'need':100,283,458,584 'number':316,318 'obvious':307 'oper':5,167,522 'org':547 'output':299 'owner/repo':23,128 'package.json':402 'path':21,124,226,314 'pattern':207,285,425,605 'permiss':534 'plain':434 'point':414,568 'pom.xml':405 'pr':186,243,317 'prefer':55,159 'primari':224,416 'privat':518 'prs':136 'pull':34,240,486 'question':444 'raw':172 'read':546,554 'readm':418 'recoveri':509 'refer':577 'references.md':95,96,572,573,580,581,610,611 'refresh':540 'releas':36,137,187,245,247 'relev':297 'remind':597 'remot':373 'reopen':480 'repo':20,123,190,259,264,313,519,542 'report':217,344 'repos/owner/repo/contents':234 'repositori':31,40,133,397,492 'request':35,241,293,448,487 'requirements.txt':406 'retri':559 'rout':221 'rule':157 'run':38,188,250,254,323 'safeti':465 'say':46 'secret':494 'see':608 'set':493 'setup':594 'signal':401 'similar':504 'skill':65 'skill-github-navigator' 'source-arvindand' 'stack':400 'state':471 'state-chang':470 'status':513 'step':104 'still':213 'stop':215,342,562 'structur':41,149,412 'subcommand':184,203,269,274 'substitut':309 'summar':430 'syntax':80,303 'task':75,516,590 'tech':399 'tight':86 'topic-agent-skills' 'topic-ai-agents' 'topic-ai-tools' 'topic-claude-code' 'topic-developer-tools' 'topic-github-copilot' 'topic-llm' 'topic-mcp' 'topic-opencode' 'topic-skills' 'touch':517 'transfer':491 'tri':349 'trigger':496 'troubleshoot':596 'uncertain':82 'understand':145,360 'unless':445 'url':17,118 'use':10,24,42,50,66,110,168,182,196,272,449,499,523,537,579 'user':27,45,114,120,130,142,222,311,357,456,570 'variat':351 'via':6 'want':143,358 'web':71 'webfetch':13,162 'without':266 'work':54 'workflow':138,189,252,257,497,544 'worth':426 'write':521 'yes':502","prices":[{"id":"170125a7-9a03-4860-a553-bec8b83ffeb3","listingId":"08cc4482-8b52-4187-83e3-932e83cd0309","amountUsd":"0","unit":"free","nativeCurrency":null,"nativeAmount":null,"chain":null,"payTo":null,"paymentMethod":"skill-free","isPrimary":true,"details":{"org":"arvindand","category":"agent-skills","install_from":"skills.sh"},"createdAt":"2026-04-23T13:04:11.464Z"}],"sources":[{"listingId":"08cc4482-8b52-4187-83e3-932e83cd0309","source":"github","sourceId":"arvindand/agent-skills/github-navigator","sourceUrl":"https://github.com/arvindand/agent-skills/tree/main/skills/github-navigator","isPrimary":false,"firstSeenAt":"2026-04-23T13:04:11.464Z","lastSeenAt":"2026-04-24T07:03:31.091Z"}],"details":{"listingId":"08cc4482-8b52-4187-83e3-932e83cd0309","quickStartSnippet":null,"exampleRequest":null,"exampleResponse":null,"schema":null,"openapiUrl":null,"agentsTxtUrl":null,"citations":[],"useCases":[],"bestFor":[],"notFor":[],"kindDetails":{"org":"arvindand","slug":"github-navigator","github":{"repo":"arvindand/agent-skills","stars":11,"topics":["agent-skills","ai-agents","ai-tools","claude-code","developer-tools","github-copilot","llm","mcp","opencode","skills"],"license":"mit","html_url":"https://github.com/arvindand/agent-skills","pushed_at":"2026-04-05T21:55:12Z","description":"Reusable agent skills for Claude Code, GitHub Copilot, and other AI assistants. Dependency intelligence, GitHub ops, documentation lookup, UI/UX design patterns.","skill_md_sha":"403cbe3bbf5d3195162ac015f4483eaa8bd007a6","skill_md_path":"skills/github-navigator/SKILL.md","default_branch":"main","skill_tree_url":"https://github.com/arvindand/agent-skills/tree/main/skills/github-navigator"},"layout":"multi","source":"github","category":"agent-skills","frontmatter":{"name":"github-navigator","description":"GitHub operations via gh CLI. CRITICAL: Use instead of WebFetch for any `github.com` URL or GitHub repo path like `owner/repo`. Use when the user asks to inspect repositories, files, issues, pull requests, releases, Actions runs, or repository structure. Use when the user says 'show README', 'list issues', 'check PR', 'clone repo', or 'analyze this repo'.","compatibility":"Designed for Claude Code-compatible agents. Uses Claude-specific context forking and hooks; other Agent Skills products may ignore these extensions. allowed-tools is optional and may be handled differently across clients."},"skills_sh_url":"https://skills.sh/arvindand/agent-skills/github-navigator"},"updatedAt":"2026-04-24T07:03:31.091Z"}}