GitHub CLI (gh) Skill

Interact with GitHub using the gh command line tool.

Run 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.

Prerequisites

Use 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.

Check authentication:

gh auth status

If not authenticated, report the blocker; do not silently switch credentials. Run interactive login only when the user requests authentication setup:

gh auth login

Repository Operations

gh repo create <name> [--public|--private]
gh repo clone <owner/repo>
gh repo fork <owner/repo>
gh repo view [owner/repo]
gh repo list [owner]

Issue Operations

gh issue create --title "Title" --body "Body"
gh issue list [--state open|closed]
gh issue view <number>
gh issue close <number>
gh issue comment <number> --body "Comment"

Pull Request Operations

gh pr create --title "Title" --body "Body"
gh pr list [--state open|closed]
gh pr view <number>
gh pr checkout <number>
gh pr merge <number>
gh pr review <number> --approve

Release Operations

gh release create <tag> --generate-notes
gh release list
gh release download <tag>
gh release upload <tag> <file>

Workflow Operations

gh workflow list
gh workflow run <name>
gh run list
gh run view <run-id>
gh run watch <run-id>

Gist Operations

gh gist create <file>
gh gist list
gh gist view <id>

Skill Operations

gh skill search <query>
gh skill preview <owner/repo> <skill>
gh skill install <owner/repo> <skill> --dir .agents/skills
gh skill list --dir .agents/skills
gh skill update <skill> --dir .agents/skills --dry-run
gh skill update <skill> --dir .agents/skills --all