Skip to main content
skill CX Codex

pause — Claude Code skill: task state and install

The pause Claude Code skill saves a task’s state when work needs to stop temporarily. The next session offers a way to resume it.

MIT ★ 26 updated 2026-11-16

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add wrg32786/aigent-os --skill pause -a claude-code
Open on GitHub

What pause does

The skill records the task objective, touched files, skills and agents used, verified results, open questions, and blockers. Start it with /pause or /pause waiting on {blocker}.

It identifies whether progress depends on an operator, a sub-agent, a tool, or someone outside the system. Then it writes a Capsule v2 with status: paused, using the /context-capsule schema, and updates state.last_capsule in BODY_STATE.json. Waiting for a sub-agent or an external person sets resumption for the next session; the other cases use a manual trigger.

At the next session boot, the system offers /resume automatically. This workflow uses the Capsule v2 format and BODY_STATE.json.

What it helps with

  • save the objective and state of unfinished work
  • record files and results confirmed during a session
  • note who or what the task is waiting on
  • leave context for resuming work in a later session

Example prompts for the agent

  • Pause this task and save its state for later.
  • Pause the work while I wait for a colleague’s reply.
  • Stop here until the sub-agent finishes.

How to install pause

1Skills CLI (Vercel)

npx skills add wrg32786/aigent-os --skill pause -a claude-code

2Manually: put the files in place

~/.claude/skills/pause/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/pause/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about pause

How do I install pause in Claude Code?

Run npx skills add wrg32786/aigent-os --skill pause -a claude-code. The skill file is at ~/.claude/skills/pause/SKILL.md.

What does pause do?

It saves the current task in a Capsule v2 with status: paused and records how work can resume. The system offers /resume at the next session boot.

How does pause decide when work can resume?

It records whether the task is waiting on an operator, a sub-agent, a tool, or someone external. Sub-agent and external waits resume at the next session boot; the other cases use a manual trigger.

Source text

SKILL.md · MIT
---
name: pause
description: "Pause current work with resumable state. Use when pausing a task or stopping work temporarily before returning to it."
---

# /pause — Pause current work with resumable state

Create a Capsule v2 with `status: paused` capturing full execution state for later resume.

## Trigger

`/pause` or `/pause waiting on {blocker}`

## Flow

1. **Capture state** — gather from current session:
   - Objective (what we were working on)
   - Files touched (from tool call history)
   - Skills and agents used
   - Last verified state (what was confirmed working)
   - Open questions and blockers

2. **Determine waiting_on** — from argument or ask:
   - `will` — needs the operator's decision or input
   - `agent` — waiting on a sub-agent to complete
   - `tool` — waiting on external tool/API/deploy
   - `external` — waiting on someone outside the system (a colleague, a client, etc.)

3. **Set resume_trigger**:
   - `will` → `manual` (the operator decides when to resume)
   - `agent` → `open` (resumes at next session boot, which checks agent status)
   - `tool` → `manual` (check tool status on resume)
   - `external` → `open` (resumes at next session boot, surfacing the wait)

4. **Write capsule** — use `/context-capsule` schema with `status: paused`

5. **Update BODY_STATE.json** — set `state.last_capsule` with paused capsule info

6. **Output**:
   ```
   Paused: {objective}
   Waiting on: {waiting_on}
   Resume trigger: {resume_trigger}
   Next action: {next_valid_action}
   Resume with /resume (offered automatically at next session boot).
   ```

## Related

- `/resume` — pick up paused work
- `/context-capsule` — the underlying capsule system
- [[concepts/Capsule v2 Doctrine]] — design rationale

© wrg32786 · MIT · wrg32786/aigent-os

Similar skills

All skills for Agent setup: memory, context, orchestration →

From the same set58

The whole set →
research-deep The research-deep Claude Code skill combines vault notes, web sources, and GitHub research into a cited briefing with evidence and a recommendation. It runs on requests to investigate a topic or compare sources. CX Codex +1 ★ 26repo stars reconcile This Claude Code skill compares seven days of project attention with stated Tier-1 shares. Run it to reconcile attention or check for priority drift. CX Codex +1 ★ 26repo stars Promote The Promote Claude Code skill turns useful conversation insights into lasting vault notes. It activates when a decision, fact, or idea should remain available after the session. CX Codex +1 ★ 26repo stars port-spec The port-spec Claude Code skill turns a complete written specification into code or a vault artifact. It activates for spec implementation, brief-based builds, and ports from specs. CX Codex +1 ★ 26repo stars orient The orient Claude Code skill points to the project map section relevant to a question about structure, ownership, rules, or next steps. It activates when someone asks where to look or how to proceed. CX Codex +1 ★ 26repo stars operator-setup The operator-setup Claude Code skill interviews a business operator and saves the answers for later sessions. It turns the stated goals and time-consuming work into three tailored next steps. CX Codex +1 ★ 26repo stars open This Claude Code skill loads workspace context and surfaces items that need attention at the start of a session. Running /open checks priorities and recovers unfinished work. CX Codex +1 ★ 26repo stars nightly This Claude Code skill runs a nightly project-state protocol and records its checkpoints. Start the full pass with /nightly-close-parity. CX Codex +1 ★ 26repo stars

Project sponsors

Companies that keep this analytics open