skills.rest
alexgarzao
alexgarzaoCOMMUNITY
Explore all skills by this author →
GitHub

optimus-resume

Reattach to an in-progress task worktree and report live status.

Updated Apr 2, 2026
Search Tags:#workflow#worktree#resume#task#state.json#optimus
One-click install
npx skills add https://github.com/alexgarzao/optimus --skill optimus-resume
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: optimus-resume
Source: https://github.com/alexgarzao/optimus/tree/main/resume/skills/optimus-resume
Command: npx skills add https://github.com/alexgarzao/optimus --skill optimus-resume

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Resuming work after a terminal is closed or session interrupted, locating the correct task workspace, reporting live status, and offering to proceed to the next stage without unintended state changes.

Core Features & Use Cases

  • Locate and reattach to an in-progress task by resolving the appropriate worktree and task metadata.
  • Read current status, branch, and pending actions, then present safe next-step options without mutating state unless the user explicitly chooses a reset flow.
  • Handle edge cases such as missing worktrees or inconsistent state by auto-recovering or guiding recovery steps with explicit user confirmation.

Quick Start

Run /optimus-resume to reattach to an in-progress task and continue to the recommended next step.

Frequently Asked Questions about optimus-resume

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

FAQPage Schema
How do I resume a task in a worktree after accidentally closing the terminal?▼

You can resume work after terminal closure by running the resume command to automatically locate the task worktree, validate state.json, and present safe next-step options without unintended state changes.

What happens if my task worktree is missing or has an inconsistent state.json when I try to resume?▼

If the worktree is missing or state.json is inconsistent, the resume process auto-recovers or guides you through explicit recovery steps with user confirmation to restore task state and branch readiness.

Can I pick up multiple administrative workflows where I left off across different tasks?▼

Yes, you can pick up multiple administrative workflows where you left off by locating the correct task worktree and reading current status and pending actions to safely continue each task.

Does resuming a task mutate the state.json file automatically?▼

No, resuming a task does not mutate state.json automatically. It reads current status and presents safe next-step options, only changing state if you explicitly choose a reset flow.

What is the best way to reattach to an in-progress task and continue to the recommended next step?▼

The best way to reattach to an in-progress task is to run the resume command, which validates task existence and branch readiness, then offers to proceed to the recommended next stage without unintended state changes.

Related Skills

Explore More Software Engineering Skills→
samjonestersamjonester
5

mozart-wtp-new-worktree

Create or resume a Mozart development worktree via WTP checkout flow.

Community
Intermediate
october-academyoctober-academy
1

retro

Conduct retrospectives on product or experiment loops and update state files.

Official
Advanced
codysumpter-cloudcodysumpter-cloud
2

sovereign-state-snapshot

Create timestamped state snapshots for rollback and safe experimentation.

Community
Advanced
elithrarelithrar
190

summarize-work

Analyze session history and git state to generate structured commit-message summaries.

Community
Basic