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.