[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M75BZK0NJDCTJBSFCZ81M9MM":3,"skill-same:01M75BZK0NJDCTJBSFCZ81M9MM":46},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":25,"commitSha":26,"skillDirectory":27,"forksCount":28,"repositoryHtmlUrl":29,"repositoryHomepageUrl":6,"ownerHtmlUrl":30,"ownerBlogUrl":6,"ownerDescription":31,"updatedAt":32,"install":33,"resources":45},"01M75BZK0NJDCTJBSFCZ81M9MM","checkpoint",null,"Use before compaction in a showrunner, workhorse, or detective charter session, a discovery session, or any session with no charter — freshen live state and emit a ready-to-paste `\u002Fcompact` command, and save the checkpoint notes. `\u002Fcompact` is not reachable from a skill; one paste is the floor on hosts without mods. Not configure, review, or discovery work itself.","zwrose\u002Fsuperheroes","zwrose","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F4790575?v=4","01M75BY6XGBZAMPTCT9R25XXC6","Zach Rose","01M75BY6Y519H0CAD79EFWSW3N",1,"MIT","https:\u002F\u002Fgithub.com\u002Fzwrose\u002Fsuperheroes\u002Fblob\u002Fmain\u002Fplugins\u002Fsuperheroes\u002Fskills\u002Fcheckpoint\u002FSKILL.md",[],[],"2026-11-12 13:55:43",false,"---\nname: checkpoint\ndescription: \"Use before compaction in a showrunner, workhorse, or detective charter session, a discovery session, or any session with no charter — freshen live state and emit a ready-to-paste `\u002Fcompact` command, and save the checkpoint notes. `\u002Fcompact` is not reachable from a skill; one paste is the floor on hosts without mods. Not configure, review, or discovery work itself.\"\nuser-invocable: true\n---\n\nThis skill speaks in host-neutral actions. Resolve them to your runtime's tools by reading the host tool map at `${CLAUDE_PLUGIN_ROOT}\u002Fhosts\u002F\u003Cyour-host>-tools.md` (the leading variable is this plugin's root directory) — `claude-tools.md` on Claude Code, `codex-tools.md` on Codex.\n\n# checkpoint\n\nPrepare **any session** for context compaction: a Showrunner advisor, a Workhorse builder,\na Detective diagnostician, a Discovery interview, or a **generic** session with no charter at\nall. This skill does **not** compact by itself — `\u002Fcompact` is not reachable from a skill.\nIt does two things: it saves **checkpoint notes** (the live state a summary would otherwise\nlose) and it prints the **ready-to-paste `\u002Fcompact` line**.\n\n- **Where the superheroes mod is present** (Claude Code with mods), the mod saves the notes\n  from this reply and applies the session's directive plus those notes on **every**\n  compaction, manual or automatic — no paste needed.\n- **Where it is not**, the floor is: **run checkpoint, paste the emitted command once.** The\n  PreCompact hook still prints the session's directive (charter or generic) plus the\n  checkpoint notes, unless the mod already delivered, and after compaction the SessionStart\n  recovery hook re-injects a pointer to re-read the charter skill from disk, so the owner\n  does **not** need to re-invoke `\u002Fsuperheroes:showrunner`, `\u002Fsuperheroes:workhorse`, or\n  `\u002Fsuperheroes:detective` by hand.\n\nNotes files older than `NOTES_MAX_AGE_DAYS` (in `lib\u002Fcompaction_directive.py`) and stale delivery markers are removed at session start; a resumed session older than that gets its notes rewritten by its next checkpoint.\n\n## Invocation\n\n| Form | Behavior |\n| --- | --- |\n| `\u002Fsuperheroes:checkpoint` | Resolve the session's mode, freshen the notes, save them (the mod, or you), print a ready-to-paste `\u002Fcompact` line. Works in every session; a session with no charter is `generic`. |\n| `\u002Fsuperheroes:checkpoint auto` | The mod's automatic run (it compacts afterwards): freshen and save the notes with a short reply; no `\u002Fcompact` line. |\n\n**With the argument `auto`** keep the reply short: do steps 1 to 3, then end with the notes block exactly as step 4 specifies. Do **not** print the step 5 `\u002Fcompact` line (or its explanation) — the mod compacts when the notes file has changed.\n\n## Step 1 — Resolve this session's mode\n\nResolve the session's **transcript path** first — the absolute path to this session's\nJSONL transcript. On Claude Code, hook payloads name it in the common field\n`transcript_path` (see the host hooks reference); if this session pinned that path earlier,\nuse the pin — never re-discover by newest file (`rubric\u002Flaunch-doctrine.md` § Pin the\ntranscript). Resolving a session transcript path is a Claude-host mechanical floor; on a\nhost that does not name one, this step has no equivalent and the mode is `generic`.\n\nThen ask the plugin lib for the mode. The lib's verbs and flags are defined in\n`lib\u002Fcompaction_cli.json` — read it and use its names where `\u003CVERB>` and `\u003CFLAG>` stand below\n(`\u003CVERB>` is the `verbs` key for the action — here `mode` — and `\u003CFLAG>` is that entry's value\nfor the input — here `transcriptPath`):\n\n```bash\ncat \"${CLAUDE_PLUGIN_ROOT}\u002Flib\u002Fcompaction_cli.json\"\npython3 -B \"${CLAUDE_PLUGIN_ROOT}\u002Flib\u002Fcompaction_directive.py\" \u003CVERB> \u003CFLAG> \"\u003Cabsolute path to this session's transcript>\"\n```\n\nIt prints one JSON object: `{\"ok\": true, \"mode\": \"\u003Cmode>\"}` with `\u003Cmode>` one of\n`showrunner`, `workhorse`, `detective`, `discovery`, or `generic` (no charter detected).\n**Never refuse:** if the command fails or prints `\"ok\": false`, continue as `generic` and\nsay so in one line.\n\n## Step 2 — Find the notes file\n\nThe checkpoint notes live in one file per session. The session bootstrap's\n`Checkpoint file` line names it — use that path. If the bootstrap carries no such line, ask\nthe lib for it, with the session id: the transcript file's name without its extension on\nClaude Code, or the host's own session id where it names one (a host with a transcript path\nor session id has no other source here — never guess one):\n\n```bash\npython3 -B \"${CLAUDE_PLUGIN_ROOT}\u002Flib\u002Fcompaction_directive.py\" \u003CVERB> \u003CFLAG> \"\u003Csession id>\"\n```\n\nHere `\u003CVERB>` is the `path` entry of `lib\u002Fcompaction_cli.json` (read in step 1) and `\u003CFLAG>` is that\nentry's `sessionId` value.\n\nIt prints `{\"ok\": true, \"path\": \"\u003Cnotes file>\", \"markerPath\": \"\u003Cdelivered marker>\"}`. Read the\nnotes file if it exists — it is what the last checkpoint saved. Do not invent a path or\nfilename.\n\n**No resolvable notes path** (no bootstrap `Checkpoint file` line and no session id — a host\nwithout a transcript path or a SessionStart bootstrap): say so in one line, skip the save in\nstep 4, and still end the reply with the checkpoint block and the `\u002Fcompact` line so the\nnotes live in the conversation itself; they are not persisted for automatic compaction.\n\n## Step 3 — Freshen the live state (per mode)\n\nConfirm each item from durable artifacts and the session ledger, not from memory.\n\n**Showrunner** — confirm:\n\n- live build lanes and their states;\n- outstanding PR vets;\n- open owner decisions.\n\nThen **freshen the resume point** at the top of this session's ledger — it is where\n`skills\u002Fshowrunner-handoff\u002FSKILL.md` and `skills\u002Fshowrunner-resume\u002FSKILL.md` read the\nadvisor's state, and the notes file of step 2 is not a substitute for it. **If** the\nsession keeps one, bring it up to date and confirm it reflects current reality (the items\nabove); **if** it keeps none, say so in one line and continue — invent no format, path, or\nfilename. This is in addition to the per-session notes file, which the compaction\ninstructions still use.\n\n**Workhorse** — confirm:\n\n- the issue being built;\n- the PR and its build record;\n- the current work order;\n- the build worktree and branch;\n- which receipts are earned versus owed.\n\n**Detective** — confirm:\n\n- the incident and its issue;\n- the hypotheses ruled out and what ruled each;\n- the demonstration state and which disposable copy holds it;\n- the named budget and how much is spent.\n\n**Discovery** — confirm:\n\n- the work item's slug;\n- the spec draft's path;\n- the requirements the owner has agreed;\n- the open questions;\n- the approval state (framing approved? spec approved?).\n\n**Generic** — write down, from the conversation:\n\n- this session's role and responsibilities;\n- the task and where it stands;\n- the decisions made so far;\n- what is waiting on the owner.\n\n## Step 4 — Write the notes and the compaction instructions as one block\n\nFirst read the block's info string from its one definition, the `CHECKPOINT_INFO` constant in\n`hooks\u002Fmod\u002Fcheckpoint-block.ts` (the one parser), and use the value it prints — `\u003CCHECKPOINT_INFO>` below:\n\n```bash\nsed -n \"s\u002F^export const CHECKPOINT_INFO = '\\(.*\\)'.*\u002F\\1\u002Fp\" \"${CLAUDE_PLUGIN_ROOT}\u002Fhooks\u002Fmod\u002Fcheckpoint-block.ts\"\n```\n\nEnd the reply with **one** fenced block whose info string is exactly `\u003CCHECKPOINT_INFO>`.\nIts body is the freshened notes (step 3) followed by the compaction instructions (the five\nparts of step 5, as prose). Rules:\n\n- it is the **last thing in the reply** — nothing after the closing fence;\n- **no other fence inside it** (no code blocks, no nested fences) — plain text and lists only;\n- it is the only `\u003CCHECKPOINT_INFO>` block in the reply.\n\nThen check how the notes get saved. The mod sets a presence variable to the id of the session it\nruns in; its name is defined by the `$.env.set` call in `hooks\u002Fmod\u002Fregister.ts`. Read the name\n(`\u003CMOD_VAR>` below), then print that variable's value:\n\n```bash\nsed -n \"s\u002F.*\\$\\.env\\.set('\\([^']*\\)'.*\u002F\\1\u002Fp\" \"${CLAUDE_PLUGIN_ROOT}\u002Fhooks\u002Fmod\u002Fregister.ts\"\nprintenv \u003CMOD_VAR>\n```\n\n- **Prints this session's id** (the one in the step 2 notes file name): the mod saves the block to the notes\n  file when the reply ends. Do **not** write the file yourself.\n- **Anything else** (nothing, or a different id inherited from another session): no mod in this\n  session. Save the **same block body** (without the fences) through the lib's\n  `save` verb, which takes the checkpoint directory's lock: the same invocation shape as\n  step 2's `path` command, with `\u003CVERB>` the `save` entry of `lib\u002Fcompaction_cli.json` (read in\n  step 1), `\u003CFLAG>` that entry's `sessionId` value, and the block body on stdin (skip this when\n  step 2 found no notes path). Never write the notes file with a raw file write. If the lib\n  refuses or cannot run, say so in one line; the save failed, so the notes are not persisted.\n\nAn example of the block, shown inside a longer fence so it stays inert here:\n\n````text\n```\u003CCHECKPOINT_INFO>\n## Checkpoint notes\nMode: workhorse\nIssue #911, PR #918; build record: the PR body's \"Build record\" section.\nWork order WO4 in flight on branch wh911-wo4, worktree \u002Fprivate\u002Ftmp\u002Fsh911-wo4.\nReceipts earned: charter_detect green. Owed: validate_skills, validate_hosts, pytest.\nWaiting on the owner: nothing.\n\n## Compaction instructions\nPreserve this as a Workhorse (builder) charter session. Resume pointer: this notes file. Live: building issue #911, WO4. Open owner decisions: none. Drop verbatim tool receipts, file diffs, probe transcripts, and command stdout.\n```\n````\n\n## Step 5 — Print the ready-to-paste `\u002Fcompact` line\n\nPrint this **before** the step 4 block, so the block stays last. Build `\u002Fcompact` followed\nby summarization instructions with **five parts, in order**:\n\n1. **Identity** — which mode this session is (Showrunner advisor, Workhorse builder,\n   Detective diagnostician, Discovery interviewer, or the generic role in one phrase).\n2. **Resume-point pointer** — where the notes live (the notes file path; the pointer, not\n   its contents).\n3. **Live-state one-liner** — the current truth in one sentence.\n4. **Open owner decisions** — unresolved owner choices (or state plainly when none).\n5. **Drop-list** — verbatim tool output, file diffs, probe transcripts, and command stdout\n   (recoverable from GitHub or the ledger; must not consume summary budget).\n\nPresent the finished line in a fenced code block (info string `text`) clearly marked as the\nthing to copy. Say that where the mod is present it also applies this directive\nautomatically on every compaction, so pasting is only needed on hosts without mods.\n\n### Worked examples (filled-in lines a session would really emit)\n\n**Showrunner:**\n\n```text\n\u002Fcompact Preserve this as a Showrunner (advisor) charter session for the superheroes repo. Resume pointer: the checkpoint notes file named in the session bootstrap. Live: #911 compaction wave — WO4 checkpoint skill in flight on wh911-wo4; PR #908 vet queued; release-please PR open. Open owner decisions: whether #911 cuts 0.25.0 or queues behind 0.24.1. Drop verbatim tool receipts, file diffs, probe transcripts, and command stdout — recoverable from GitHub and the ledger.\n```\n\n**Workhorse:**\n\n```text\n\u002Fcompact Preserve this as a Workhorse (builder) charter session. Resume pointer: the checkpoint notes file. Live: building issue #911 (PR #918) — WO4 checkpoint skill on branch wh911-wo4 in worktree \u002Fprivate\u002Ftmp\u002Fsh911-wo4; parallel orders own hooks and session_context. Receipts earned: charter_detect green on base; owed: validate_skills, validate_hosts, validate_marketplace, pytest for this WO. Open owner decisions: none in this build (advisor-routed full lane). Drop verbatim tool receipts, file diffs, probe transcripts, and command stdout — recoverable from GitHub and the ledger.\n```\n\n**Detective:**\n\n```text\n\u002Fcompact Preserve this as a Detective (diagnostician) charter session. Resume pointer: the checkpoint notes file. Live: incident #931 — checkpoint skill omits detective charter; ruled out stale transcript path (grep shows correct command); disposable copy at \u002Ftmp\u002Fsh931-probe holds A\u002FB toggle. Budget: one advisor dispatch, ~40% spent. Open owner decisions: whether detective checkpoint ships in 0.25.0. Drop verbatim tool receipts, file diffs, probe transcripts, and command stdout — recoverable from GitHub and the ledger.\n```\n\n**Discovery:**\n\n```text\n\u002Fcompact Preserve this as a Discovery (requirements interview) session. Resume pointer: the checkpoint notes file. Live: slug quiet-hours, spec draft at the work item's spec file; framing approved, three requirements agreed, two open questions on weekend handling. Open owner decisions: whether weekends are in scope; spec approval not yet asked. Drop verbatim tool receipts, file diffs, probe transcripts, and command stdout — recoverable from GitHub and the ledger.\n```\n\n**Generic:**\n\n```text\n\u002Fcompact Preserve this as a code-review helper session for the owner. Resume pointer: the checkpoint notes file. Live: reviewing the retry change in the payments client; two findings written up, third pending. Open owner decisions: whether to block the merge on the missing timeout test. Drop verbatim tool receipts, file diffs, probe transcripts, and command stdout — recoverable from GitHub and the ledger.\n```\n\n## What happens after\n\nWhere the mod is present, the next compaction (manual or automatic) is steered by the\nsession's directive plus the notes file this skill saved; the owner pastes nothing. On a\nhost without mods, compaction runs when the owner pastes the `\u002Fcompact` line; the PreCompact\nhook prints the session's directive (charter or generic) plus the checkpoint notes, unless\nthe mod already delivered, and on the next SessionStart with `source: compact` the\nrecovery hook re-injects a pointer to re-read the charter skill from disk. Nothing in this\nskill triggers compaction programmatically. Where the mod is present, the session resumes on\nits own after the mod's compaction or a manual `\u002Fcompact`: the mod submits one prompt telling\nit to re-read its resume point and continue (the text lives in `hooks\u002Fmod\u002Fresume.ts`).\n\n## Common mistakes\n\n| Mistake | Fix |\n| --- | --- |\n| Refusing because the session has no charter | Step 1 returns `generic` for a session with no charter; checkpoint covers every session. |\n| Writing the notes file when `\u003CMOD_VAR>` holds this session's id | The mod saves the block from the reply; writing it too races the mod. Write the file whenever the variable is unset or holds another id. |\n| Putting anything after the `\u003CCHECKPOINT_INFO>` block, or a second fence inside it | The block must be the last thing in the reply with no inner fence; otherwise the notes are not saved. |\n| Using another info string, or fewer than three backticks | The fence's info string is exactly the value read from `CHECKPOINT_INFO` in step 4. |\n| Skipping the ledger resume point in a Showrunner session because the notes file was saved | The incoming advisor reads the ledger resume point, not the notes file; freshen both (step 3). |\n| Inventing a notes path or filename | Use the bootstrap's `Checkpoint file` line, else the lib's `path` verb. |\n| Pasting charter prose into the `\u002Fcompact` line | The line carries pointers and live state; the charter reloads from disk after compaction. |\n| Claiming checkpoint compacts by itself | It saves notes and prints the line; the mod steers compaction, or the owner pastes `\u002Fcompact` once — that is the floor. |\n","This skill speaks in host-neutral actions. Resolve them to your runtime's tools by reading the host tool map at `${CLAUDE_PLUGIN_ROOT}\u002Fhosts\u002F\u003Cyour-host>-tools.md` (the leading variable is this plugin's root directory) — `claude-tools.md` on Claude Code, `codex-tools.md` on Codex.\n\n# checkpoint\n\nPrepare **any session** for context compaction: a Showrunner advisor, a Workhorse builder,\na Detective diagnostician, a Discovery interview, or a **generic** session with no charter at\nall. This skill does **not** compact by itself — `\u002Fcompact` is not reachable from a skill.\nIt does two things: it saves **checkpoint notes** (the live state a summary would otherwise\nlose) and it prints the **ready-to-paste `\u002Fcompact` line**.\n\n- **Where the superheroes mod is present** (Claude Code with mods), the mod saves the notes\n  from this reply and applies the session's directive plus those notes on **every**\n  compaction, manual or automatic — no paste needed.\n- **Where it is not**, the floor is: **run checkpoint, paste the emitted command once.** The\n  PreCompact hook still prints the session's directive (charter or generic) plus the\n  checkpoint notes, unless the mod already delivered, and after compaction the SessionStart\n  recovery hook re-injects a pointer to re-read the charter skill from disk, so the owner\n  does **not** need to re-invoke `\u002Fsuperheroes:showrunner`, `\u002Fsuperheroes:workhorse`, or\n  `\u002Fsuperheroes:detective` by hand.\n\nNotes files older than `NOTES_MAX_AGE_DAYS` (in `lib\u002Fcompaction_directive.py`) and stale delivery markers are removed at session start; a resumed session older than that gets its notes rewritten by its next checkpoint.\n\n## Invocation\n\n| Form | Behavior |\n| --- | --- |\n| `\u002Fsuperheroes:checkpoint` | Resolve the session's mode, freshen the notes, save them (the mod, or you), print a ready-to-paste `\u002Fcompact` line. Works in every session; a session with no charter is `generic`. |\n| `\u002Fsuperheroes:checkpoint auto` | The mod's automatic run (it compacts afterwards): freshen and save the notes with a short reply; no `\u002Fcompact` line. |\n\n**With the argument `auto`** keep the reply short: do steps 1 to 3, then end with the notes block exactly as step 4 specifies. Do **not** print the step 5 `\u002Fcompact` line (or its explanation) — the mod compacts when the notes file has changed.\n\n## Step 1 — Resolve this session's mode\n\nResolve the session's **transcript path** first — the absolute path to this session's\nJSONL transcript. On Claude Code, hook payloads name it in the common field\n`transcript_path` (see the host hooks reference); if this session pinned that path earlier,\nuse the pin — never re-discover by newest file (`rubric\u002Flaunch-doctrine.md` § Pin the\ntranscript). Resolving a session transcript path is a Claude-host mechanical floor; on a\nhost that does not name one, this step has no equivalent and the mode is `generic`.\n\nThen ask the plugin lib for the mode. The lib's verbs and flags are defined in\n`lib\u002Fcompaction_cli.json` — read it and use its names where `\u003CVERB>` and `\u003CFLAG>` stand below\n(`\u003CVERB>` is the `verbs` key for the action — here `mode` — and `\u003CFLAG>` is that entry's value\nfor the input — here `transcriptPath`):\n\n```bash\ncat \"${CLAUDE_PLUGIN_ROOT}\u002Flib\u002Fcompaction_cli.json\"\npython3 -B \"${CLAUDE_PLUGIN_ROOT}\u002Flib\u002Fcompaction_directive.py\" \u003CVERB> \u003CFLAG> \"\u003Cabsolute path to this session's transcript>\"\n```\n\nIt prints one JSON object: `{\"ok\": true, \"mode\": \"\u003Cmode>\"}` with `\u003Cmode>` one of\n`showrunner`, `workhorse`, `detective`, `discovery`, or `generic` (no charter detected).\n**Never refuse:** if the command fails or prints `\"ok\": false`, continue as `generic` and\nsay so in one line.\n\n## Step 2 — Find the notes file\n\nThe checkpoint notes live in one file per session. The session bootstrap's\n`Checkpoint file` line names it — use that path. If the bootstrap carries no such line, ask\nthe lib for it, with the session id: the transcript file's name without its extension on\nClaude Code, or the host's own session id where it names one (a host with a transcript path\nor session id has no other source here — never guess one):\n\n```bash\npython3 -B \"${CLAUDE_PLUGIN_ROOT}\u002Flib\u002Fcompaction_directive.py\" \u003CVERB> \u003CFLAG> \"\u003Csession id>\"\n```\n\nHere `\u003CVERB>` is the `path` entry of `lib\u002Fcompaction_cli.json` (read in step 1) and `\u003CFLAG>` is that\nentry's `sessionId` value.\n\nIt prints `{\"ok\": true, \"path\": \"\u003Cnotes file>\", \"markerPath\": \"\u003Cdelivered marker>\"}`. Read the\nnotes file if it exists — it is what the last checkpoint saved. Do not invent a path or\nfilename.\n\n**No resolvable notes path** (no bootstrap `Checkpoint file` line and no session id — a host\nwithout a transcript path or a SessionStart bootstrap): say so in one line, skip the save in\nstep 4, and still end the reply with the checkpoint block and the `\u002Fcompact` line so the\nnotes live in the conversation itself; they are not persisted for automatic compaction.\n\n## Step 3 — Freshen the live state (per mode)\n\nConfirm each item from durable artifacts and the session ledger, not from memory.\n\n**Showrunner** — confirm:\n\n- live build lanes and their states;\n- outstanding PR vets;\n- open owner decisions.\n\nThen **freshen the resume point** at the top of this session's ledger — it is where\n`skills\u002Fshowrunner-handoff\u002FSKILL.md` and `skills\u002Fshowrunner-resume\u002FSKILL.md` read the\nadvisor's state, and the notes file of step 2 is not a substitute for it. **If** the\nsession keeps one, bring it up to date and confirm it reflects current reality (the items\nabove); **if** it keeps none, say so in one line and continue — invent no format, path, or\nfilename. This is in addition to the per-session notes file, which the compaction\ninstructions still use.\n\n**Workhorse** — confirm:\n\n- the issue being built;\n- the PR and its build record;\n- the current work order;\n- the build worktree and branch;\n- which receipts are earned versus owed.\n\n**Detective** — confirm:\n\n- the incident and its issue;\n- the hypotheses ruled out and what ruled each;\n- the demonstration state and which disposable copy holds it;\n- the named budget and how much is spent.\n\n**Discovery** — confirm:\n\n- the work item's slug;\n- the spec draft's path;\n- the requirements the owner has agreed;\n- the open questions;\n- the approval state (framing approved? spec approved?).\n\n**Generic** — write down, from the conversation:\n\n- this session's role and responsibilities;\n- the task and where it stands;\n- the decisions made so far;\n- what is waiting on the owner.\n\n## Step 4 — Write the notes and the compaction instructions as one block\n\nFirst read the block's info string from its one definition, the `CHECKPOINT_INFO` constant in\n`hooks\u002Fmod\u002Fcheckpoint-block.ts` (the one parser), and use the value it prints — `\u003CCHECKPOINT_INFO>` below:\n\n```bash\nsed -n \"s\u002F^export const CHECKPOINT_INFO = '\\(.*\\)'.*\u002F\\1\u002Fp\" \"${CLAUDE_PLUGIN_ROOT}\u002Fhooks\u002Fmod\u002Fcheckpoint-block.ts\"\n```\n\nEnd the reply with **one** fenced block whose info string is exactly `\u003CCHECKPOINT_INFO>`.\nIts body is the freshened notes (step 3) followed by the compaction instructions (the five\nparts of step 5, as prose). Rules:\n\n- it is the **last thing in the reply** — nothing after the closing fence;\n- **no other fence inside it** (no code blocks, no nested fences) — plain text and lists only;\n- it is the only `\u003CCHECKPOINT_INFO>` block in the reply.\n\nThen check how the notes get saved. The mod sets a presence variable to the id of the session it\nruns in; its name is defined by the `$.env.set` call in `hooks\u002Fmod\u002Fregister.ts`. Read the name\n(`\u003CMOD_VAR>` below), then print that variable's value:\n\n```bash\nsed -n \"s\u002F.*\\$\\.env\\.set('\\([^']*\\)'.*\u002F\\1\u002Fp\" \"${CLAUDE_PLUGIN_ROOT}\u002Fhooks\u002Fmod\u002Fregister.ts\"\nprintenv \u003CMOD_VAR>\n```\n\n- **Prints this session's id** (the one in the step 2 notes file name): the mod saves the block to the notes\n  file when the reply ends. Do **not** write the file yourself.\n- **Anything else** (nothing, or a different id inherited from another session): no mod in this\n  session. Save the **same block body** (without the fences) through the lib's\n  `save` verb, which takes the checkpoint directory's lock: the same invocation shape as\n  step 2's `path` command, with `\u003CVERB>` the `save` entry of `lib\u002Fcompaction_cli.json` (read in\n  step 1), `\u003CFLAG>` that entry's `sessionId` value, and the block body on stdin (skip this when\n  step 2 found no notes path). Never write the notes file with a raw file write. If the lib\n  refuses or cannot run, say so in one line; the save failed, so the notes are not persisted.\n\nAn example of the block, shown inside a longer fence so it stays inert here:\n\n````text\n```\u003CCHECKPOINT_INFO>\n## Checkpoint notes\nMode: workhorse\nIssue #911, PR #918; build record: the PR body's \"Build record\" section.\nWork order WO4 in flight on branch wh911-wo4, worktree \u002Fprivate\u002Ftmp\u002Fsh911-wo4.\nReceipts earned: charter_detect green. Owed: validate_skills, validate_hosts, pytest.\nWaiting on the owner: nothing.\n\n## Compaction instructions\nPreserve this as a Workhorse (builder) charter session. Resume pointer: this notes file. Live: building issue #911, WO4. Open owner decisions: none. Drop verbatim tool receipts, file diffs, probe transcripts, and command stdout.\n```\n````\n\n## Step 5 — Print the ready-to-paste `\u002Fcompact` line\n\nPrint this **before** the step 4 block, so the block stays last. Build `\u002Fcompact` followed\nby summarization instructions with **five parts, in order**:\n\n1. **Identity** — which mode this session is (Showrunner advisor, Workhorse builder,\n   Detective diagnostician, Discovery interviewer, or the generic role in one phrase).\n2. **Resume-point pointer** — where the notes live (the notes file path; the pointer, not\n   its contents).\n3. **Live-state one-liner** — the current truth in one sentence.\n4. **Open owner decisions** — unresolved owner choices (or state plainly when none).\n5. **Drop-list** — verbatim tool output, file diffs, probe transcripts, and command stdout\n   (recoverable from GitHub or the ledger; must not consume summary budget).\n\nPresent the finished line in a fenced code block (info string `text`) clearly marked as the\nthing to copy. Say that where the mod is present it also applies this directive\nautomatically on every compaction, so pasting is only needed on hosts without mods.\n\n### Worked examples (filled-in lines a session would really emit)\n\n**Showrunner:**\n\n```text\n\u002Fcompact Preserve this as a Showrunner (advisor) charter session for the superheroes repo. Resume pointer: the checkpoint notes file named in the session bootstrap. Live: #911 compaction wave — WO4 checkpoint skill in flight on wh911-wo4; PR #908 vet queued; release-please PR open. Open owner decisions: whether #911 cuts 0.25.0 or queues behind 0.24.1. Drop verbatim tool receipts, file diffs, probe transcripts, and command stdout — recoverable from GitHub and the ledger.\n```\n\n**Workhorse:**\n\n```text\n\u002Fcompact Preserve this as a Workhorse (builder) charter session. Resume pointer: the checkpoint notes file. Live: building issue #911 (PR #918) — WO4 checkpoint skill on branch wh911-wo4 in worktree \u002Fprivate\u002Ftmp\u002Fsh911-wo4; parallel orders own hooks and session_context. Receipts earned: charter_detect green on base; owed: validate_skills, validate_hosts, validate_marketplace, pytest for this WO. Open owner decisions: none in this build (advisor-routed full lane). Drop verbatim tool receipts, file diffs, probe transcripts, and command stdout — recoverable from GitHub and the ledger.\n```\n\n**Detective:**\n\n```text\n\u002Fcompact Preserve this as a Detective (diagnostician) charter session. Resume pointer: the checkpoint notes file. Live: incident #931 — checkpoint skill omits detective charter; ruled out stale transcript path (grep shows correct command); disposable copy at \u002Ftmp\u002Fsh931-probe holds A\u002FB toggle. Budget: one advisor dispatch, ~40% spent. Open owner decisions: whether detective checkpoint ships in 0.25.0. Drop verbatim tool receipts, file diffs, probe transcripts, and command stdout — recoverable from GitHub and the ledger.\n```\n\n**Discovery:**\n\n```text\n\u002Fcompact Preserve this as a Discovery (requirements interview) session. Resume pointer: the checkpoint notes file. Live: slug quiet-hours, spec draft at the work item's spec file; framing approved, three requirements agreed, two open questions on weekend handling. Open owner decisions: whether weekends are in scope; spec approval not yet asked. Drop verbatim tool receipts, file diffs, probe transcripts, and command stdout — recoverable from GitHub and the ledger.\n```\n\n**Generic:**\n\n```text\n\u002Fcompact Preserve this as a code-review helper session for the owner. Resume pointer: the checkpoint notes file. Live: reviewing the retry change in the payments client; two findings written up, third pending. Open owner decisions: whether to block the merge on the missing timeout test. Drop verbatim tool receipts, file diffs, probe transcripts, and command stdout — recoverable from GitHub and the ledger.\n```\n\n## What happens after\n\nWhere the mod is present, the next compaction (manual or automatic) is steered by the\nsession's directive plus the notes file this skill saved; the owner pastes nothing. On a\nhost without mods, compaction runs when the owner pastes the `\u002Fcompact` line; the PreCompact\nhook prints the session's directive (charter or generic) plus the checkpoint notes, unless\nthe mod already delivered, and on the next SessionStart with `source: compact` the\nrecovery hook re-injects a pointer to re-read the charter skill from disk. Nothing in this\nskill triggers compaction programmatically. Where the mod is present, the session resumes on\nits own after the mod's compaction or a manual `\u002Fcompact`: the mod submits one prompt telling\nit to re-read its resume point and continue (the text lives in `hooks\u002Fmod\u002Fresume.ts`).\n\n## Common mistakes\n\n| Mistake | Fix |\n| --- | --- |\n| Refusing because the session has no charter | Step 1 returns `generic` for a session with no charter; checkpoint covers every session. |\n| Writing the notes file when `\u003CMOD_VAR>` holds this session's id | The mod saves the block from the reply; writing it too races the mod. Write the file whenever the variable is unset or holds another id. |\n| Putting anything after the `\u003CCHECKPOINT_INFO>` block, or a second fence inside it | The block must be the last thing in the reply with no inner fence; otherwise the notes are not saved. |\n| Using another info string, or fewer than three backticks | The fence's info string is exactly the value read from `CHECKPOINT_INFO` in step 4. |\n| Skipping the ledger resume point in a Showrunner session because the notes file was saved | The incoming advisor reads the ledger resume point, not the notes file; freshen both (step 3). |\n| Inventing a notes path or filename | Use the bootstrap's `Checkpoint file` line, else the lib's `path` verb. |\n| Pasting charter prose into the `\u002Fcompact` line | The line carries pointers and live state; the charter reloads from disk after compaction. |\n| Claiming checkpoint compacts by itself | It saves notes and prints the line; the mod steers compaction, or the owner pastes `\u002Fcompact` once — that is the floor. |\n",{"name":5,"description":7,"user-invocable":24},true,"main","29c87a13937804687577d3b71e3005f63883f35c","plugins\u002Fsuperheroes\u002Fskills\u002Fcheckpoint",0,"https:\u002F\u002Fgithub.com\u002Fzwrose\u002Fsuperheroes","https:\u002F\u002Fgithub.com\u002Fzwrose","Learning, tinkering, and other such stuff. ","2026-11-15 04:46:57",{"source":8,"skillName":5,"commands":34,"prompt":44,"zipAvailable":24},[35,38,41],{"tool":36,"command":37},"npx","npx skills add zwrose\u002Fsuperheroes --skill checkpoint",{"tool":39,"command":40},"bunx","bunx skills add zwrose\u002Fsuperheroes --skill checkpoint",{"tool":42,"command":43},"pnpm","pnpm dlx skills add zwrose\u002Fsuperheroes --skill checkpoint","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fzwrose\u002Fsuperheroes\u002Fblob\u002Fmain\u002Fplugins\u002Fsuperheroes\u002Fskills\u002Fcheckpoint\u002FSKILL.md",[],[47,54,61,68,75,82],{"skillNo":48,"name":49,"nameZh":6,"description":50,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":51,"categories":52,"keywords":53,"publishedAt":19},"01M75C14YXJ1W26N03VHRDP38K","test-pilot-plan","Use when a PR\u002Fbranch needs a manual test plan with seeded data — \"write a test plan\", \"seed test data for this PR\", \"set up manual testing\". Seeds scenarios via the test-pilot engine and posts a checkbox plan to the PR. Does NOT execute the plan (that is test-pilot-execute).","https:\u002F\u002Fgithub.com\u002Fzwrose\u002Fsuperheroes\u002Fblob\u002Fmain\u002Fplugins\u002Fsuperheroes\u002Fskills\u002Ftest-pilot-plan\u002FSKILL.md",[],[],{"skillNo":55,"name":56,"nameZh":6,"description":57,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":58,"categories":59,"keywords":60,"publishedAt":19},"01M75C11VXVBT356RSPSYFHM2W","test-pilot-init","Internal helper reached from `superheroes:configure` to refresh test-pilot's profile, seeding blocks, and browser tooling layer. Not a front door; owners run `superheroes:configure` instead.","https:\u002F\u002Fgithub.com\u002Fzwrose\u002Fsuperheroes\u002Fblob\u002Fmain\u002Fplugins\u002Fsuperheroes\u002Fskills\u002Ftest-pilot-init\u002FSKILL.md",[],[],{"skillNo":62,"name":63,"nameZh":6,"description":64,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":65,"categories":66,"keywords":67,"publishedAt":19},"01M75C0YKSEDN9TQCSA2MY01WQ","test-pilot-execute","Use when a test-pilot plan should be exercised before human spot-check — \"run the test plan\", \"pilot this PR\", \"verify the branch in the browser\". Drives the app via a browser MCP, or the lane's simulated iPhone, and posts a results comment. Observe-and-report only — a bug it finds is a finding, never an edit.","https:\u002F\u002Fgithub.com\u002Fzwrose\u002Fsuperheroes\u002Fblob\u002Fmain\u002Fplugins\u002Fsuperheroes\u002Fskills\u002Ftest-pilot-execute\u002FSKILL.md",[],[],{"skillNo":69,"name":70,"nameZh":6,"description":71,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":72,"categories":73,"keywords":74,"publishedAt":19},"01M75C0FC2AADQP6HR4XC94NV0","showrunner-handoff","Use in the showrunner advisor seat you are leaving while it is still alive — deliberate handover before the seat goes dark. Leaves durable state for the incoming seat. Emits no paste block. Not checkpoint (`\u002Fcompact`); not showrunner-resume (incoming seat).","https:\u002F\u002Fgithub.com\u002Fzwrose\u002Fsuperheroes\u002Fblob\u002Fmain\u002Fplugins\u002Fsuperheroes\u002Fskills\u002Fshowrunner-handoff\u002FSKILL.md",[],[],{"skillNo":76,"name":77,"nameZh":6,"description":78,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":79,"categories":80,"keywords":81,"publishedAt":19},"01M75C0C5908SMD71067S8JJGR","review-init","Internal helper reached from `superheroes:configure` to refresh review-crew's calibration layer for a project. Not a front door; owners run `superheroes:configure` instead.","https:\u002F\u002Fgithub.com\u002Fzwrose\u002Fsuperheroes\u002Fblob\u002Fmain\u002Fplugins\u002Fsuperheroes\u002Fskills\u002Freview-init\u002FSKILL.md",[],[],{"skillNo":83,"name":84,"nameZh":6,"description":85,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":86,"categories":87,"keywords":88,"publishedAt":19},"01M75C08CZA02HRPRJ1TFJSS9H","review-code","Use when reviewing code changes on a local branch or an open pull request before merging — including when you want the review's findings auto-fixed locally. Gives a multi-specialist review with a fix-and-re-review loop. Not a whole-repo debt sweep (that is guardian).","https:\u002F\u002Fgithub.com\u002Fzwrose\u002Fsuperheroes\u002Fblob\u002Fmain\u002Fplugins\u002Fsuperheroes\u002Fskills\u002Freview-code\u002FSKILL.md",[],[]]