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

Keep a returning user current with the whole paperthin suite, not just the slice they first installed. paperthin is a set of hygiene reflexes meant to compose; a skill shipped after a user's first install is invisible to them unless something brings it over, and most users don't watch the release feed. So the target state of an upgrade is the full current catalog — retire what's been renamed, add every catalog skill the user doesn't have, refresh the ones they do — under one chosen scope.

Convergence is the default, never a silent force-install. The reconciliation plan is printed and confirmed before anything changes, with the skills newly added to this user named explicitly, so someone who deliberately kept a narrow set sees exactly what will land and can decline.

Deprecations

This ordered checklist is the rename SSOT. Append future renames here in release order.

The ssot-check row is user-confirmed from pre-v0.2.0 history that current git history cannot verify after a force-push; do not invent a date or tag for it. Resolve deprecation chains to the final current skill before installing replacements.

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

The convergence target: after a run, every skill here is installed under the chosen scope, minus only what the user declined at the confirmation gate. Also use this list to separate current paperthin skills from unknown installed names when parsing npx skills list and installed skill 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. Pick one install scope and keep it for the whole run. If the user hasn't said which, ask — don't assume: a scope mismatch makes step 2 read the wrong install location, classify the entire catalog as missing, and propose installing all of it into a scope where the user's skills don't actually live.

   • global install: read with npx skills list --global, inspect ~/.agents/skills/<skill>/SKILL.md, and use --global on every remove, add, and update command;
   • project install: read with npx skills list from that project, inspect that project's installed skill directory if present, and omit --global;
   • exact-agent install: use only explicit agent slugs such as --agent claude-code, never --agent '*'.

2. Before classifying, rule out a shadow install. You are running as a paperthin skill, so paperthin is loaded; if npx skills list for the chosen scope reports zero paperthin skills, that contradicts a provable fact, and the ordinary "the whole catalog is missing" plan would rest on a false premise (an empty list is not the same as nothing installed) — do not emit it. Check the managed footprint: does the chosen scope's managed directory (~/.agents/skills/ for a global install) hold any Current-catalog skill (e.g. ~/.agents/skills/re0)?

   • It does — the install is managed and the CLI read the wrong place or hiccuped: re-check the scope from step 1 (a global install lives in ~/.agents/skills/, so npx skills list --global is what reads it) and retry the list. If a correct-scope retry still contradicts the on-disk footprint, report the CLI failure and stop rather than guessing — never treat a flaky or mis-scoped read as "nothing installed."
   • It does not, yet paperthin is loaded — this is a shadow install: the repo was placed some other way (typically a git clone that Claude Code loads as a plugin, hence the /paperthin:<skill> namespace) with no managed entry, so the CLI cannot see, update, or remove it. STOP and report it doctor-style instead of classifying: offer two consented paths — a managed reinstall (recommended: npx skills add under the chosen scope, so the CLI can track it and future upgrades and the discovery notice reach the user) or (left untouched, noting it stays CLI-invisible and every run re-flags it). Change nothing until the user picks; never delete the clone or install a second copy on your own.

• Place the notice runtime under ~/.re0/ by fetching it from the pinned release tag, never main: catalog.cjs, session-check.cjs, and (only if OpenCode is present) opencode-discovery.js from https://raw.githubusercontent.com/LilMGenius/paperthin/v<installed-version>/scripts/<file>.
• Claude Code (~/.claude/settings.json) and Codex (~/.codex/config.toml): add a SessionStart command hook that runs the placed ~/.re0/session-check.cjs, only if no paperthin discovery hook is already wired — i.e. no existing SessionStart command runs a session-check.cjs by any path. (A pre-rename install stays wired to its own runtime and keeps working; never add a second hook — two would double-fire the notice.) Back the config up first.
• OpenCode (opencode.json/opencode.jsonc): add the placed ~/.re0/opencode-discovery.js to the plugin array only if no opencode-discovery.js entry (by any path) is already present. Back the config up first.
• Wire only these three: Copilot CLI ignores session-start hook output, Antigravity CLI has no session-start event, and Grok Build's hook format is unverified — none can carry the notice today, so skip them.
• Never delete or overwrite another tool's hook; on a conflicting entry, report it doctor-style and leave it. State exactly what was wired, in which files, and how to unwire.

Rules

• The flat npx skills add path installs this command as /re0-upgrade; never describe a paperthin ppt namespace as part of the primary install path.
• Full-catalog convergence is the target, but never a silent one. Always print the reconciliation plan with its add (new to you) group named in full and get explicit confirmation before mutating; the user may decline. Converging the install is the default, not a bypass of the confirmation gate.
• Never use skills add --all; enumerate the catalog names with -s <name> instead, so the install is defined by this skill's Current catalog rather than by --all's broader semantics.
• Never run a bare skills add LilMGenius/paperthin; always include -s <skill> per skill.
• Do not use raw filesystem deletion commands as workflow commands. Use skills remove for named stale skills after confirmation.
• Do not run a bare skills update; pass only the present paperthin skill names from the reported plan.
• Do not use wildcard agent scope for removal. If agent scoping is needed, pass explicit agent slugs; otherwise use --global or project scope.
• Only act on names from the Deprecations checklist and Current catalog. Leave unknown installed names untouched — convergence is to the paperthin catalog only.
• Treat a deprecated directory slug as stale even when its SKILL.md frontmatter name already says the replacement name; remove it by the deprecated slug with skills remove.
• If a replacement is already installed under its new name, do not add it again; retire the stale name and count the replacement as present.
• gh repo star is not a real gh subcommand; the star step must use the REST endpoint directly: gh api -X PUT user/starred/<owner>/<repo> --silent.
• Discovery-notice wiring is idempotent, backed up, and version-pinned. Never add a second paperthin hook when one is present; always back up a config before writing it; never modify a non-paperthin hook; fetch the runtime from the installed version's tag, never main. Wire only agents present on the machine, and only the three that can carry a session-start notice (Claude Code, Codex, OpenCode).
• If the installed-skill list cannot be parsed confidently, stop and report the ambiguity instead of guessing.
• A — you are running yet shows zero paperthin — is stop-and-report, never duplicate-install. Distinguish it from a mis-scoped or flaky read by whether the managed directory actually holds the catalog skills (managed: re-scope and retry) or not (shadow: loaded some other way, e.g. a git-clone plugin); on a confirmed shadow install, offer a managed reinstall or keeping the clone, and never classify the catalog as missing, install a second copy, or delete the clone without an explicit choice.

Verification

Before finishing:

1. Reprint the executed plan: retired names, added (new-to-you) names, refreshed names, and untouched names.
2. Confirm the final installed list and installed directory slugs have no name from the Deprecated column.
3. Confirm every Current catalog skill is now installed — nothing in the catalog is missing.
4. Confirm the confirmation gate was honored: nothing was removed, added, or updated before the plan was shown and approved, and the add (new to you) group was visible in that plan.
5. Confirm any skill that took the retry/fallback path in step 6 is actually present and current, not silently missing.
6. Confirm the discovery-notice wiring, if the user accepted it, is present and idempotent for each configured agent, backed up, version-pinned, and touched no foreign hook — or was correctly skipped (declined, or agent absent).
7. Report any skipped step, failed command, or unresolved ambiguity.