← ClaudeAtlas

stack-setuplisted

Use when the GitHub CLI or its gh-stack extension is missing or unauthenticated, when `gh stack` commands fail with an auth error, or when the user asks to install gh-stack, set up stacked PRs, or log in to GitHub. Triggered by check-status.sh reporting "gh=NOT installed", "ext=NOT installed", or "auth=NOT authenticated".
XingLiu0923/pr-stack-skill · ★ 2 · AI & Automation · score 70
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