Setup

Update Check (run first)

_UPD=$(~/.claude/skills/upstack/bin/upstack-update-check 2>/dev/null || .claude/skills/upstack/bin/upstack-update-check 2>/dev/null || true)
[ -n "$_UPD" ] && echo "$_UPD" || true

If output shows UPGRADE_AVAILABLE : read ~/.claude/skills/upstack/skills/upgrade/SKILL.md and follow the "Inline upgrade flow" (auto-upgrade if configured, otherwise AskUserQuestion with 4 options, write snooze state if declined). If JUST_UPGRADED : tell user "Running upstack v{to} (just updated!)" and continue.

Setup

Check Prerequisites

Run checks silently, then report a summary table:

| Tool | Check | Required By | | ------------- | ------------------------- | ------------------------------- | | git | git --version | all skills | | gh | gh --version | /ship-pr, /review, /advisor | | gh auth | gh auth status | /ship-pr, /review, /advisor | | agent-browser | agent-browser --version | /plan, /execute, /validate, /qa-review | | node | node --version | /validate (JS projects) | | python | python3 --version | /validate (Python projects) |

Report

Print table with status for each tool. Mark required tools vs optional.

Fix Missing Tools

If required tools are missing, AskUserQuestion: "Missing: [list]. Should I show install commands?"

Install commands (never run automatically). Detect OS for appropriate package manager:

gh (https://cli.github.com/):

• macOS: brew install gh then gh auth login
• Linux (apt): see https://github.com/cli/cli/blob/trunk/docs/install_linux.md
• Linux (dnf): sudo dnf install gh then gh auth login
• Windows: winget install --id GitHub.cli then gh auth login

agent-browser by Vercel (https://github.com/vercel-labs/agent-browser):

• macOS: brew install agent-browser then agent-browser install
• Other: npm install -g agent-browser then agent-browser install (requires Node.js)

Verify Skill Symlinks

List all skills in ~/.claude/skills/ that point to the upstack repo. Report any broken or missing symlinks. If symlinks are broken: suggest re-running install.sh.

Optional: Linear

If user mentions Linear: check for Linear MCP server configuration. Explain which skills benefit (plan, advisor, ship) and how to set it up.

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: Upsolve-Labs
• Source: Upsolve-Labs/upstack
• License: MIT
• Homepage: https://upsolve.ai/

Install and usage instructions live in the source repository linked above.