resume
Skill10 starsChanged 2 days agoMITView on GitHub
Writes and reads orchestrator checkpoints so long work continues in a new session after a context or rate limit, compaction, or crash. Use on /orchestrator:resume or when on/team/autopilot say to write a checkpoint.
62 other projects use a version of this.
Adopted by
Most recently taken up by
- DeepExtrema/Tesseracttheir own version, first seen Nov 16, 2026
- netarz/gisoo-skills-registrytheir own version, first seen Nov 15, 2026
- kuldeep-jadeja/claude-handoff-plugintheir own version, first seen Nov 15, 2026
- gutohuida/AgentWeavetheir own version, first seen Nov 15, 2026
- qbeka/jev-job-searchtheir own version, first seen Nov 12, 2026
- thesun4sky/jobstacktheir own version, first seen Nov 10, 2026
Used with
Projects with it also use pause, report and 9 more.
Other files people use alongside this one.
Files found in the same public projects as a version of this one, more often than they turn up anywhere else. Each project counts once, large collections count for less, and this file's own repository is left out.
kennethleungtySkillpause
Pause — stop the music (alias for /stop)
Also in 7 projects that use this
MicrosoftSkillreport
Turn an exploration (threads, findings, charts) into a single Markdown report — note, blog post, executive summary, KPI dashboard, slide brief, or multi-section analytical report, with embedded charts.
Also in 7 projects that use this
MicrosoftSkillconfig
Show or change TokenEconomizer's settings: turn micro-skills, tool pruning or the loop guard on or off, or tune them, for this repository or (with --global) every repository. Use when the user asks to configure, enable or disable TokenEconomizer or one of its mechanisms.
Also in 3 projects that use this
sahinSkillexecute
Also in 4 projects that use this
u9401066Skillbug-fix
Structured bug fixing workflow with root cause analysis and regression prevention. Triggers: BF, 修 bug, fix bug, debug, 除錯, 錯誤, error, 問題, issue, 修復, fix, 故障, fault, 異常, exception, 失敗, failure, 不能用, broken, 壞掉.
Also in 3 projects that use this
GitHubSkillstate-management
CoreAI Sandbox's TanStack Query + mock-JSON data layer. USE WHEN: editing data-fetching hooks (`app/hooks/use*.ts`), adding mock data in `app/data/`, or wiring a component to query state.
Also in 3 projects that use this
- +2 more from microsoft
Other versions62 projects use a version of this.
Word for word · 0
None found.
Edited · 0
None found.
Wrote their own version · 62
- H-mmer/pentest-agents★ 815same name
- bitwize-music-studio/claude-ai-music-skills★ 668same name
- qbeka/jev-job-search★ 368same name
- thesun4sky/jobstack★ 216same name
- EmeaAppGbb/spec2cloud★ 100same name
- saksham10arora-dotcom/everything-claude-codex★ 96same name
- thiagofinch/mega-brain★ 95same name
- nimadorostkar/Claude-Skills-collection★ 37same name
- junjiezhou1122/ideascientist-claude-code★ 35same name
- wrg32786/aigent-os★ 26same name
52 more not listed
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
The file
We split this skill into the rules it gives an agent
11 rules. 0 are common, 8 are distinctive, and 3 are very specific to this project.
0
Common
Most of the 54 edited versions we read keep these.
8
Distinctive
This author's own choices. Worth a look.
3
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 16
Never write checkpoints inside the repo or a worktree.
- Distinctive: line 21
After each team wave when more waves remain.
- Distinctive: line 22
After every 3rd autopilot batch.
- Distinctive: line 23
Before suggesting a new session for a long conversation.
- Distinctive: line 26
After writing a checkpoint because the session is long, or at a stop the user will continue later:
- Very specific: line 28
If a tool that starts a new session is available (e.g.
- Distinctive: line 43
Write facts in your own words.
- Very specific: line 46
No argument: list checkpoints from <store>/checkpoints/ plus legacy <main>/.claude/orchestrator/checkpoints/*.md (legacy ones marked …
- Very specific: line 48
No checkpoints found: say so in one line, search no further, and offer to start the task fresh with orchestrator:on.
- Distinctive: line 49
Verify cheaply: current branch matches, git log --oneline -5, git status --porcelain.
- Distinctive: line 52
If git contradicts the checkpoint, report the mismatch in max 3 lines and ask.
“Common” is measured: kept by at least 6 in 10 of the 54 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Checkpoints: continue in a new session
Arguments: $ARGUMENTS
<store> is defined in the learn skill (per-project folder under ~/.claude/orchestrator/, same from every git worktree, outside the repo). Use the session-start Orchestrator store: and Checkpoints: lines when present; run the Store command only if they are missing. Every write or delete goes to orchestrator:haiku-coder (TYPE: CREATE, or TYPE: RUN for a delete) with the absolute <store> path.
Location
<store>/checkpoints/<slug>.md, slug = kebab-case task name, max 5 words.- One file per task, overwritten each time. No history.
- Never write checkpoints inside the repo or a worktree.
- Legacy checkpoints are also read (
legacy.mdin theorchestrator:learnfolder; only if legacy files exist); new ones always go to<store>.
When to write
- At every stop that is not DONE: BLOCKED, DECISION NEEDED, BUDGET, cap or batch limit reached.
- After each team wave when more waves remain.
- After every 3rd autopilot batch.
- Before suggesting a new session for a long conversation.
Hand-off to a new session
After writing a checkpoint because the session is long, or at a stop the user will continue later:
- Summary, max 5 lines: task, what is done (PASS items, commit, PR), what is open, next step.
- If a tool that starts a new session is available (e.g. the desktop app's
start_session), offer it right away as a card the user starts (fresh context, short title, prompt/orchestrator:resume <slug>); never start it yourself. - Otherwise print
/orchestrator:resume <slug>in its own code block, to run in a new session. - Task DONE (no checkpoint): no card; at most suggest a new session in one line.
Content (max 40 lines)
- Task: one line.
- Mode: on / team / autopilot, with its arguments (caps, commit=batch, budget=
<N>k, spent<X>k). - Branch and last verified commit (or a
git diff --statsummary). - PRD: path under docs/prd, or a summary of at most 10 lines.
- Plan table: lane or batch -> files -> PASS / BLOCKED / TODO.
- Caps used vs allowed.
- Open decisions or blockers.
- Next step: exact and actionable.
- Lessons used: names only.
- Updated: date.
- Write facts in your own words. Never include secrets.
Reading (/orchestrator:resume)
- No argument: list checkpoints from
<store>/checkpoints/plus legacy<main>/.claude/orchestrator/checkpoints/*.md(legacy ones marked "(legacy)"): name, task, updated. Load the only or most recent one if unambiguous, else ask which. - With an argument: load the checkpoint with that name; if none matches, treat the argument as keywords and match them against each checkpoint's
Task:line (load a single match, else list the candidates and ask). - No checkpoints found: say so in one line, search no further, and offer to start the task fresh with
orchestrator:on. - Verify cheaply: current branch matches,
git log --oneline -5,git status --porcelain. Thengit fetch -qandgit log --oneline <recorded base or last verified commit>..origin/<main branch>: if new commits there touch files the checkpoint names (git diff --stat <that commit> origin/<main branch>), say in max 3 lines which plan items may already be done, and ask before continuing. - Trust PASS items unless git contradicts them.
- Do not re-plan and do not re-read the project. Continue at Next step. If the recorded mode is team or autopilot, those modes are user-invoked only: do not continue in that mode; tell the user in one line to run
/orchestrator:team ...or/orchestrator:autopilot ...with the remaining task and caps from the checkpoint. Otherwise continue inon. - If git contradicts the checkpoint, report the mismatch in max 3 lines and ask.
Finishing
- When the task reaches DONE, delete only its checkpoint in
<store>withrm "<absolute path>"(RUN may delete only the file named in the brief): as a step in the samehaiku-coderbrief as the final COMMIT, if one is due, else a loneTYPE: RUN. Say so in the report line. - A finished legacy checkpoint: tell the user its path; never delete it yourself.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

