Check GitHub CLI Availability
Use this skill whenever a workflow or command requires the GitHub CLI (gh). Before running any gh commands:
- Check installation and auth: Run
gh auth status. If it reports "not logged in" or the command is not found:- If
ghis not installed: Ask the user to install it (e.g.brew install ghon macOS, or see GitHub CLI) and then authenticate. - If
ghis installed but not configured: Ask the user to configure it themselves. Provide these instructions to help them:- Run
gh auth loginand follow the prompts (choose HTTPS or SSH, authenticate via browser or token). - Ensure the account has the permissions needed for the operation (e.g. read access to the repository, or read/write if the task requires it).
- Run
- Do not attempt to authenticate on the user's behalf; only guide them with the commands and link to GitHub CLI authentication docs.
- If
- If
gh auth statussucceeds: Proceed with the steps that requiregh.
Other skills that depend on gh (e.g. create-pr) should instruct the agent to ensure GitHub CLI is ready first by following this skill.