github-cli
GitHub CLI (gh) wrapper for PR status, issues, and repository operations
When & Why to Use This Skill
This Claude skill provides a comprehensive GitHub CLI (gh) wrapper, allowing developers to manage pull requests, issues, and repository operations through natural language. It optimizes software development lifecycles by integrating essential GitHub workflows directly into the AI environment, enhancing productivity and streamlining collaboration.
Use Cases
- Streamlining Pull Request Workflows: Check PR status, view CI/CD checks, and merge pull requests efficiently without switching contexts or leaving the terminal.
- Efficient Issue Management: List, view, and create GitHub issues to track bugs and feature requests directly from your conversation with the AI.
- Repository Monitoring and Insights: Quickly access repository information, metadata, and release lists to maintain oversight of project health and activity.
- CI/CD Status Tracking: Monitor the progress of automated tests and deployment checks to ensure code quality before finalizing merges.
- Advanced Repository Operations: Execute complex gh API calls and workflow commands to automate repetitive repository maintenance tasks.
| name | github-cli |
|---|---|
| description | GitHub CLI (gh) wrapper for PR status, issues, and repository operations |
| allowed-tools | Bash, Read, Glob |
| argument-hint | <action> [args] |
GitHub CLI helper skill for common gh operations. Requires gh CLI installed and authenticated.
Note: For creating/updating PR descriptions, use /mr-description-creator instead.
Actions
PR Operations
View PR status:
/github-cli pr status
View PR checks:
/github-cli pr checks
Merge PR:
/github-cli pr merge
View PR in browser:
/github-cli pr view --web
List PRs:
/github-cli pr list
Issue Operations
List issues:
/github-cli issue list
Create issue:
/github-cli issue create
View issue:
/github-cli issue view <number>
Repository Operations
View repo:
/github-cli repo view
Instructions
Step 1: Validate Environment
# Check gh is installed
gh --version
# Check gh is authenticated
gh auth status
If not installed, report: "Install gh CLI: https://cli.github.com" If not authenticated, report: "Run: gh auth login"
Step 2: Parse and Execute
Parse $ARGUMENTS and pass directly to gh:
gh $ARGUMENTS
Step 3: Report Result
Show gh output directly to user.
Examples
# View PR status
/github-cli pr status
# View PR checks (CI status)
/github-cli pr checks
# Merge current PR
/github-cli pr merge
# List open PRs
/github-cli pr list
# View PR in browser
/github-cli pr view --web
# List issues
/github-cli issue list
# Create issue interactively
/github-cli issue create
# View repo info
/github-cli repo view
# API calls
/github-cli api repos/{owner}/{repo}/pulls
# Any gh command works
/github-cli release list
/github-cli workflow list
Error Handling
| Scenario | Action |
|---|---|
| gh not installed | "Install gh: https://cli.github.com" |
| Not authenticated | "Run: gh auth login" |
| gh command fails | Show gh error output |