gh

1# GitHub CLI (gh) Skill
2 
3Interact with GitHub using the gh command line tool.
4 
5Run commands with Bub's `bash` tool, setting `cwd` to the target checkout when using local repository context. If it returns a running shell ID, collect the result with `bash.output` before retrying the command.
6 
7## Prerequisites
8 
9Use the authentication source specified by the user or workspace. For github.com, `GH_TOKEN` takes precedence over `GITHUB_TOKEN`, and both override stored `gh` credentials.
10 
11Check authentication:
12```bash
13gh auth status
14```
15 
16If not authenticated, report the blocker; do not silently switch credentials. Run interactive login only when the user requests authentication setup:
17```bash
18gh auth login
19```
20 
21## Repository Operations
22 
23```bash
24gh repo create <name> [--public|--private]
25gh repo clone <owner/repo>
26gh repo fork <owner/repo>
27gh repo view [owner/repo]
28gh repo list [owner]
29```
30 
31## Issue Operations
32 
33```bash
34gh issue create --title "Title" --body "Body"
35gh issue list [--state open|closed]
36gh issue view <number>
37gh issue close <number>
38gh issue comment <number> --body "Comment"
39```
40 
41## Pull Request Operations
42 
43```bash
44gh pr create --title "Title" --body "Body"
45gh pr list [--state open|closed]
46gh pr view <number>
47gh pr checkout <number>
48gh pr merge <number>
49gh pr review <number> --approve
50```
51 
52## Release Operations
53 
54```bash
55gh release create <tag> --generate-notes
56gh release list
57gh release download <tag>
58gh release upload <tag> <file>
59```
60 
61## Workflow Operations
62 
63```bash
64…