Cache safe stop hook snapshotting
Skill ychampion/cskill-agents/skills/cache-safe-stop-hook-snapshotting
Agent skills for coding CLIs, multi-agent runtimes, context engines, MCP extensions, and terminal tooling. Instead of using claude code's source code, give your agent skills to create your own!
npx -y skills add ychampion/cskill-agents --skill cache-safe-stop-hook-snapshottingAssembled from the repository path, not quoted from the project. Check it against their README if it does not work.
What its author says it does
Copied from the file, not written here
Persist a cache-safe stop-hook context snapshot only for main session queries so later helpers can resume from stable state without fork pollution.
SKILL.md
2.1 KB, as published. Nobody here has run it
SKILL: Cache-Safe Stop-Hook Snapshotting
Domain: context-management
Trigger: Apply when end-of-turn hooks need to persist enough state for follow-up helpers, but background forks must not overwrite the main session snapshot.
Source Pattern: Distilled from reviewed context, compaction, and memory-governance patterns.
Core Method
Build one structured hook context at turn end, then persist a cache-safe snapshot only when the query source belongs to the main interactive session or the SDK control path. This gives downstream helpers a stable resume surface while preventing side agents and background forks from clobbering shared state with their own narrower contexts. The snapshot gate lives outside optional prompt-suggestion features so every consumer that depends on the shared state still gets it.
Key Rules
- Create the snapshot from the full stop-hook context, not ad hoc fragments, so later consumers see the same system, user, and tool state.
- Gate snapshot persistence to the authoritative query sources such as
repl_main_threadandsdk. - Keep forked or background agents out of the shared snapshot path; their contexts are partial and will pollute resume behavior.
- Decouple snapshotting from optional background features so state persistence remains available even when prompt suggestions are off.
Example Application
If a REPL turn finishes and /btw or another side-question helper may run next, save a cache-safe snapshot from the main turn’s hook context. If a background memory extractor reaches the same stop-hook code, skip the snapshot so the main session state remains authoritative.
Anti-Patterns (What NOT to do)
- Do not let every subagent write to the same cache-safe snapshot location; later helpers will resume from polluted or incomplete context.
- Do not tie snapshot persistence to an unrelated feature flag when multiple consumers depend on it.