← LeaderboardThe Skill Leaderboard

context-status

Show current context status and session health. Use to check how much context has been used, whether auto-compact is approaching, and what state will be preserved.

Published by pedrohcgs ↗pedrohcgs/claude-code-my-workflow

Try your first task

context-status

Start a fresh conversation.

Use context-status to report this project's current context usage, auto-compact outlook, active-plan status, and session-preservation state.

User-approved starter prompt based on a pinned source version; check current skill requirements before running. Task evidence ↗

SKILL.md

name: context-statusdescription: |  Show current context status and session health.  Use to check how much context has been used, whether auto-compact is  approaching, and what state will be preserved.allowed-tools: ["Read", "Bash", "Glob"]disallowed-tools: ["Edit", "MultiEdit"]metadata:   author: Claude Code Academic Workflow  version: 1.0.0

/context-status — Check Session Health

Show the current session status including context usage estimate, active plan, and preservation state.

What This Skill Shows

Context usage estimate — Approximate % of context window used
Active plan — Current plan file and status
Session log — Most recent session log
Preservation state — What will survive compaction

Workflow

Step 1: Check the Context Estimate

The context-monitor hook writes its estimate to context-pct.txt (and its counters and threshold flags to context-monitor-cache.json) in this project's session directory:

d=~/.claude/sessions/$(printf '%s' "${CLAUDE_PROJECT_DIR:-$PWD}" | python3 -c 'import sys,hashlib;print(hashlib.md5(sys.stdin.read().encode()).hexdigest()[:8])')
cat "$d/context-pct.txt" 2>/dev/null; cat "$d/context-monitor-cache.json" 2>/dev/null | head -20

Step 2: Find Active Plan

ls -lt quality_reports/plans/*.md 2>/dev/null | head -3

Step 3: Find Session Log

ls -lt quality_reports/session_logs/*.md 2>/dev/null | head -1

Step 4: Report Status

Format the output:

📊 Session Status
─────────────────────────────────
Context Usage:  ~XX% (estimated)
Auto-compact:   [approaching | not imminent]

📋 Active Plan
File:   quality_reports/plans/YYYY-MM-DD_description.md
Status: [draft | approved | in_progress | completed]
Task:   [current unchecked task or "none"]

📝 Session Log
File:   quality_reports/session_logs/YYYY-MM-DD_description.md

✓ Preservation Check
  • Pre-compact hook: [configured | missing]
  • Post-compact restore: [configured | missing]
  • Session state will be saved before compaction

Notes

Context % comes from Claude Code's own context_window.used_percentage where the status line shows it; the hook's context-pct.txt holds an estimate from transcript size (falling back to a tool-call count). The built-in /context shows exact usage
Actual compaction is triggered by Claude Code automatically
All important state is saved to disk (plans, logs, MEMORY.md)