smart-resume

Read STATUS.md, todo.md, and plans to propose the next action.

16|3|Updated Mar 15, 2026
One-click install
npx skills add https://github.com/YehudaFrankel/clankbrain --skill smart-resume
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: smart-resume
Source: https://github.com/YehudaFrankel/clankbrain/tree/main/.claude/skills/smart-resume
Command: npx skills add https://github.com/YehudaFrankel/clankbrain --skill smart-resume

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Reads recent work context — STATUS.md, todo.md, and recent memory — to infer what's in progress and propose the single most useful next action. It can execute the action to help you resume work after a break.

Core Features & Use Cases

  • Read: simultaneously read STATUS.md, todo.md, and plans to capture current state.
  • Inference: identify in-progress work and rank next steps by specificity.
  • Execute: propose and optionally execute the next action on confirmation, updating STATUS.md and todo.md.

Quick Start

Ask it to run smart-resume to infer the next action from STATUS.md, todo.md, and plans.

Frequently Asked Questions about smart-resume

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

FAQPage Schema
How do I resume work instantly after a development session break?▼

To resume work instantly, smart-resume reads STATUS.md, todo.md, and plans to infer in-progress tasks, ranks next steps by specificity, and proposes the single most useful action to execute upon confirmation, bridging session gaps.

How does context-reading infer the next action from todo.md and STATUS.md?▼

Context-reading works by simultaneously parsing STATUS.md, todo.md, and plans to capture current state, then identifying in-progress work and ranking next steps by specificity to propose the most useful action.

Do I need a todo.md or STATUS.md file to use smart-resume?▼

Yes, you need STATUS.md, todo.md, and plan files in your workspace. smart-resume reads these files to infer current in-progress tasks, update your status after changes, and bridge development session gaps.

What's the best way to automatically update STATUS.md and todo.md after task execution?▼

The best way to automatically update STATUS.md and todo.md is using smart-resume, which proposes an action, executes it on user confirmation, and deterministically updates both files to reflect the completed work.

Why does smart-resume propose only a single next action instead of multiple options?▼

smart-resume proposes a single next action because it implements a deterministic ranking flow that evaluates task specificity from your plans and todo.md, ensuring you resume work with the most useful step rather than choosing from multiple options.

Can I use smart-resume for planning across multiple development sessions?▼

Yes, you can use smart-resume across development sessions. It reads recent work context and open plans to bridge session gaps, addressing in-progress tasks by proposing and executing the next action after user confirmation.