working-github-cli

Use when working with GitHub repositories, pull requests, issues, releases, or other GitHub operations via the gh CLI

⭐0stars🔀0forks📁View on GitHub🕐Updated Jan 5, 2026⬇️1downloads

When & Why to Use This Skill

This Claude skill empowers developers to seamlessly manage GitHub workflows using the GitHub CLI (gh). It streamlines essential version control tasks including repository management, pull request orchestration, issue tracking, and release coordination, allowing for a more efficient and integrated development environment.

Use Cases

  • Pull Request Lifecycle Management: Effortlessly create, review, and merge pull requests using natural language commands, with support for complex multiline descriptions.
  • Issue Tracking and Documentation: Quickly list, view, and update project issues to maintain clear communication and project momentum.
  • Repository and Release Operations: Manage repository settings, clone projects, and automate the creation of software releases directly through the CLI interface.
  • Authentication Troubleshooting: Diagnose and resolve GitHub access issues or switch between multiple user accounts using built-in authentication status checks.
nameworking-github-cli
descriptionUse when working with GitHub repositories, pull requests, issues, releases, or other GitHub operations via the gh CLI

Working with GitHub CLI

Use the gh CLI tool via the Bash tool for all GitHub operations.

Authentication & Account Issues

IMPORTANT: If you encounter "repository not found" or authentication errors:

  1. Check authentication status:

    gh auth status
    
  2. If multiple accounts are configured, try switching accounts:

    gh auth switch
    
  3. If not authenticated, prompt user to run:

    gh auth login
    

Commands & Usage

See @common-commands.md for detailed command reference, examples, and common operations.

Best Practices

  • Use gh commands instead of git+web workflows when possible
  • Always check gh <command> --help for options
  • Use --json flag for machine-readable output when parsing
  • Use heredoc for multiline bodies (PR descriptions, issue bodies)