session-guard
/session-guard
Use when working on complex multi-step tasks, when a session is getting long (40+ tool calls), when the agent starts ignoring rules it followed earlier, when conventions drift, when output quality seems to degrade, or after any context compaction event. Prevents long-session corruption AND context compaction amnesia through behavioral self-enforcement.
- Author
- wshobson ↗
- Repository
- agents ↗
- Licence
- MIT
- Last repository change
- 17.10.2026
Assessment and security
- Files in this package
- 1
- Scripts
- 0
- HTML comments
- 0
- URLs in SKILL.md
- 0
No signals detected. Repository changed on 17.10.2026, without references to retired models or APIs.
MIT, open: use and modify while retaining author attribution.
What it does and when to use it
Use when working on complex multi-step tasks, when a session is getting long (40+ tool calls), when the agent starts ignoring rules it followed earlier, when conventions drift, when output quality seems to degrade, or after any context compaction event. Prevents long-session corruption AND context compaction amnesia through behavioral self-enforcement.
Original author description
Use when working on complex multi-step tasks, when a session is getting long (40+ tool calls), when the agent starts ignoring rules it followed earlier, when conventions drift, when output quality seems to degrade, or after any context compaction event. Prevents long-session corruption AND context compaction amnesia through behavioral self-enforcement.
How it works
- Overview
- When to Use
- Health Signals
- Protocol
- Context Anchoring (anti-compaction)
- Common Mistakes
- Why This Matters
SKILL.md preview
--- name: session-guard description: >- Use when working on complex multi-step tasks, when a session is getting long (40+ tool calls), when the agent starts ignoring rules it followed earlier, when conventions drift, when output quality seems to degrade, or after any context compaction event. Prevents long-session corruption AND context compaction amnesia through behavioral self-enforcement. --- # Session Guard ## Overview Long sessions corrupt silently. Context compaction drops instructions unannounced. Hooks don't fix it (confirmed by multiple developers on GitHub issues #19471, #9796, #64171). This skill prevents both through behavioral self-enforcement: monitor health, anchor critical rules through compaction, split before damage occurs. No packages, no databases - pure behavioral enforcement that works in every harness. ## When to Use - Session exceeds 40 tool calls - Agent contradicts earlier decisions - Style/naming conventions start drifting - After any context compaction event - Task scope growing unbounded ## Health Signals | Signal | Threshold | Action | |--------|-----------|--------| | Tool call count | >40 | YELLOW: checkpoint + recite critical rules | | Tool call count | >60 | RED: split or compact with anchor | | Agent contradicts earlier decision | Any | VERIFY: re-read source of truth | | Style/naming drift | Any | RECITE: state the active rules aloud | | File read returns unexpected content | Any | RE-READ: don't trust cached state | | Task scope growing unbounded | Continuous | SPLIT: one task per session | ## Protocol ### Green Zone (0-40 tool calls) Normal operation. No intervention needed. ### Yellow Zone (40-60 tool calls) 1. CHECKPOINT - summarize progress in one paragraph 2. RECITE - state the 3-5 most critical active rules aloud: "Active rules: [naming convention], [file structure], [error handling pattern], [testing requirement]" 3. ASSESS - almost done? Push through. Not done? Prepare split. 4. REDUCE - no exploratory reads. Only targeted operations. ### Red Zone (60+ tool calls OR drift signal) 1. STOP - do not make more tool calls 2. VERIFY - re-read project rules (don't trust memory) 3. CHECKPOINT - write state to handoff document 4. SPLIT - create handoff, suggest fresh session ## Context Anchoring (anti-compaction) When compaction has occurred (sudden loss of earlier context, or after /compact): 1. RE-READ the project's rules file immediately 2. RECITE the 3-5 critical rules aloud in your response 3. VERIFY your planned next action matches those rules before executing 4. If uncertain about ANY prior decision, RE-READ the source file - don't guess ### What survives compaction: - Most recent user messages (high priority) - Currently-invoked skill body (capped at 5K tokens, oldest dropped first) - Git status and project structure - File contents read AFTER compaction ### What gets LOST in compaction: - Decisions made early in conversation - Architectural rules stated only verbally (not in files) - Context from tool outputs (file reads, command outputs) ### Compaction-Safe Pattern Keep critical instructions in FILES (CLAUDE.md, CONTEXT.md), NOT in conversation. If a rule matters, it must live in a file the agent can re-read - not in something agreed on earlier. ## Common Mistakes - Trusting that you remember the rules after 50+ tool calls (you don't - re-read) - Re-reading EVERYTHING to be safe (wastes tool calls - be targeted) - Feeling fine therefore assuming context is fine (compaction is SILENT) - Splitting AFTER noticing problems (split BEFORE - prevention, not recovery) ## Why This Matters Context compaction is the #1 unsolved platform problem in 2026. Hooks don't fix it (confirmed: the agent ignores post-compaction injections because the compaction summary creates narrative momentum). This skill is the lightweight behavioral countermeasure: no infrastructure, no packages - disciplined self-monitoring that works in every harness.
Versions
| Repository | Score | Licence |
|---|---|---|
| This page · wshobson/agents | 90 | MIT |
| Adit-Jain-srm/skill-forge | 100 | MIT |
Database snapshot: 13.11.2026 · package version 498084805597 (SHA-256 digest of the entire package)
Downloads in the last 30 days: 0 · ranking
Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.
Similar skills
- 100guard
Protect Claude Code sessions from context overflow by running a background daemon that monitors session size and auto-prunes before compaction hits. Use when the user says "guard", "protect session", "context getting long", "prevent compaction", "session management", or is… - 100long-session-check
Check how an agent or a working session handles long conversations, covering tool-result clearing, compaction, what gets written to files, when to start a new session, and how memory is scoped. Use when a long session starts forgetting constraints, after several compactions, or… - 100context-engineering
Optimizes agent context setup. Use when starting a new session, when agent output quality degrades, when switching between tasks, or when you need to configure rules files and context for a project. - 100context-window-management
ACTIVATE when context is getting long, when quality of responses degrades, when working on large codebases, or when a session has been running for 30+ minutes. ACTIVATE for 'context too long', 'losing track', 'fresh session', 'context window'. Provides rules for managing context… - 95context-engineering
Optimizes agent context setup. Use when starting a new session, when agent output quality degrades, when switching between tasks, or when you need to configure rules files and context for a project. - 95ctx-guard
Behavioral context self-check before a handoff. Use when the user asks whether the conversation is getting too long, after a context compaction, when the model starts repeating rejected plans or forgetting edited files, or whenever starting a fresh session is being considered.…