context-self-management

Decides between handoff, sprint, or compression when context window warnings trigger.

2.9k|733|Updated Mar 12, 2026
One-click install
npx skills add https://github.com/zts212653/clowder-ai --skill context-self-management
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: context-self-management
Source: https://github.com/zts212653/clowder-ai/tree/main/cat-cafe-skills/context-self-management
Command: npx skills add https://github.com/zts212653/clowder-ai --skill context-self-management

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

When a long AI session receives a context_management_hint warning, agents often react reflexively—handing off mid-task and losing in-flight work, or ignoring the warning until auto-seal. This Skill provides a structured judgment framework for deciding whether to hand off, sprint to a clean breakpoint, or simply continue and let compression happen.

Core Features & Use Cases

  • Three-Question Self-Check: Evaluates whether the session is a single thread or topic drift, whether a clean breakpoint exists, and how trustworthy the fill-confidence metric is.
  • 2x2 Decision Matrix: Maps drift state against breakpoint availability to one of four actions: handoff, sprint mode, continue, or compress.
  • Handoff Execution Guidance: Directs the agent to call cat_cafe_propose_session_handoff with a five-part handoff note covering completed work, current state, next steps, key decisions, and pitfalls.
  • Use Case: An agent processing multiple GitHub issues across repos starts confusing tracker repo with source repo and receives a context warning; the matrix identifies tree-like drift mid-task and triggers sprint mode to reach a clean breakpoint before handing off.

Quick Start

When you receive a context_management_hint warning, apply the three-question self-check and 2x2 matrix to decide whether to hand off, sprint, or continue.

Frequently Asked Questions about context-self-management

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I decide when to hand off an AI agent session?

Hand off when the session shows topic drift or multiple compressions AND the current task has reached a clean breakpoint. If work is mid-flight, sprint to the nearest breakpoint first rather than handing off incomplete state.

What should I do when a context window warning appears?

Do not reflexively hand off or clear context. Run a three-question self-check: is the session a single thread or drifted tree, is there a clean breakpoint, and how reliable is the fill-confidence metric, then apply the 2x2 decision matrix.

Is context compression bad for in-flight work?

No. Compression preserves in-flight threads when work is coherent and mid-task. Forcing a handoff at that point loses half-finished state to a fresh session that cannot reconstruct it, which is worse than compressing.

What goes into a session handoff note?

A five-part note: what was completed, what is currently in progress, the next step, key decisions and pitfalls, and what not to touch. The note is written for a fresh instance of yourself, not for another agent.

When should I not use this context management skill?

Do not use it for general context anxiety without a system warning, or for handing work to a different agent, which is covered by cross-cat handoff instead. It only applies to session boundary decisions triggered by context_management_hint.