Skip to content

k45sle/Claude-auto-pause / skills/writing-handoffs

writing-handoffs

Verified

Writes a compact handoff document and a ready-to-paste resume prompt that let a fresh Claude Code session resume the current task without the old conversation. Use when an AUTO-PAUSE notice says the usage-limit pause threshold was reached or asks for a context handoff, or when the user asks to write a handoff, wrap up for a new session, save progress before the usage limit, pause here, or hand off to a fresh session. Do not use for summarizing finished work, changelogs, commit messages, or PR descriptions.

FileKindSize
SKILL.mdskill md7.2 KB
references/example.mdmarkdown2.1 KB
references/fallback.mdmarkdown1.2 KB
scripts/facts.shexecutablescript3.4 KB

references/example.md

View on GitHub
# Example handoff

````markdown
# Handoff: rate-limit retry in API client

Paused 2026-10-19 15:02 · 5h 94% used, resets 17:00 · reason: AUTO-PAUSE

Next session: Sonnet - high. The retry wrapper is designed; what is left is coding it and its tests.

Resume prompt (paste into a new Code session):

```text
Resume paused work in /Users/sam/code/billing.
Read /Users/sam/code/billing/.handoffs/2026-10-19T1502-api-retry.md first. It is your only context from the previous session.
Check that `git status` and HEAD match its "Repo state" section (if not, tell the user before editing). Run the commands under "Verify" and each "check with" command under "Outside operations", and tell the user if a result differs from the recorded one, then start with Next step 1.
Read only the files it points to unless you need more, and ask the user before doing anything outside its Goal.
If the user tells you something in this session that differs from the handoff, follow the user.
```

## Goal
"Retry 429s with backoff in the API client" · Done when: `npm test` passes and client.ts retries 429 up to 3 times.

## Status
- Done: backoff helper in src/retry.ts with tests (pass).
- In progress: src/client.ts `request()` wraps fetch in `withRetry` (client.ts:41); `stream()` not wrapped yet.
- Not started: honoring the Retry-After header.
- Last request: partly; `stream()` and Retry-After are left.

## Next steps
1. In src/client.ts `stream()` (line 88), wrap the fetch call in `withRetry` like `request()` does at line 41.
2. Parse Retry-After in src/retry.ts `nextDelay()`; prefer it over the computed backoff.
3. Run `npm test`.

## Decisions (don't relitigate)
- No retry on 5xx: the user wants 5xx to surface immediately.

## Don't undo
- `withRetry` rethrows AbortError without retrying (src/retry.ts:17): a cancelled request must stay cancelled.

## Dead ends
- Tried p-retry; dropped because it cannot read response headers.

## Verify
- `npm test`: 41 passed, 0 failed (before the stream() change).

## Repo state
main · a1b2c3d Add retry helper · uncommitted: M src/client.ts · stashes: 0 · background processes: none
````
reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis.Stars: 471kUpdated Claude CodeCodexVerifiedInstall
diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness.Stars: 322kUpdated Claude CodeCodexVerifiedInstall
dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependenciesStars: 322kUpdated Claude CodeCodexVerifiedInstall
executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is availableStars: 322kUpdated Claude CodeCodexVerifiedInstall