gstack-upgrade

Detect global or vendored gstack installs and execute upgrades with migrations and rollback.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Upgrading gstack to the latest version across all installations can be error-prone and time-consuming. This Skill automates detection of install type (global or vendored), runs the upgrade flow, applies migrations, and surfaces what's new, so you always operate on the most current toolchain with minimal manual steps.

Core Features & Use Cases

  • Detects install type (global or vendored) and chooses the correct upgrade path.
  • Executes the upgrade, runs migrations, and surfaces a concise "What’s New" summary.
  • Works across multiple deployment modes (global and per-project/local installs) and restores state if something goes wrong.

Quick Start

Run /gstack-upgrade to begin upgrading 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 multiple installations?

To upgrade gstack, run the upgrade command to automatically detect global or vendored installations, execute the appropriate upgrade pipeline, apply migrations, and display what's new.

What is the difference between global and vendored gstack installations when applying migrations?

Global gstack installations are upgraded system-wide, while vendored installations are upgraded per-project. The upgrade process detects the specific install type and runs the correct migration pipeline.

Can I roll back a gstack upgrade if the setup script or migrations fail?

Yes, the gstack upgrade process includes a rollback mechanism that safely restores your previous state if the setup script execution or migrations fail during the version update.

Do I need a specific Git or CLI environment to run gstack migrations and upgrades?

Yes, you need a functioning Git and CLI environment with access to gstack install directories to safely execute the setup script and apply version migrations.

What's the best way to automate gstack version management and view release notes?

Automating gstack version management involves running the automated upgrade pipeline which handles detection, migrations, and surfaces a concise summary of what's new for the user.

Why does my gstack upgrade not work when switching between deployment modes?

gstack upgrades may fail across deployment modes if the CLI environment lacks access to gstack install directories or cannot safely execute the setup script and migrations for that specific mode.