skills.rest
qf-studio
qf-studioOFFICIAL
Explore all skills by this author →
WebsiteGitHub

nav-compact

Creates context markers preserving session state before clearing Claude Code conversation history.

232|12|Updated Oct 10, 2025
Search Tags:#workflow#context management#claude code#session state#compact#token limit#context marker
One-click install
npx skills add https://github.com/qf-studio/navigator --skill nav-compact-qf-studio
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: nav-compact
Source: https://github.com/qf-studio/navigator/tree/main/skills/nav-compact
Command: npx skills add https://github.com/qf-studio/navigator --skill nav-compact-qf-studio

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Long Claude Code sessions hit token limits and lose all context when cleared. This Skill preserves your conversation state—files modified, decisions made, progress, and next steps—in a context marker before you compact, so nothing is lost when starting fresh. ## Core Features & Use Cases - Automatic marker creation: Captures the last 10-15 messages, modified files, technical decisions, and next steps into a timestamped marker file. - PreCompact hook detection: Detects the v6.10.0+ PreCompact hook and defers marker writing to it, avoiding duplicate markers. - Auto-restoration setup: Writes an .active file so the next session detects the marker and offers to restore your state. - Use Case: After finishing an authentication feature, say "clear context"—the Skill saves a marker, you start a new conversation, say "start my session", and resume exactly where you left off. ## Quick Start Say "clear my context" or "I'm done with this task, start fresh" to create a context marker and receive instructions for compacting your conversation.

Frequently Asked Questions about nav-compact

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

FAQPage Schema
How do I clear Claude Code context without losing my progress?▼

Invoke the compact workflow to create a context marker capturing your conversation summary, modified files, and next steps. Then start a new conversation or use /clear, and say "start my session" to restore the saved state.

How do I compact a Claude Code conversation approaching the token limit?▼

Say "clear context" or "compact" when nearing token limits. The Skill creates a marker with your current state, sets it as active, and guides you through manually clearing the conversation since Claude Code cannot be cleared programmatically.

Does nav-compact work with the PreCompact hook?▼

Yes, version 6.10.0+ projects with the PreCompact hook installed use a fast path where the hook writes markers automatically when you run /compact. The Skill detects the hook and skips manual marker creation to avoid duplicates.

When should I not compact my conversation?▼

Avoid compacting in the middle of an implementation, when context is needed for the immediate next step, or when the conversation has fewer than 20 messages. Compacting too early wastes effort since there is little context to preserve.

What happens if an active marker already exists when compacting?▼

The Skill warns that an unrestored marker from a previous compact exists and offers three options: load the existing marker first, overwrite it with a new marker, or cancel the compact operation entirely.

Related Skills

Explore More Software Engineering Skills→
darkroomengineeringdarkroomengineering
41

create-handoff

Save current task, progress, decisions, modified files, and next steps to a handoff file.

Official
Intermediate
electroheadfxelectroheadfx
4

gsd-resume-work

Restore project context and resume workflows from saved checkpoints.

Community
Advanced
sarkarshivaditya-labsarkarshivaditya-lab

memory-integration

Maintains cross-session context using episodic memory search and a knowledge graph of persistent facts.

Community
Intermediate
alekspetrovalekspetrov
196

nav-compact

Create context markers to preserve and restore conversation state.

Community
Advanced