scrolls-compact
Compacting docs/.scrolls/
/scrolls-setup, /scrolls-update, /scrolls-hide/-unhide and /scrolls-remove/-restore manage where the scrolls are. This skill works on when: it condenses the history that has piled up in the scrolls, and keeps the full older text in git at a checkpoint. The checkpoint is the commit just before the compaction. Nothing is copied into a file. COMPACT.md and the compacted/ reports are only an index that leads back to git.
Rule: compaction removes history, never live state. Open [ ] tickets, every GAP_ANALYSIS.md line, and HANDOFF's "Known issues / open threads" stay word for word, whatever their age. WISDOM.md and STARTER.md are never compacted.
Run this only when the user asks for it. Show the plan before changing anything, unless they passed -y/--yes.
Everything is relative to the current working directory unless -t/--reporoot says otherwise, not relative to this skill's own location.
Cross-platform
All of the logic is in one stdlib-only Python file, scripts/compact.py. compact.sh (bash: macOS, Linux, or Windows with Git Bash/WSL) and compact.ps1 (PowerShell 7+) are thin launchers that find Python 3.9+ and pass every flag through unchanged. Pick by what's available: try bash --version, and if that succeeds use .sh. Otherwise use .ps1 via pwsh (preferred), or powershell.exe only if pwsh isn't installed.