.claude/skills/break-session/SKILL.md
Save mid-session state before a break. Use when the user says "/break", "taking a break", "let's take a break", "back in a bit", "stepping away", "pausing", or similar.
npx skillsauth add sebjacobs/dotfiles break-sessionInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
Quick checkpoint before stepping away. Captures current state, commits any dirty work, cancels the session timer.
Run date to get the current time.
Determine the project name and branch:
basename "$(git rev-parse --show-toplevel)"
git rev-parse --abbrev-ref HEAD
Summarise current progress in a few bullet points, then write it:
jotter write \
--project <project> \
--branch <branch> \
--type break \
--content "<what's been done, current state, anything half-finished>" \
--next "<what to pick up on return>"
git status
git diff --stat
If there are uncommitted changes worth saving, propose a grouping to the user and commit after approval. Don't leave half-done work uncommitted across a break.
If a session cron timer is running, cancel it with CronDelete <job-id>. /start will set a fresh one on return.
"Break saved. Run
/startwhen you're back."
development
Run the session start routine — ask about available time and hard stops, read recent session logs and ROADMAP.md priorities, propose a realistic goal. Use when the user says "/start", "/start-session", "let's start", "start session", "begin session", or at the start of any longer session. Skip for quick focused tasks where the goal is already clear.
development
Mid-session checkpoint — snapshot current decisions and progress without archiving or cleaning up. Use when the user says "/save", "checkpoint", "save progress", or before risky operations like schema migrations, large refactors, or long-running tasks.
tools
Recover context from a crashed or unfinished session by reading the most recent JSONL transcript. Use when the user says "/recover", "recover session", "what was I doing", or when /start detects the last entry isn't a finish.
testing
TDD ping-pong pairing mode — collaborative spec, alternating test-write and implement roles