skills.rest
GongYuanCaiJi
GongYuanCaiJiCOMMUNITY
Explore all skills by this author →
GitHub

skill-resume

Restores prior session context from persistent workflow state files after context resets.

Updated Aug 15, 2026
Search Tags:#resume#project continuity#compaction#workflow state#context recovery#session restore
One-click install
npx skills add https://github.com/GongYuanCaiJi/dsh-claude-octopus --skill skill-resume-gongyuancaiji
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: skill-resume
Source: https://github.com/GongYuanCaiJi/dsh-claude-octopus/tree/main/.claude/skills/skill-resume
Command: npx skills add https://github.com/GongYuanCaiJi/dsh-claude-octopus --skill skill-resume-gongyuancaiji

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? After a context reset, compaction, or a new conversation, you lose track of where a project left off. This Skill reloads the persistent workflow state so you can continue exactly where you stopped without re-discovering prior progress. ## Core Features & Use Cases - State Detection: Checks for the .octo/ directory and the .octo-continue.md handoff file written by PreCompact and SessionEnd hooks. - Adaptive Context Loading: Uses octo-state.sh get_context_tier auto to load the right context tier (planning vs. execution) based on current workflow status. - Intelligent Routing: Maps workflow status (in_progress, blocked, paused, complete, etc.) to the correct next command such as /octo:issues, /octo:develop, or /octo:ship. - Use Case: You return to a project the next day and type "resume" — the Skill displays the project title, last active timestamp, current phase, recent history, blockers, and a suggested next action. ## Quick Start Say "resume" or "pick up where I left off" to restore your previous session state and continue the workflow.

Frequently Asked Questions about skill-resume

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

FAQPage Schema
How do I resume a previous session after context was cleared?▼

Say "resume", "continue", or "pick up where I left off". The Skill checks for the .octo-continue.md handoff file and the .octo/ state directory, loads the appropriate context tier, and displays a restoration summary with your last position.

What happens if no previous session state exists?▼

If neither the .octo/ directory nor the .octo-continue.md handoff file exists, the Skill reports that no project state was found and suggests starting a new project with /octo:embrace instead of failing silently.

Does session resume work after context compaction?▼

Yes. State persists in files such as STATE.md, PROJECT.md, and phase outputs, which survive compaction. The Skill detects context loss via the octopus state-path resolution and reloads from persistent state automatically.

What information does the restoration summary show?▼

The summary shows the project title, last active timestamp, current phase and position, workflow status, the last three history entries from STATE.md, any current blockers, and a suggested next action based on the status.

When should I not use session resume?▼

Do not use it to start a brand-new project (use /octo:embrace), to check only current status (use /octo:status), or to modify state directly (use octo-state.sh). It is specifically for restoring full working context.

Related Skills

Explore More Software Engineering Skills→
dobrinz123dobrinz123

gsd-pause-work

Create .continue-here.md handoff files and commit WIP with resume instructions.

Community
Intermediate
summarybotngsummarybotng
2

sparc-methodology

Orchestrate software development through SPARC phases with multi-agent coordination and TDD.

Official
Advanced
ramonclaudioramonclaudio
4

start

Hydrate session context and organize tasks for handoff.

Community
Basic
PromakerDevPromakerDev

start-app

Start a stopped Dokploy app via the manage-app workflow.

Official
Intermediate