Github

GitHub CLI (gh)

When to Use This Skill

Use gh for GitHub repositories. To detect GitHub:

git remote -v | grep -i github.com

If the remote contains github.com, use this skill.

Before Any Operation

Always verify authentication first:

gh auth status

If not authenticated, guide the user to run gh auth login.

Behavioral Guidelines

1. Creating PRs: Always check for uncommitted changes first with git status
2. Viewing PRs/Issues: Use --comments flag when user wants full context
3. CI Operations: Check gh run list before triggering new workflows
4. Use --web: When the user might benefit from the browser UI
5. PR descriptions: Use HEREDOC for multi-line bodies to preserve formatting

Command Reference

Pull Requests

Action	Command
Create	gh pr create --title "Title" --body "Desc"
Create draft	gh pr create --draft --title "Title"
List	gh pr list
View	gh pr view <id>
View with comments	gh pr view <id> --comments
Checkout	gh pr checkout <id>
Diff	gh pr diff <id>
Merge	gh pr merge <id>
Approve	gh pr review <id> --approve

Issues

Action	Command
Create	gh issue create --title "Title" --body "Desc"
List	gh issue list
List mine	gh issue list --assignee=@me
View	gh issue view <id>
Close	gh issue close <id>
Comment	gh issue comment <id> --body "Comment"

Workflow Runs (CI/CD)

Action	Command
List runs	gh run list
View run	gh run view <id>
View logs	gh run view <id> --log
Watch live	gh run watch <id>
Rerun failed	gh run rerun <id> --failed

Repository

Action	Command
View info	gh repo view
Clone	gh repo clone <owner/repo>
Fork	gh repo fork
Open in browser	gh repo view --web

Advanced: API Calls

For operations not covered by CLI commands:

gh api repos/{owner}/{repo}/pulls/{id}/comments