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.
How do I install this agent skill?
npx skills add https://github.com/pedrohcgs/claude-code-my-workflow --skill context-statusIs this agent skill safe to install?
- Gen Agent Trust Hubpass
The skill accesses internal session data and local project reports to display status information. It reads files from the application's hidden directory in the user's home folder.
- Socketpass
No alerts
- Snykpass
Risk: LOW · No issues
- Runlayerpass
1 file scanned · No issues
What does this agent skill do?
/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_percentagewhere the status line shows it; the hook'scontext-pct.txtholds an estimate from transcript size (falling back to a tool-call count). The built-in/contextshows exact usage - Actual compaction is triggered by Claude Code automatically
- All important state is saved to disk (plans, logs, MEMORY.md)
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/pedrohcgs/claude-code-my-workflow/context-status">View context-status on skillZs</a>