crash-recovery

Reconstruct session context from git state, issue tracker data, and user memory.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/spm1001/claude-config-public --skill crash-recovery
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: crash-recovery
Source: https://github.com/spm1001/claude-config-public/tree/main/skills/crash-recovery
Command: npx skills add https://github.com/spm1001/claude-config-public --skill crash-recovery

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

When a session crashes or context limits exhaust memory, reconstruct context by combining git state, issue tracker data, and user memory to resume work quickly.

Core Features & Use Cases

  • Two recovery paths: Crash Recovery (history lost) and Context-Limit Recovery.
  • Artifact integration: Use git, issue tracker (.beads), and user memory to rebuild context.
  • Use Case: You lost conversation history but still have local changes and issue notes; reconstruct to continue.

Quick Start

  • Inspect repository state: git status git log -1 --stat git diff
  • Check issue tracker (bd) if available: bd ready bd list --status in_progress bd show <issue-id>
  • Ask user for missing context
  • Reconstruct a concise summary and proceed

Frequently Asked Questions about crash-recovery

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

FAQPage Schema
How do I rebuild my work context after a session crash?

Rebuild context by inspecting git status and recent commits, checking issue tracker data in .beads files, and asking for missing details. Git state, issue notes, and user memory combine to recreate a resumable plan quickly.

What should I check first when restarting after losing conversation history?

Start by running git status and git log to see uncommitted changes and recent work, then check bd list to review in-progress issues. These artifacts preserve enough state to reconstruct your session without full history.

Can I recover work when my context limit is exhausted?

Yes. Context-limit recovery uses the same approach as crash recovery: inspect git diff for pending changes, review .beads issue data for design decisions and progress notes, then synthesize a coherent resumable plan.

How do git state and issue tracker data help after a crash?

Git shows uncommitted changes and commit history; issue tracker (.beads) stores design notes, resolution status, and lab-notebook fields. Together they provide enough technical context to identify what was being worked on and resume without guessing.

What if I don't remember the details of what I was doing?

The Skill solicits user input when needed. You describe what you recall, and it synthesizes that memory with git state and issue data to fill gaps and produce a summary with identified missing context.

Does this work with existing git workflows?

Yes. Recovery integrates with standard git commands and issue tracker formats (.beads). No workflow changes required; it reconstructs context from artifacts you already maintain.