gstack-upgrade

Upgrade gstack across global, local vendored, and vendored-global installs.

12|6|Updated Dec 2, 2025
One-click install
npx skills add https://github.com/shogo-labs/shogo-ai --skill gstack-upgrade-shogo-labs
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: gstack-upgrade
Source: https://github.com/shogo-labs/shogo-ai/tree/main/packages/agent-runtime/templates/virtual-engineering-team/.shogo/skills/gstack-gstack-upgrade
Command: npx skills add https://github.com/shogo-labs/shogo-ai --skill gstack-upgrade-shogo-labs

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Upgrading gstack across multiple installation modes can be error-prone without consistent tooling. This Skill automates detection of global, local vendored, and vendored-global installs, performs upgrades, and applies migrations to keep your environment up-to-date.

Core Features & Use Cases

  • Detects install type (global vs local, git-based vs vendored) and performs the appropriate upgrade path.
  • Runs version migrations after setup to fix state and layout changes.
  • Shows a concise "What's New" summary to help users understand changes before continuing.

Quick Start

Run the /gstack-upgrade command to check for upgrades and perform the upgrade when available.

Frequently Asked Questions about gstack-upgrade

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I upgrade gstack across different installation modes safely?▼

To upgrade gstack safely, the tool detects your installation type across global, local vendored, and vendored-global modes, then performs the appropriate upgrade path and applies migrations automatically.

What is the best way to automate gstack version migrations after an upgrade?▼

Automated gstack migrations are handled by running the upgrade command, which detects your install type, applies state and layout migrations, and ensures your environment remains up-to-date without manual intervention.

Does gstack-upgrade work with vendored-global and local vendored installs?▼

Yes, gstack-upgrade supports vendored-global and local vendored installations by detecting the install type and executing the correct upgrade path along with vendored-sync handling.

How do I see what changes are included in a gstack upgrade before continuing?▼

After performing an upgrade, gstack-upgrade presents a concise What's New summary that helps you understand version changes and state migrations before you continue working.

Can I rollback a gstack upgrade if the migrations fail?▼

gstack-upgrade includes team-mode safeguards and rollback-friendly upgrade logic to ensure reliable migrations, allowing you to safely manage version updates across your installations.

When do I need to run a gstack upgrade with automated migrations?▼

You need to run a gstack upgrade when your environment falls behind the latest version, requiring state and layout migrations to fix inconsistencies across global or vendored installations.