gh

name	gh
description	GitHub operations using gh CLI for any repository. Use when the user asks to "create pr", "create pull request", "view pr", "check ci", "pr status", "list prs", "create issue", "view issue", "search code", or any other GitHub-related operations. Handles PR creation with proper base branch detection, template support, and project conventions.
user-invocable	true
model	haiku
trigger	["pull request","create pr","create pull request","make pull request","make a pr","open pull request","open a pr","github pr","check ci","pr status","view pr","list prs","show prs","my prs","pr checks","create issue","github issue","view issue","list issues","search code","search repo","repository search"]

GitHub Operations

Manage GitHub workflows using the gh CLI.

When to Use This Skill

Use this skill when the user asks to:

• Create a pull request
• View PR details or status
• Check CI/CD pipeline status
• Manage issues
• Review PR comments
• Search repository code or issues

Commands

Create Pull Request

When creating a PR:

1. Verify current branch and changes:

   git branch --show-current
   git status
   

2. Check if branch is pushed:

   git log @{u}.. 2>/dev/null || echo "Branch not pushed"
   

3. Push if needed:

   git push -u origin $(git branch --show-current)
   

4. Detect parent branch (if base not specified):

   Find the parent branch from which the current branch was created:

   PARENT_BRANCH=$(git show-branch -a 2>/dev/null | grep '\*' | grep -v "$(git rev-parse --abbrev-ref HEAD)" | head -n1 | sed 's/.*\[\(.*\)\].*/\1/' | sed 's/[\^~].*//' | sed 's/remotes\/origin\///')
   
   # Fall back to common default branches if detection fails
   if [ -z "$PARENT_BRANCH" ]; then
     for branch in development develop main master; do
       if git show-ref --verify --quiet refs/remotes/origin/$branch; then
         PARENT_BRANCH=$branch
         break
       fi
     done
   fi
   

5. Create PR:

   Check if a PR template exists and use it, otherwise open in browser:

   if [ -f .github/PULL_REQUEST_TEMPLATE.md ]; then
     gh pr create --title "Brief title (under 70 chars)" --base "$PARENT_BRANCH" --template .github/PULL_REQUEST_TEMPLATE.md
   else
     gh pr create --title "Brief title (under 70 chars)" --base "$PARENT_BRANCH" --web
   fi
   

   Base branch logic:

• Auto-detect: Use the parent branch from which current branch was created
• Fallback: Use common default branches if detection fails
• Override: Use explicitly specified base branch if provided by user

Template handling:

• If .github/PULL_REQUEST_TEMPLATE.md exists: Use --template flag to fill it via CLI
• If no template: Use --web flag to open browser for manual description

6. Display PR URL to user

View Pull Request

# View specific PR
gh pr view 123

# View PR in browser
gh pr view 123 --web

# List open PRs
gh pr list

# List PRs by author
gh pr list --author @me

Check PR Status

# Check CI/CD status
gh pr checks 123

# View PR status
gh pr status

PR Comments

# View comments on PR
gh pr view 123 --comments

# Add comment to PR
gh pr comment 123 --body "Your comment here"

Issue Management

# Create issue
gh issue create --title "Issue title" --body "Issue description"

# View issue
gh issue view 456

# List open issues
gh issue list

# Search issues
gh issue list --search "keyword"

Code Search

# Search code in current repository
gh search code "search term"

# Search code in specific repository
gh search code --repo owner/repo "search term"

View Commits

# List recent commits on current branch
git log --oneline -10

# View specific commit
gh pr view <commit-sha>

PR Best Practices

Title Format

• Keep under 70 characters
• Use imperative mood: "Add feature" not "Added feature"
• Be specific but concise

Examples:

• ✅ "Optimize CLAUDE.md by removing general knowledge"
• ✅ "Fix memory leak in ChatController disposal"
• ✅ "Add snapshot tests for CallVisualizer UI"
• ❌ "Update files" (too vague)
• ❌ "This PR adds a new feature to handle user authentication and also fixes some bugs" (too long)

Description Format

• If the repository has a PR template at .github/PULL_REQUEST_TEMPLATE.md, use the --template flag
• If no template exists, use the --web flag to open browser for manual description
• Never create custom descriptions with --body - always use template or browser

Base Branch Selection

• Auto-detect: Automatically use the parent branch from which the current branch was created
• Fallback: Use common default branches (development, develop, main, or master) if parent branch detection fails
• Override: Use explicitly specified base branch if the user requests it (e.g., "create PR against master")

Error Handling

If gh is not authenticated:

Run: gh auth login
Follow browser-based OAuth flow

If gh is not installed:

macOS: brew install gh
Or download from: https://cli.github.com/

Important Notes

• Check for PR template first: Use --template if .github/PULL_REQUEST_TEMPLATE.md exists, otherwise use --web
• Never use --body parameter: Always use template or browser for PR descriptions
• Always verify branch is pushed before creating PR
• Check CI status before requesting review