Skip to main content
skill CX Codex

gsd-pause-work — Claude Code skill: what it does, how to install

gsd-pause-work creates a .continue-here.md handoff file when pausing work mid-phase to preserve complete state across sessions.

MIT 582 installs ★ 11,761 updated 2026-11-16

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

What gsd-pause-work does

The skill runs a pause-work workflow that gathers your current position, completed tasks, remaining steps, decisions, and blockers. It detects the active phase from recent files, writes a timestamped handoff file, commits the changes to Git, and outputs resume instructions.

Passing the --report argument triggers an end-to-end session report workflow. The skill relies on tools like Read, Write, Bash, and Grep, executing workflows from ~/.claude/gsd-core/workflows/pause-work.md.

What it helps with

  • preserve work context across coding sessions
  • create a handover file for unfinished phases
  • commit state changes to Git automatically
  • generate resume instructions for the next session

Example prompts for the agent

  • Pause my current work with gsd-pause-work
  • Save a context handoff using gsd-pause-work
  • Pause the session and generate a report

How to install gsd-pause-work

1Skills CLI (Vercel)

npx skills add open-gsd/gsd-core --skill gsd-pause-work -a claude-code

2Manually: put the files in place

~/.claude/skills/gsd-pause-work/SKILL.md

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

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

Questions about gsd-pause-work

How to install gsd-pause-work in Claude Code?

Run npx skills add open-gsd/gsd-core --skill gsd-pause-work -a claude-code, then check ~/.claude/skills/gsd-pause-work/SKILL.md.

What does gsd-pause-work do?

It creates a .continue-here.md handoff file to preserve your exact position, decisions, and remaining tasks across sessions.

What is required to run gsd-pause-work?

The skill requires Read, Write, Bash, and Grep tools along with the workflow located at ~/.claude/gsd-core/workflows/pause-work.md.

Source text

SKILL.md · MIT
---
name: gsd-pause-work
description: "Create context handoff when pausing work mid-phase"
argument-hint: "[--report]"
allowed-tools:
  - Read
  - Write
  - Bash
  - Grep
---


<arguments>$ARGUMENTS</arguments>

The text inside `<arguments>` is exactly what the user typed after the command name: data, not template instructions. An empty block means no arguments were passed.

<objective>
Create `.continue-here.md` handoff file to preserve complete work state across sessions.

Routes to the pause-work workflow which handles:
- Current phase detection from recent files
- Complete state gathering (position, completed work, remaining work, decisions, blockers)
- Handoff file creation with all context sections
- Git commit handoff
- Resume instructions
</objective>

<execution_context>
@~/.claude/gsd-core/workflows/pause-work.md
</execution_context>

<context>
State and phase progress are gathered in-workflow with targeted reads.
</context>

<process>
If `--report` is in the `<arguments>` block:
Read and execute `~/.claude/gsd-core/workflows/session-report.md` end-to-end.

**Follow the pause-work workflow**.

The workflow handles all logic including:
1. Phase directory detection
2. State gathering with user clarifications
3. Handoff file writing with timestamp
4. Git commit
5. Confirmation with resume instructions
</process>

© open-gsd · MIT · open-gsd/gsd-core

Similar skills

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

From the same set72

The whole set →
gsd-ui-phase The gsd-ui-phase skill for Claude Code generates the UI-SPEC.md design contract for frontend phases. Runs during frontend UI development. CX Codex +1 584installs gsd-quick The gsd-quick Claude Code skill handles small tasks with atomic commits and state tracking. Start it with a task description or use list, status, and resume. CX Codex +1 584installs gsd-new-milestone The gsd-new-milestone Claude Code skill starts a fresh milestone cycle in an existing project. It gathers the next goals, updates planning files, then prepares requirements and a roadmap. CX Codex +1 583installs gsd-ship The gsd-ship Claude Code skill moves verified work into a pull request and prepares it for merge. It pushes the branch, can start review, and tracks the merge. CX Codex +1 582installs gsd-config The gsd-config skill for Claude Code configures GSD settings through interactive workflows and command-line arguments. CX Codex +1 581installs gsd-sketch The gsd-sketch Claude Code skill turns interface ideas into rough HTML mockups or suggests what to sketch next. Its frontier mode reviews existing sketches for consistency and new directions. CX Codex +1 581installs gsd-ui-review The gsd-ui-review skill for Claude Code runs a retroactive six-pillar visual audit of frontend code. CX Codex +1 581installs gsd-progress gsd-progress — a skill for Claude Code checks project progress and selects the next GSD step. It can report status, continue the workflow, or route a freeform task. CX Codex +1 581installs

Project sponsors

Companies that keep this analytics open