gstack-upgrade

Detect gstack install type and apply latest changes across global, local, and vendored installations.

Updated Mar 31, 2026
One-click install
npx skills add https://github.com/huichen/gstack --skill gstack-upgrade-huichen
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gstack-upgrade
Source: https://github.com/huichen/gstack/tree/main/gstack-upgrade
Command: npx skills add https://github.com/huichen/gstack --skill gstack-upgrade-huichen

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Upgrading gstack across different installation modes would be error-prone and time-consuming without a unified workflow. This skill automates detection of global, local, or vendored installs, orchestrates the upgrade, and surfaces a concise "what's new" summary.

Core Features & Use Cases

  • Detects install type (global-git, local-git, vendored, vendored-global) and applies the appropriate upgrade path.
  • Auto-upgrade support with prompts, snooze options, and safe fallbacks if upgrades fail.
  • Syncs local vendored copies to keep all deployments up to date and consistent.
  • Reads CHANGELOG.md to summarize user-facing changes for quick review.
  • Works when users ask to upgrade, update, or get the latest version, in both interactive and standalone modes.

Quick Start

Run /gstack-upgrade to upgrade to the latest version of gstack.

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 to the latest version across different installation types?

To upgrade gstack, the skill detects whether you have a global, local, or vendored installation and applies the appropriate update path automatically. It reads the CHANGELOG to summarize new features and preserves local customizations during the sync.

How does a vendored gstack upgrade work without losing local changes?

A vendored gstack upgrade syncs your local copies carefully to keep deployments consistent without overwriting local changes. It applies the latest changes while reading the CHANGELOG to highlight new features and using safe fallbacks if the sync fails.

Can I automate gstack updates with prompts and fallback restoration?

Yes, you can automate gstack updates using auto-upgrade support with interactive prompts and snooze options. If an upgrade fails, the skill automatically triggers a safe fallback restoration to revert to the previous stable state.

What is the best way to see what changed in a new gstack version after updating?

The best way to see what changed after updating is reading the CHANGELOG.md, which the skill automatically parses to surface a concise summary of user-facing changes and new features for quick review.

Does the gstack upgrade skill work in standalone mode without user interaction?

Yes, the upgrade skill works in both interactive and standalone modes. In standalone mode, it handles auto-upgrade and applies the latest changes directly without requiring user prompts or manual intervention.

Why did my gstack upgrade fail and how do I restore the previous version?

A gstack upgrade may fail due to sync conflicts across install types. The skill provides safe fallback restoration automatically, reverting your global, local, or vendored installations to the previous working state if the update encounters errors.