gstack-upgrade

Upgrade gstack installations and summarize user-facing changelog changes.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Keeps a user's gstack installation up to date across different install types and environments without manual git or file-copy work, preventing drift between global and vendored copies and reducing upgrade friction and mistakes.

Core Features & Use Cases

  • Install detection: Automatically detects global git installs, local git installs, vendored installs, and home-directory vendored installs and selects the correct upgrade path.
  • Safe upgrade flow: Creates backups, handles git stashing/resets or vendored replacement, runs setup, and restores on failure to avoid leaving the environment broken.
  • Vendored sync: Optionally synchronizes a local repository's vendored copy from the primary install so repo-embedded skills stay consistent with the global version.
  • User-facing changelog summary: Reads CHANGELOG.md and summarizes user-facing changes between versions to highlight important upgrades.
  • Auto-upgrade and snooze controls: Supports automatic upgrades, persistent snooze levels, and opt-out preferences to match developer workflows.

Quick Start

Run /gstack-upgrade to detect your installation, perform a safe upgrade with backups, and show a concise What's New summary.

Frequently Asked Questions about gstack-upgrade

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

FAQPage Schema
How do I safely upgrade a vendored gstack installation?

To safely upgrade a vendored gstack installation, the skill detects the install type, creates a backup of existing files, replaces the vendored copy, runs setup, and restores the backup automatically if the upgrade fails.

What is the best way to sync local vendored gstack copies with a global git install?

The best way to sync local vendored gstack copies is using the vendored sync feature, which synchronizes a local repository's embedded skills from the primary global installation to ensure version consistency across environments.

Can I automate gstack upgrades and snooze future update notifications?

Yes, you can automate gstack upgrades and snooze update notifications. The skill supports automatic upgrades, persistent snooze levels, and opt-out preferences to match your specific developer workflow.

How does this tool handle backup and rollback when a gstack upgrade fails?

The tool handles backup and rollback by creating a backup before running git stash, resets, or vendored replacement steps, and automatically restoring the original install state if the upgrade process fails.

Does the gstack upgrade process show a changelog summary of user-facing changes?

Yes, the gstack upgrade process shows a changelog summary. It reads CHANGELOG.md entries to present a concise summary of user-facing changes between your previous version and the latest release.

When do I need to upgrade gstack across different developer environments and CI agents?

You need to upgrade gstack across developer environments and CI agents when maintaining global git installs, vendored installs, or local repository vendored copies to prevent version drift and reduce manual file-copy work.