- name
SKILL.md
技能文件保留在发布者的仓库中。
在终端中粘贴复制的命令。它会把这个 SKILL.md 安装到对应的智能体中。
npx skills add LilMGenius/paperthin --skill re0-upgrade -a cursor -y在终端中粘贴复制的命令。它会把这个 SKILL.md 安装到对应的智能体中。
npx skills add LilMGenius/paperthin --skill re0-upgrade -a claude-code -y在终端中粘贴复制的命令。它会把这个 SKILL.md 安装到对应的智能体中。
npx skills add LilMGenius/paperthin --skill re0-upgrade -a codex -y在终端中粘贴复制的命令。它会把这个 SKILL.md 安装到对应的智能体中。
npx skills add LilMGenius/paperthin --skill re0-upgrade -a grok -y在 Grok Bot 聊天中发送复制的消息。Bot 会从 GitHub 获取这个 SKILL.md,并添加到你所有 Bot 共享的技能中。
Install this skill: https://github.com/LilMGenius/paperthin/tree/HEAD/skills/breadth/re0-upgrade来自发布者
Keep one paperthin install per agent, current and loaded once, after you see and confirm the plan.
Each agent runs paperthin from one route that stays current without the user remembering. Claude Code and Codex take the plugin route, which each host's own marketplace update keeps current; OpenCode and every other agent take the skills.sh route, which a daily per-user job keeps current. This skill does the part neither updater does: it moves an old skills.sh install onto the plugin route without leaving every skill loaded twice, removes the session-start notice older releases wired into agent configs, installs or checks the daily job where skills.sh stays, and brings a skills.sh install to the full current catalog, retiring renamed skills and adding the ones the user never installed. An integrity gate protects any locally edited copy before anything replaces or removes it.
It is user-invoked on purpose: it removes skill installs, edits agent configs and registers a scheduled job, so it runs only when the human asks.
This section owns every rename and retirement, in release order; a future one appends its row here. A rename chain resolves to its final current name. A skill removed with no replacement carries retired (no backticks around the word in the table) in the Renamed-to column. The ssot-check row is user-confirmed history from before v0.2.0 that git cannot verify after a force-push; never invent its date or tag.
Install every skill listed here in the chosen scope, except any the user declines at confirmation. This roster is also how the list output and the installed directories tell current names from unknown ones.
re0, debloat, re0-order, detool, re0-style, dedash, dedot, readback, aim, modelchk, elon, scopechk, hate, macrothink, crossthink, re0-decide, whychk, autobahn, sip, shower, factchk, mandela, demock, deid, re0-git, re0-release, re0-merge, re0-squash, ssotize, ssotize-local, re0-readme, re0-import, re0-upgrade, paperthin, re0-workflow, re0-memo, backprop, re0-work, catchup, nba, re0-plan, re0-loop, re0-watch, re0-tutorial, multithink
Run every script from this skill's folder. Each one reads and reports, or makes only the one change its verb names; none decides anything a person must.
Find each agent's route. Ask which agents the user runs if it is not clear, then name the route each one loads paperthin from:
/plugin, Codex /plugins), or its plugin cache holds it (~/.claude/plugins/cache/<marketplace>/paperthin/, ~/.codex/plugins/cache/<marketplace>/paperthin/).npx skills@latest list --global lists paperthin names, or npx skills@latest list does from a project; the canonical copies sit in ~/.agents/skills/ (global) or the project's .agents/skills/.~/.agents/skills itself beside its plugins, so a Codex plugin install plus any global skills.sh copy is both, whichever agent the skills.sh copy was added for.Find the old notice wiring. Run node scripts/upgrade.mjs wiring (--home <dir> reads another home). It reads Claude Code's settings.json, Codex's config.toml and hooks.json, OpenCode's opencode.json and opencode.jsonc (under XDG_CONFIG_HOME when set), and ~/.re0/, and prints JSON naming each file and line that runs session-check.cjs or loads opencode-discovery.js, plus the ~/.re0/ runtime copy. Exit 0 means none, 1 means some was found, 2 a usage error. Nothing else in those files is reported or touched.
Classify a skills.sh install that stays. Pick its scope, global or one project, and carry that scope's flags, written <scope-flags> below (--global or nothing; for one agent, explicit slugs such as --agent claude-code, never --agent '*', from the CLI's supported agents table). Run node scripts/upgrade.mjs classify --skill-md SKILL.md --installed <dir-or-file>, with --installed the scope's skills directory (its folder slugs are read, whatever their frontmatter names) or a text file holding one name per line from the scoped list. Input: this file's Deprecations table and Current catalog, the one source of both. Output: JSON with four groups. stale lists each deprecated name or slug with the final current name its rename chain resolves to (null for a retired name) and whether that replacement is installed; lists current names not installed; lists current names installed; lists names in neither section, left untouched. An installed replacement is present, so only its stale name is retired and the replacement is not added again. Exit 0 means nothing is stale or missing, 1 means something is, 2 means a usage error or a table it cannot read confidently (a malformed row, a rename loop, a chain ending outside the catalog, a line holding more than one name); on 2, stop and report the ambiguity. If the scope's list shows no paperthin skill while a catalog folder sits in its directory, retry once, then report the CLI failure and stop; a flaky read is not an empty install.
SKILL.md frontmatter name already says the replacement; remove it by the deprecated slug with skills remove.skills remove after confirmation. The one raw deletion is ~/.re0/, and only when it holds nothing but the files older releases wrote there.skills add --all or a bare skills add LilMGenius/paperthin. Give each name its own -s, so the Current catalog defines the install rather than the broader meaning of --all.skills update from this skill; pass only the present paperthin names from the plan. The daily job's global update is the job's own, set at install.schedule.mjs uninstall removes it and nothing else.gh repo star is not a real gh subcommand; star only through the consent-gated REST command in step 15.With nothing to move, remove, add or install, the plan shows only the refresh and untouched groups and the run still verifies. A declined run changes nothing. Before reporting, confirm:
node scripts/upgrade.mjs wiring exits 0, or each remaining hit is reported with its reason, and every edited config has its .pre-re0-unwire.bak beside it.node scripts/schedule/schedule.mjs status shows the job registered with its next run at local 00:00 where a global skills.sh install stays, and exits 1 where none stays.Keep one paperthin install current and loaded once: move an old skills.sh install onto the Claude Code or Codex plugin, clear the session-start notice older releases wired, set up the daily update job
---name: re0-upgradedescription: Keep one paperthin install current and loaded once: move an old skills.sh install onto the Claude Code or…---# skills/breadth/re0-upgrade/SKILL.md概览
Keep one paperthin install current and loaded once: move an old skills.sh install onto the Claude Code or Codex plugin, clear the session-start notice older releases wired, set up the daily update job where skills.sh stays, and bring that install to the full current catalog, all shown and confirmed first.
常见问题
从发布者处下载 skills/breadth/re0-upgrade/SKILL.md,或复制路径后打开仓库。PlugMCP 只收录该技能,不托管文件。
发布者将它存放在 https://github.com/LilMGenius/paperthin。
Claude、Cursor、Codex 和 Grok Build 可以读取你从发布者仓库添加的 SKILL.md。在聊天中发送技能的 GitHub 文件夹链接,Grok Bot 就会安装它。
missingpresentunknownCheck the daily job where a global skills.sh install stays: node scripts/schedule/schedule.mjs status. It prints JSON with whether the OS scheduler holds the job, its next run, the log path and the last run's start, end and exit code, and exits 0 when the job is registered, 1 when it is not. The job covers the global scope only; a project-scope install is kept current by running this skill.
Print the plan before any change, per agent and in this order: its route now and after; move to plugin (the skills.sh names to remove, and whether the whole install goes or only some agents' links); remove old wiring (each file and line from step 2, and ~/.re0/); refresh the skills.sh install that stays (retire the stale names; add (new to you), every missing name in full, replacements for retired names included; refresh the present names; untouched, the unknown names); daily job (install, keep, or uninstall when no skills.sh install stays); execution order as the steps below run it.
Confirm. Get explicit confirmation before any removal, install, update, config edit or job change. Recommend one route per agent, the full catalog and the daily job. The user decides: approve, decline the whole run, decline individual catalog skills (which then stay out of the add group), or decline any one change. Nothing mutates before approval.
Move onto the plugin route, where approved:
/paperthin:<skill>); invoke one skill explicitly on an input its Workflow handles and confirm it runs to its own Verification. Until that holds, keep the skills.sh copies and report the move pending, with the resume step: reload, verify, remove.node scripts/schedule/schedule.mjs uninstall, which removes the job and nothing else), then remove every installed catalog and stale name: npx skills@latest remove --global <names...> --yes. If another agent still loads paperthin through skills.sh, remove only the moved agents' links (npx skills@latest remove --global --agent <slug...> <names...> --yes) and keep the job; Codex reads the canonical directory itself, so a Codex moved while another agent keeps the global skills.sh install still loads twice. Say so and let the user choose which agent gives way.Remove the old wiring, where approved. Back up each config beside itself (<file>.pre-re0-unwire.bak) before editing it, then remove the entry holding each hit and nothing beside it: in Claude Code's settings.json the hook object whose command runs session-check.cjs, and its SessionStart group if that leaves it empty; in Codex's config.toml the [[hooks.SessionStart]] table and its [[hooks.SessionStart.hooks]] lines whose command runs session-check.cjs (in hooks.json, the same object as Claude Code's); in OpenCode's config the plugin array element naming opencode-discovery.js. Remove ~/.re0/ only when it holds nothing but what older releases wrote there (catalog.cjs, session-check.cjs, opencode-discovery.js, last-notice.json); otherwise report what else it holds and leave it. Never edit another tool's hook. Rerun step 2; it must exit 0.
Refresh the skills.sh install that stays, with step 3's scope flags and only the commands the plan named:
npx skills@latest add LilMGenius/paperthin <scope-flags> -s <missing...> --yes, each catalog name with its own -s.npx skills@latest update <scope-flags> <present...> --yes.SKILL.md with the right frontmatter name and Goal, Workflow, Rules and Verification sections; no add or update failure remains for it. Reload as in step 14, observe the host resolve the new name, then invoke the replacement explicitly on one input its Workflow handles and confirm it runs to its own Verification. Availability plus that run close "new works"; files on disk alone do not. If a reload or fresh session is unavailable, report the migration pending and keep the stale name, recording in the handoff the scope, the stale and replacement pair, and the resume step. A retired name has no replacement, so it has no such step.npx skills@latest remove <scope-flags> <stale...> --yes.Install the daily job where a global skills.sh install stays and step 4 found none: node scripts/schedule/schedule.mjs install, then status again, which must show the job registered with its next run at the coming local 00:00. The job runs as the user, unelevated and without a window: Task Scheduler on Windows, a launchd LaunchAgent on macOS, a systemd user timer on Linux, or a crontab line where systemd is absent. Each run updates every global skill (npx -y skills@latest update -g -y), then adds each skill in the latest release's Current catalog that is not installed, since update never adds a skill shipped after the install, and adds nothing where no paperthin skill is installed. It writes one log of its last ten runs and exits non-zero on a failure, so status and the scheduler both show it. A missed midnight runs at the next login or wake; a Linux user timer runs only while the user's session is up, unless lingering is on.
Pass the integrity gate before any remove, update or reinstall of a skills.sh copy. Compare the installed file with the published revisions of the independently pinned upstream LilMGenius/paperthin by running node scripts/upgrade.mjs integrity --installed-file <installed SKILL.md> --skill <slug> --lock <.skill-lock.json> --fetch once per name.
.skill-lock.json, which gives lookup hints, never authority, and no release version. The script accepts the lock entry only when its source and source URL name that upstream and its skill path is skills/<perspective>/<slug>/SKILL.md with the checked slug, a catalog perspective (breadth, depth, coil, mesh), and no traversal or absolute component.https://api.github.com/repos/LilMGenius/paperthin/releases, skips drafts, and fetches the validated path from https://raw.githubusercontent.com/LilMGenius/paperthin/<tag>/<path> at each published tag, newest first, until the bytes match; a 404 means that tag does not hold the path. Timestamps order the candidates and never exclude one, so the walk is complete only when every tag answered.result, its reason, the validated path and each tag walked with its status. A match is clean, exit 0. A full walk with no match is divergent-or-unknown, exit 1. A missing entry, unexpected source, invalid path, unreadable lock or release list, failed fetch or incomplete walk is cannot-compare, exit 1, never clean. Exit 2 is a usage error. The lock's folder hash is never read, and integrity is never inferred from it.Handle failures. If add or update reports a failed skill, retry that skill alone with the same scope flags; any mutation of an installed file still passes the integrity gate. If it fails again, get the user's confirmation by skill name, then remove and reinstall that same name with the same remove and add -s forms, behind the integrity gate. If the reinstall fails, report the skill absent. A replacement or plugin route that fails to reach "new works" cancels the removal paired with it: keep the old copy and report the move stopped with the reason, never retried as a removal. An outstanding host reload is pending, not a failure. A job install or status that exits 1 is reported with its message; never report the job as running without a status that shows it registered.
Verify:
status shows it registered where a global skills.sh install stays, and not registered where none stays.Report any failure as incomplete, never as a successful upgrade.
Explain pickup. Claude Code applies changed SKILL.md content automatically in this session; run /reload-skills in any other running Claude Code session that shares the install, and /reload-plugins after a plugin change. Codex has no in-session reload: restart it, or codex resume. For other agents, restart if the new behavior does not appear.
Offer the star, after successful verification and after reporting the upgrade outcome. Ask once through the host's structured user-question tool: "Star LilMGenius/paperthin on GitHub using your authenticated gh account?" with the options "Star repository" then "Skip", and explain that starring is optional and skipping leaves the upgrade unchanged.
--yes never do.gh auth status --hostname github.com. If gh is missing or auth fails, skip, and offer gh auth login --hostname github.com and the star command for the user to run. Never log in, read tokens or switch API clients. On decline, offer neither command nor a login nudge.gh api --hostname github.com -X PUT user/starred/LilMGenius/paperthin --silent once; --silent hides only the response body. On success report "star is set", never "newly added"; report failures separately. Report the star outcome on its own, after the upgrade report and apart from upgrade success. Star outcomes never block or undo the upgrade.