AI agent skill · by @fcakyon

Setup

This skill should be used when the user asks "how to setup GitHub CLI", "configure gh", "gh auth not working", "GitHub CLI connection failed", "gh CLI error", or needs help with GitHub authentication.

Archived 2026-10-23 · Source updated 2026-09-18 · License: Apache-2.0. Check the original repository for the latest version.

SKILL.md instructions

# GitHub CLI Setup

Configure `gh` CLI for GitHub access.

## Check Current Status

```bash
gh auth status
```

Report one of these states:

- `gh` is not authenticated and needs login
- `gh` is authenticated, including the current username if available

## Login Flow

If authentication is missing or broken, guide the user through:

```bash
gh auth login
```

Select: GitHub.com -> HTTPS -> Login with browser

## Verify Authentication

```bash
gh auth status
gh api user --jq '.login'
```

## Troubleshooting

If `gh` commands fail:

1. **Check authentication** - `gh auth status`
2. **Re-login if needed** - `gh auth login`
3. **Check scopes** - Ensure the token has repo access
4. **Refresh auth** - `gh auth refresh`
5. **Update gh** - `brew upgrade gh` or equivalent