zz-update

Updates all installed ZZ plugins by refreshing the marketplace and reporting version changes.

Updated Sep 11, 2026
One-click install
npx skills add https://github.com/zhixuan312/zz-stack --skill zz-update-zhixuan312
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: zz-update
Source: https://github.com/zhixuan312/zz-stack/tree/main/catalog/zz/zz-access/skills/zz-update
Command: npx skills add https://github.com/zhixuan312/zz-stack --skill zz-update-zhixuan312

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Updating Claude Code plugins manually is error-prone: refreshing the marketplace without updating plugins (or in the wrong order) silently leaves everything at the old version while reporting success. This Skill runs both steps in the correct order and prints each plugin's version before and after, so "nothing changed" is a real result rather than a silent tick. ## Core Features & Use Cases - Ordered two-step update: Refreshes the zz-stack marketplace shelf first, then updates every ZZ plugin actually installed on the machine, discovered dynamically rather than from a hardcoded list. - Rename migration: Detects plugins that were renamed on the shelf (e.g. zz to zz-core), installs the replacement, and only then removes the old one so a failure leaves a working machine. - Version verification and platform check: Prints before/after versions, flags mixed-version shelves, and confirms the platform still answers by calling session_whoami with the local token. - Use Case: A user types /zz-access:update after hearing a new release is out; the script updates everything installed and reports 0.28.0 -> 0.29.0+1e7d702a, then tells them to restart Claude Code. ## Quick Start Ask the assistant to run the zz-update skill to update all installed ZZ plugins and report the resulting versions.

Frequently Asked Questions about zz-update

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

FAQPage Schema
How do I update ZZ plugins in Claude Code?▼

Run the zz-update skill, which executes a single script that refreshes the zz-stack marketplace and then updates every installed ZZ plugin. It prints each plugin's version before and after so you can see exactly what moved.

Why does updating the marketplace alone not update my plugins?▼

Refreshing the marketplace only updates the shelf metadata; plugins are resolved against that copy, so updating a plugin before refreshing re-reads the old shelf and reports it as up to date. The script runs both steps in the fixed correct order.

Do I need to restart Claude Code after updating plugins?▼

Yes. If any plugin version changed, the new skills and MCP servers are on disk but the current session still runs the old ones. The script explicitly tells you to restart Claude Code, which is the one step it cannot do itself.

What happens if a ZZ plugin was renamed on the marketplace?▼

The script detects renamed plugins using a built-in alias map (for example `zz` to `zz-core`), installs the replacement first, and only then removes the old plugin. A failure during this leaves the original installation untouched.

Why do my plugins show different versions after an update?▼

All plugins from one build are stamped with the same `<version>+<digest>`, so mixed versions after a successful update indicate one plugin resolved against something else. The script exits with an error and directs you to run /zz-access:doctor.

What if no ZZ plugins are installed yet?▼

The script detects that nothing from the zz-stack marketplace is installed, says there is nothing to update, and prints the two commands to add the marketplace and install the zz-core baseline plugin.