Now liveThe Skillselion MCP - thousands of ranked skills, loaded into your agent mid-task. No install.Get it →
aesirsystems avatar

Restore Context

  • 1 installs
  • Updated February 19, 2026
  • aesirsystems/claude-breadcrumbs

restore-context is a Claude Code skill that restores an agent's full working context after a compaction by reading recovery files, syncing beads state, and verifying git.

About

restore-context is a Claude Code skill that rebuilds an agent's working context after a session compaction or a new session start. It reads .beads recovery files, syncs beads task state, checks git status, and prints a structured summary of the current epic and available work. A developer runs it at the top of a resumed session so the agent knows what it was doing before continuing.

  • Restores full working context after a compaction or a fresh session
  • Reads .beads recovery files, syncs beads state, and verifies git status
  • Presents a structured summary then waits for the user to pick a task

Restore Context by the numbers

  • 1 all-time installs (skills.sh)
  • Ranked #14,102 of 16,546 AI & Agent Building skills by installs in the Skillselion catalog
  • Data as of Jul 7, 2026 (Skillselion catalog sync)
At a glance

restore-context capabilities & compatibility

Capabilities
context restoration · session recovery · task tracking
Works with
github
Use cases
memory · planning
From the docs

What restore-context says it does

Restore full context after compaction or starting a new session. Reads recovery files, syncs beads state, verifies git state, and presents summary with available work.
SKILL.md
You are returning after compaction or time away. Follow this process to restore COMPLETE context.
SKILL.md
npx skills add https://github.com/aesirsystems/claude-breadcrumbs --skill restore-context

Add your badge

Show developers this skill is listed on Skillselion. Paste this into your README.

Listed on Skillselion
Installs1
Last updatedFebruary 19, 2026
Repositoryaesirsystems/claude-breadcrumbs

What it does

Restore an agent's full project context after compaction so work can resume without re-explaining state.

When should I use this skill?

You are returning to a project after a compaction or time away and need to rebuild full context before continuing.

What you get

A structured context summary showing the current epic, last session's work, available tasks, and git state.

  • Structured context-restored summary with epic, available work, and git state

By the numbers

  • 4-step restore process (recovery prompt, recovery file, beads sync, git verify)
  • 5-item fallback process when no recovery file exists

Files

SKILL.mdMarkdownGitHub ↗

Restore Context

You are returning after compaction or time away. Follow this process to restore COMPLETE context.

---

Step 0: Read Recovery Prompt (Quick Start)

if [ -f .beads/recovery-prompt.md ]; then
  cat .beads/recovery-prompt.md
  echo ""
  echo "--- Recovery prompt found. Reading full context next... ---"
else
  echo "No recovery prompt found. Will read recovery context directly."
fi

---

Step 1: Read Recovery File

cat .beads/recovery-context.md 2>/dev/null || cat recovery-context.md 2>/dev/null || echo "No recovery file found"

Absorb:

  • Current epic and success criteria
  • Scope guard rails
  • Key decisions and why
  • Current challenges
  • Exact state of in-progress work

---

Step 2: Sync and Review Beads

bd sync --from-main 2>/dev/null || true
bd ready
bd list --status open

If beads is not available, skip this step.

---

Step 3: Verify Git State

git status
git log --oneline -5
git branch --show-current

If not in a git repo, skip this step.

---

Step 4: Present Summary and Get Direction

Show the user:

## Context Restored

### Current Epic
**[Epic name]**
- Goal: [brief description]
- Success: [1-2 key criteria]

### Last Session Completed
- [Major accomplishment 1]
- [Major accomplishment 2]

### Available Work (bd ready)
1. **[task-id]** - [Title] (P[priority])
2. **[task-id]** - [Title] (P[priority])

### Git State
- Branch: [branch]
- Uncommitted: [X files or clean]

### Scope Reminder
Focus on: [primary goal]
Avoid: [main scope creep risk]

---

**Which task would you like to work on?**

WAIT for user response before starting work.

---

If No Recovery File

Fallback process: 1. Read CLAUDE.md for project overview 2. Read MEMORY.md for architecture patterns 3. Run bd list to see all work 4. Check git log for recent activity 5. Ask user what to work on

Related skills

AI & Agent Buildingagentsautomation

This week in AI coding

Five minutes, every Monday - the tools, releases and tactics for developers.

unsubscribe anytime.