pause-task

Pause in-progress repository tasks and write a PCC resume capsule.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/hollis-labs/volon --skill pause-task
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: pause-task
Source: https://github.com/hollis-labs/volon/tree/main/plugins/core/skills/pause-task
Command: npx skills add https://github.com/hollis-labs/volon --skill pause-task

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill provides a deterministic way to pause in-progress development tasks, persist essential context, and produce a compact resume capsule so agents or humans can restart work without lost state or confusion.

Core Features & Use Cases

  • Selects the active task: Prefers the most recently updated task with status: doing, or the highest-priority doing/paused/blocked task.
  • Persists task state and evidence: Updates the task file status and appends a timestamped Updates entry with mode, note, and git evidence.
  • Writes a Task PCC capsule: Overwrites .volon/pcc/tasks/<task_id>.md with commit, paused_at, confidence, goal, acceptance criteria, plan, diff stat, commands run, next actions, and blockers (cap 400 words).
  • Updates bootstrap and logs: Sets paused_task_id, paused_at, and resume_hint in .volon/bootstrap.md and optionally appends a pause entry to run logs.
  • Use case: Pause during a long-running refactor or investigation so another session or collaborator can resume reliably with precise next actions.

Quick Start

Use the pause-task skill in soft mode with an optional note to persist the current task state and generate a resume capsule.

Frequently Asked Questions about pause-task

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I pause an in-progress git task without losing my current work context?

To pause an in-progress git task without losing context, you need to capture the current task state, record git commit evidence and recent commands, and generate a compact resume capsule for the next session.

What is a PCC capsule and how does it help resume paused development tasks?

A PCC capsule is a compact markdown file that stores paused task state by recording the commit hash, diff stat, recent commands, and next actions so an agent or human can resume work deterministically.

How do I hand off a paused task to another session or collaborator?

Hand off a paused task by writing a resume capsule with goal, acceptance criteria, plan, and next actions, then updating the bootstrap configuration with a resume hint and paused task ID.

Does pausing a repository task require a specific branch or worktree setup?

Pausing a repository task applies to workflows using specific task markdown files and requires git commit evidence to safely handle branch or worktree handoffs during context compaction.

What information is captured when I pause work on a development task?

Pausing work captures the task status, timestamped updates, git commit hash, diff stat, commands run, confidence level, blockers, and planned next actions in a capped resume capsule.

Can I append a custom note when pausing a git task for later context?

Yes, you can use soft mode with an optional note to persist the current task state, which is appended as a timestamped update entry alongside the git diff evidence in the resume capsule.