stack-setuplisted
Install: claude install-skill XingLiu0923/pr-stack-skill
# Setting up `gh stack`
Work through only the steps the probe says are missing. Re-run the probe after
each one.
## 1. Confirm what is actually missing
```bash
bash "${CLAUDE_PLUGIN_ROOT}/scripts/check-status.sh"
```
## 2. `gh=NOT installed` — install the GitHub CLI
Ask the user which they prefer; do not pick silently.
```bash
brew install gh # macOS / Linuxbrew
winget install --id GitHub.cli # Windows
```
Anything else: point them at <https://github.com/cli/cli#installation>.
## 3. `auth=NOT authenticated` — log in
**The user runs this in their own terminal, not you.**
```bash
gh auth login
```
It is interactive: it opens a browser and prompts for a one-time code. Running
it from an agent session blocks forever.
### Token handling rules — no exceptions
* Never ask the user to paste a token into the chat.
* Never run `gh auth login --with-token` yourself.
* Never echo, log, store, or copy a token.
* Never read `~/.config/gh/hosts.yml` or `$GH_CONFIG_DIR`.
* `gh auth status` is the only supported check. It prints no secret.
If the user is on GitHub Enterprise, `gh auth login --hostname <host>`, and
`GH_HOST` selects it for later commands.
## 4. `ext=NOT installed` — install the extension
```bash
gh extension install github/gh-stack
```
This compiles from source and can take a minute or two. Later upgrades:
```bash
gh extension upgrade gh-stack
```
## 5. Configure git for stack work
Both of these prevent real failures, so set them unless t