Handles GSD tool updates, sync, and re-application of local patches.

Install

mkdir -p .claude/skills/gsd-update && curl -L -o skill.zip "https://agentskills.codes/api/skills/download/10746" && unzip -o skill.zip -d .claude/skills/gsd-update && rm skill.zip

Installs to .claude/skills/gsd-update

Activation

This is the description your AI agent reads to decide when to run this skill — the better it matches your request, the more reliably it fires.

Update GSD to latest version with changelog display
51 charsno explicit “when” trigger
Beginner

Key capabilities

  • Check for available GSD updates
  • Install the latest GSD version
  • Display changelog information for updates
  • Synchronize managed GSD skills across runtimes
  • Reapply local modifications after an update
  • Target release candidate versions for installation

How it works

The skill routes to an update workflow that detects versions, checks npm, fetches changelogs, and executes updates, optionally handling skill synchronization or patch reapplication.

Inputs & outputs

You give it
Optional flags like --sync, --reapply, --next, or --rc
You get back
Updated GSD installation, changelog display, or synchronized skills

When to use gsd-update

  • Updating GSD version
  • Syncing skills across runtimes
  • Checking tool changelogs

About this skill

<objective> Check for GSD updates, install if available, and display what changed.

Routes to the update workflow which handles:

  • Version detection (local vs global installation)
  • npm version checking
  • Changelog fetching and display
  • User confirmation with clean install warning
  • Update execution and cache clearing
  • Restart reminder </objective>

<execution_context> @~/.copilot/gsd-core/workflows/update.md </execution_context>

<flags> - **--sync**: Sync managed GSD skills across runtime roots so multi-runtime users stay aligned after an update. Runs the sync-skills workflow (--from, --to, --dry-run, --apply flags supported). - **--reapply**: Reapply local modifications after a GSD update. Uses three-way comparison (pristine baseline, user-modified backup, newly installed version) to merge user customizations back. Runs the reapply-patches workflow. - **--next** (alias **--rc**): Target the `@next` RC dist-tag instead of `@latest` so you can install or refresh a release candidate (e.g. `1.4.0-rc.1`) through the normal update flow — scope/runtime detection, changelog preview, custom-file backup, and cache clearing all still apply. Omitting it keeps targeting `@latest` (no change). See ADR #660 for the RC channel. - **(no flag)**: Standard update — check for new version, show changelog, install. </flags> <process> Parse the first token of $ARGUMENTS: - If it is `--sync`: strip the flag, execute the sync-skills workflow (passing remaining args for --from/--to/--dry-run/--apply). - If it is `--reapply`: strip the flag, execute the reapply-patches workflow. - Otherwise (including `--next` / `--rc`): execute the update workflow end-to-end, passing `$ARGUMENTS` through so the workflow's parse_update_channel step can select the release channel. </process>

<execution_context_extended> @/.copilot/gsd-core/workflows/sync-skills.md @/.copilot/gsd-core/workflows/reapply-patches.md </execution_context_extended>

When not to use it

  • When only checking for updates without installation
  • When not managing GSD skills or local modifications

Limitations

  • Requires user confirmation for clean install warnings
  • Syncs skills across runtimes only if specified
  • Reapplies local modifications only if specified

How it compares

This skill automates the entire GSD update process, including changelog display and post-update tasks, which differs from manually checking for and installing updates.

Compared to similar skills

gsd-update side by side with the closest alternatives in the catalog.

SkillInstallsUpdatedSafetyDifficulty
gsd-update (this skill)02moNo flagsBeginner
setup121moNo flagsBeginner
tmux202moReviewIntermediate
macos-cleaner162moReviewBeginner

Try saying

Example prompts that trigger this skill in your AI assistant.

Search skills

Search the agent skills registry