Create or update continuity ledger for state preservation across clears
Note: This skill is now an alias for
/create_handoff. Both output the same YAML format.
Create a YAML handoff document for state preservation across /clear. This is the same as /create_handoff.
First, determine the session name from existing handoffs:
ls -td thoughts/shared/handoffs/*/ 2>/dev/null | head -1 | xargs basename
This returns the most recently modified handoff folder name (e.g., open-source-release). Use this as the handoff folder name.
If no handoffs exist, use general as the folder name.
Create your file under: thoughts/shared/handoffs/{session-name}/YYYY-MM-DD_HH-MM_description.yaml, where:
{session-name} is from existing handoffs (e.g., open-source-release) or general if none existYYYY-MM-DD is today's dateHH-MM is the current time in 24-hour format (no seconds needed)description is a brief kebab-case descriptionExamples:
thoughts/shared/handoffs/open-source-release/2026-01-08_16-30_memory-system-fix.yamlthoughts/shared/handoffs/general/2026-01-08_16-30_bug-investigation.yamlCRITICAL: Use EXACTLY this YAML format. Do NOT deviate or use alternative field names.
The goal: and now: fields are shown in the statusline - they MUST be named exactly this.
---