agent-failure-recovery

What problem does it solve?

This Skill helps recover from failed, interrupted, or partially completed agent runs that leave a repository in a broken or confusing git state, while preserving all potentially useful work first.

Core Features & Use Cases

• Read-only diagnosis first: Inspect git status, operation markers, stash, log, and reflog before making any changes.
• Preserve before recovery: Create rescue branches or stashes, including untracked files, so nothing valuable is lost.
• Minimal, reversible recovery: Use the safest fix for interrupted rebases, conflicted trees, wrong commits, broken branches, or permission-blocked operations.
• Verification and reporting: Confirm the repository is in the intended end state and report exactly where preserved work lives.
• Use case: An agent crashes during a rebase and the tree is left conflicted; this Skill restores order without discarding untracked notes or partial work.

Quick Start

Use the agent-failure-recovery skill to inspect the current git state, preserve anything uncommitted or untracked, and safely recover the repository without losing work.