nav-compact

Solid

Clear conversation context while preserving knowledge via context marker. Use when user says "clear context", "start fresh", "done with this task", or when approaching token limits.

AI & Automation 232 stars 12 forks Updated today

Install

View on GitHub

Quality Score: 82/100

Stars 20%
79
Recency 20%
100
Frontmatter 20%
70
Documentation 15%
100
Issue Health 10%
50
License 10%
0
Description 5%
100

Skill Content

# Navigator Compact Skill Clear your conversation context while preserving all knowledge in a context marker. Like git commit before switching branches - save your state, then start fresh. ## When to Invoke Invoke this skill when the user: - Says "clear context", "start fresh", "reset conversation" - Says "I'm done with this task", "moving to next feature" - Mentions "approaching token limit", "context getting full" - Says "compact", "clean up context" - After completing isolated sub-task **DO NOT invoke** if: - User is in middle of implementation - Context is needed for next immediate step - Less than 20 messages in conversation (not much to gain) ## Execution Steps ### Step 0: Detect PreCompact Hook (Fast Path) [v6.10.0+] **Before doing anything else**, check whether the project has the PreCompact hook installed. ```bash HAS_HOOK=$(grep -l "nav_dispatch" .claude/settings.json .claude/settings.local.json 2>/dev/null | head -1) ``` **If the hook is present**: → **Fast path activated**. The `PreCompact` hook will write the marker automatically when the user runs `/compact` (or when Claude Code auto-compacts). Skip Steps 2–5 (marker creation + `.active` writing) — the hook owns those. Just print: ``` ╔══════════════════════════════════════════════════════╗ ║ 🗜️ Navigator Compact (hook-managed) ║ ╚══════════════════════════════════════════════════════╝ ✅ PreCompact hook is installed — Navigator will write the marker automatically when you run /c...

Details

Author
alekspetrov
Repository
alekspetrov/navigator
Created
11 months ago
Last Updated
today
Language
Python
License
None

Integrates with

Bundled in these plugins

Similar Skills

Semantically similar based on skill content — not just same category