/re0-upgrade

name: re0-upgrade
description: "Bring your installed paperthin skills up to the full current catalog in one step: retire what's been renamed, add every skill you don't have yet, and refresh the rest, all shown and confirmed before anything changes."
disable-model-invocation: true

Converge an install on the full current paperthin catalog in one step: retire renamed skills, add every skill not yet installed, refresh the rest, behind one confirmation.

Goal

Upgrade the chosen scope to the **full current catalog**, not just the originally installed subset. Show the reconciliation plan and name every new-to-user skill before confirmation; users who prefer a narrower install can decline.

Deprecations

The rename SSOT, in release order. Append future renames here; resolve chains to their final current names. The `ssot-check` row is user-confirmed pre-v0.2.0 history, unverifiable in git after a force-push; do not invent its date or tag.

| Deprecated | Renamed to | Since | | --- | --- | --- | | `ssot-check` | `ssotchk` | pre-v0.2.0 history (force-pushed; user-confirmed) | | `tasting` | `sip` | 0.6.0 | | `redteam` | `hate` | 0.7.0 | | `scratch` | `re0-work` | 0.8.2 | | `retro` | `re0-memo` | 0.11.0 | | `flywheel` | `re0-loop` | 0.11.0 | | `ssotchk` | `ssotize` | 0.11.0 | | `ppt-upgrade` | `re0-upgrade` | 0.11.0 | | `ppt-release` | `re0-release` | 0.11.0 |

Current catalog

Install every skill below in the chosen scope, except those declined at confirmation. Use this roster to distinguish current from unknown names in `npx skills list` and installed directories.

`re0`, `readchk`, `aim`, `modelchk`, `hate`, `macrothink`, `feynman`, `autobahn`, `reorder`, `detool`, `dedash`, `debloat`, `shower`, `factchk`, `mandela`, `sip`, `re0-git`, `re0-release`, `re0-merge`, `ssotize`, `re0-upgrade`, `re0-plan`, `re0-loop`, `re0-memo`, `re0-work`, `catchup`, `nba`, `prism`

Workflow

1. Choose one install scope for the whole run; ask if unspecified. A wrong scope reads the wrong install location.

• **Global**: `npx skills list --global`, inspect `~/.agents/skills/<skill>/SKILL.md`, and pass `--global` to every `remove`, `add`, and `update`.
• **Project**: `npx skills list` from that project, inspect its installed skill directory if present, and omit `--global`.
• **Exact agent**: use explicit slugs such as `--agent claude-code`, never `--agent '*'`, including removals. Without agent scoping, use global or project scope.

2. **Check for a shadow install before classifying.** If paperthin is loaded but the chosen scope's list reports zero paperthin skills, do not conclude the whole catalog is missing. Check for any Current-catalog directory in that scope's managed footprint (`~/.agents/skills/` globally, e.g. `~/.agents/skills/re0`).

• **Directory present**: re-check scope and retry the list (`npx skills list --global` globally). If it still contradicts the footprint, report the CLI failure and stop; a flaky read is not an empty install.
• **Directory absent, paperthin loaded**: report a **shadow install**, commonly a clone loaded as a Claude Code plugin (`/paperthin:<skill>`). The CLI cannot see, update, or remove it. Offer a managed reinstall via `npx skills add` in the chosen scope (recommended for future upgrades and discovery notices), or keep the clone untouched and CLI-invisible, with each upgrade re-flagging it. Await the user's choice; never delete the clone or install a second copy on your own.

Once managed, classify both installed names and directory slugs against Deprecations and Current catalog:

• **stale**: a deprecated name or slug;
• **missing**: a current name not installed, after resolving rename chains; an already-installed replacement counts as present, not missing, so retire only the stale name and do not add the replacement again;
• **present**: current, installed, non-deprecated names;
• **unknown**: neither current nor deprecated; leave untouched.

3. Print the reconciliation plan before changes: scope first (global / project / exact agent), then:

• **retire**: stale names;
• **add (new to you)**: missing catalog names in full, including replacements for retired names;
• **refresh**: present names;
• **untouched**: unknown names;
• **wire discovery notice**: present agents to wire in step 9, or `none` if declined.

4. Get explicit confirmation before removal, installation, update, or hook wiring. Recommend full-catalog convergence and discovery wiring; the user may approve the plan, decline the whole run, or decline only wiring. Nothing mutates before approval. 5. After confirmation, run only the commands the plan named, with the scope flags chosen in step 1:

• `npx skills remove <scope-flags> <stale...> --yes` for the retire group;
• `npx skills add LilMGenius/paperthin <scope-flags> -s <missing...> --yes` for the add group, enumerating each catalog name with its own `-s`;
• `npx skills update <scope-flags> <present...> --yes` for the refresh group.

6. If `npx skills add` or `npx skills update` reports a failed skill, retry that skill alone with the same scope flags. If it fails again, obtain confirmation by skill name, then remove and reinstall it using the same `skills remove`/`skills add -s` forms. 7. Verify with `npx skills list`: no deprecated name remains, every Current catalog skill is now installed, unknown names were left untouched, and any skill that took the retry/fallback path is actually present. 8. Explain how to pick up the update: Claude Code applies changed `SKILL.md` content automatically in this session; run `/reload-skills` in any other running Claude Code session sharing the install. Codex has no in-session reload: restart it (or `codex resume`). For other agents, restart if the new behavior does not appear. 9. After successful upgrade verification, wire the session-start discovery notice for present agents unless declined. Back up each config before editing.

• Fetch `catalog.cjs` and `sessi