GitHub CLI Expert

This skill provides comprehensive guidance for interacting with GitHub from the command line, covering both standard Git commands and the enhanced capabilities of the official GitHub CLI (gh).

Core Principle

"Efficient GitHub interaction from your terminal, reducing context switching and streamlining development workflows."

When to Use This Skill

Use this skill when you need to:

• Perform any operation related to GitHub repositories (cloning, pushing, pulling).
• Manage Git branches and their remote counterparts.
• Create, review, or merge Pull Requests.
• Create, list, or manage Issues.
• Automate any GitHub-related tasks.
• Get instructions on using the gh CLI tool.

Key Concepts

• Git Commands: Fundamental version control operations that interact with any Git repository, including those hosted on GitHub.
• GitHub CLI (gh): An official command-line tool that extends Git's functionality with GitHub-specific features, making common tasks faster and more integrated.

Workflows & Commands

This skill guides you through common GitHub workflows. Refer to the bundled reference files for detailed command examples.

1. Git Workflows for GitHub

For standard Git operations when working with GitHub, including:

• Cloning repositories.
• Basic commit workflow (status, add, commit).
• Pushing and pulling changes to/from GitHub.
• Branch management (create, switch, list, delete).
• Merging branches and handling conflicts.

Reference: See GIT-WORKFLOWS.md for detailed commands and examples.

2. GitHub CLI (gh) Commands

For streamlined GitHub-specific operations using the gh tool, including:

• Authentication with GitHub.
• Repository management (create, clone, view).
• Pull Request management (create, list, view, checkout, review, merge).
• Issue management (create, list, view, close).

Prerequisite: The gh CLI tool must be installed on your system for these commands to work. You can usually install it via your system's package manager (e.g., brew install gh on macOS, sudo apt install gh on Debian/Ubuntu).

Reference: See GH-CLI-COMMANDS.md for detailed commands and examples.

Power Move

"Combine gh CLI with Git aliases and shell scripting to automate complex GitHub workflows, such as automatically creating a feature branch, pushing it, opening a draft PR, and linking it to an issue, all with one custom command."

Troubleshooting

• "git" command not found: Ensure Git is installed and in your system's PATH.
• "gh" command not found: Ensure GitHub CLI is installed.
• Authentication issues: Run gh auth login or check your Git credentials.
• Permissions errors: Verify your GitHub token/SSH key has the necessary permissions for the operation.