working-github-cli
Use when working with GitHub repositories, pull requests, issues, releases, or other GitHub operations via the gh CLI
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.
| name | working-github-cli |
|---|---|
| description | Use 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:
Check authentication status:
gh auth statusIf multiple accounts are configured, try switching accounts:
gh auth switchIf 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
ghcommands instead of git+web workflows when possible - Always check
gh <command> --helpfor options - Use
--jsonflag for machine-readable output when parsing - Use heredoc for multiline bodies (PR descriptions, issue bodies)