nav-marker

Creates context checkpoint files that preserve conversation state for later session restoration.

232|12|Updated Oct 10, 2025
One-click install
npx skills add https://github.com/qf-studio/navigator --skill nav-marker-qf-studio
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: nav-marker
Source: https://github.com/qf-studio/navigator/tree/main/skills/nav-marker
Command: npx skills add https://github.com/qf-studio/navigator --skill nav-marker-qf-studio

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve? Long AI-assisted coding sessions lose all progress when context is cleared, compacted, or the session ends, forcing you to re-explain everything from scratch. This Skill captures the conversation state—files modified, decisions made, next steps—into a restorable markdown checkpoint. ## Core Features & Use Cases - Context Checkpoint Creation: Generates a structured markdown marker in .agent/.context-markers/ capturing conversation summary, loaded docs, modified files, technical decisions, and next steps. - Theory of Mind Capture: Records user intent, stated preferences, corrections, and belief state so restored sessions avoid repeating mistakes. - Verification & Logging: Verifies the marker file exists and is non-empty, computes an MD5 checksum, and logs creation to .agent/.marker-log. - Use Case: Before a risky refactor, say "mark this point"—if the refactor fails, restore the marker in a new session and resume exactly where you left off without re-explaining the OAuth implementation you just finished. ## Quick Start Ask the assistant to save your progress by saying "create a checkpoint before my refactor" and it will write a restorable context marker file.

Frequently Asked Questions about nav-marker

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

FAQPage Schema
How do I save my Claude Code session progress before a break?

Say "save my progress" or "create checkpoint" and the skill writes a markdown marker to .agent/.context-markers/ capturing your conversation summary, modified files, and next steps. Restore it later by asking to load the marker in a new session.

How do I restore a context marker in a new session?

Start a new session and say "load marker [name]", or read the marker file directly from .agent/.context-markers/. The marker contains your conversation summary, technical decisions, and next steps so work resumes without re-explaining.

What information does a context checkpoint file contain?

Each marker includes a conversation summary, documentation loaded, files modified, current focus, technical decisions, next steps, user intent and corrections, and optionally loop mode and knowledge graph state. Typical size is 2-5k tokens.

When should I not create a context marker?

Skip marker creation when context is fresh with fewer than 5 messages exchanged, or when you are only asking about existing markers. Creating markers after every message produces noise rather than useful save points.

Are context markers shared with my team through git?

No, markers are git-ignored as personal session save points. Team members do not see each other's markers, and you can delete them anytime with the markers clean command.