ocoyladev

Resumable Work — Communication skill for Claude Code

Communication community

Agent skill for cross-session continuity: the repo and .agent-state/ replace chat history, so a new Claude Code / Codex / Cursor session resumes long features from Git and files alone.

How to install Resumable Work

This entry records only its repository, not the path inside it, so there is no exact command to give. Open ocoyladev/resumable-work and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What Resumable Work does

Agent skill for cross-session continuity: the repo and .agent-state/ replace chat history, so a new Claude Code / Codex / Cursor session resumes long features from Git and files alone. Zero-dependency Python CLI.

Alternatives in Communication

Pregunta Cualquier Cosa Sobre El Código — /understand-chat How does the payment flow work 8.2k ★
Agent Kit — Give Claude/Cursor email powers 631 ★
Agentrove — A self-hosted web and macOS desktop app for Claude Code and Codex, powered by ACP 270 ★

README

resumable-work

An agent skill that makes chat history unnecessary for continuing long-running feature work.

The repository and a `.agent-state/` directory are the durable source of truth. Progress is persisted **while the work happens**, not as an end-of-session handoff, so a new Claude Code, Codex, Cursor or other Agent Skills–compatible session can resume from Git and files alone after a session limit, a token limit, or a machine change.

Written to the [Agent Skills](https://agentskills.io) standard. The CLI is a single 1,176-line Python file using only the standard library and Git — no dependencies, no services, no API keys.

Why

Long features die at session boundaries. The usual fix is a handoff document written at the end of a session, which is exactly when context is about to be lost and the summary is least reliable. This skill inverts that: state is written as each task starts, checkpoints, and completes, so an interrupted session leaves a correct record rather than a missing one.

Two rules keep the record honest:

A feature imported from before the skill was installed is reconstructed from Git evidence, never from invented history.
Checkpoints record a worktree fingerprint, so work done after the last checkpoint is detected on recovery instead of being silently assumed complete.

Install

Copy this directory into your agent's skills folder:

git clone https://github.com/ocoyladev/resumable-work.git
cp -r resumable-work ~/.claude/skills/      # Claude Code
cp -r resumable-work ~/.cursor/skills/      # Cursor

The agent loads `SKILL.md` and calls `scripts/continuity.py` from the skill root. The script is never copied into the projects it tracks.

Use

python /scripts/continuity.py init            # initialize .agent-state in a Git repo
python /scripts/continuity.py recover          # minimal recovery context at session start
python /scripts/continuity.py status           # print C