Install Pause And Resume
Pick your agent. Every command is ready to paste.
npx skills add dongshuyan/compass-skills --skill pause-and-resumeThe open skills CLI detects your agents (Claude Code, Cursor, Codex and 70+ more) and installs to the right folder. Add -g to install globally.
01
Install it
Run the command above, or upload the folder in Claude.
02
Ask naturally
Describe the task. Your agent loads pause-and-resume when the request matches its description.
03
Name it if needed
If it does not trigger, say “use the pause-and-resume skill”. In Codex, type $pause-and-resume.
Pause and Resume
Keep this workflow in the current session. Store its state in the pause response; do not create files, commits, or new tasks solely to checkpoint it.
Pause
- Stop expanding the task. Do not begin another subtask, retry, or optional check.
- Let an already-started atomic action finish only when interruption would leave inconsistent state. Otherwise stop at the nearest safe boundary. Use only the smallest necessary read-only check or already-authorized cleanup to record an accurate, safe state.
- Preserve facts, not guesses. Distinguish completed, in progress, blocked, and unknown work. Record exact non-sensitive paths, parameters, job IDs, and receipts when they are needed to continue. Never expose secrets.
- If work continues independently, record its handle, observed status, and how to reconcile it. Do not cancel, restart, or dispatch it again merely to pause.
- End the turn with the compact checkpoint below, in the user's language. Keep the marker exact, omit irrelevant detail, and state explicitly when there is no known non-repeatable effect.
PAUSE_CHECKPOINT: ACTIVE
- Goal and done condition:
- Completed:
- Current stopping point:
- Remaining work:
- First action on resume:
- Do not repeat:
- Constraints and settled decisions:
- Live state, running work, and facts to recheck:
Finish with the equivalent of: Paused. When you return, say "continue". Then
stop. Do not perform the first resume action in the pause turn.
If there is no unfinished task, say so and stop without emitting an active checkpoint.
Resume
When the user later asks to continue the paused work:
- Use the newest unconsumed
PAUSE_CHECKPOINT: ACTIVEin this session. A checkpoint is consumed once substantive work has resumed from it. If none exists, interpret the request from the immediate conversation normally. - Apply later user instructions over the checkpoint. Recheck only mutable or high-risk state that could have changed while paused, especially files, worktree state, running jobs, and external side effects.
- Reconcile recorded in-flight work before starting replacements. Never repeat
an item under
Do not repeatunless current evidence proves it did not occur and repeating it is authorized. - Resume directly from
First action on resume, then continue the recorded remaining work. Do not ask the user to restate known context or produce a new plan unless material drift makes a decision necessary.
This workflow cannot recover a killed process, missing conversation, or a different session; use a handoff or persistent checkpoint workflow for those cases.
Tips for Pause And Resume
- • Start a fresh session after installing so your agent picks up the new skill.
- • It is part of a pack with 11 skills. Install only the ones you need with --skill to keep triggers precise.
- • If two skills overlap, mention the one you want by name.
Questions about Pause And Resume
What does the Pause And Resume skill do?
Cooperatively pause unfinished work in the current session, leave a precise continuation checkpoint, and resume from it when the user later says continue. Use only when the user explicitly requests this pause workflow. Do not use for crashes, app shutdown, new-session handoffs, or ordinary task summaries.
How do I install Pause And Resume?
Run "npx skills add dongshuyan/compass-skills --skill pause-and-resume" in your project. The skills CLI installs it for Claude Code, Cursor, Codex and 70+ other agents. In Claude on the web, upload the skill folder as a ZIP under Customize > Skills.
Does Pause And Resume work in Cursor and Codex?
Yes. Pause And Resume uses the open SKILL.md format, so it works in Claude Code, Claude, Cursor, OpenAI Codex, Gemini CLI, GitHub Copilot and other agents that support agent skills.
Is Pause And Resume free?
Pause And Resume is open source on GitHub under the MIT license. It is free to install; check the license before commercial use.
Who made Pause And Resume?
Pause And Resume is published by dongshuyan in the dongshuyan/compass-skills repository, together with 10 other skills.


