Are these markers shared with my team via Git?

By default, markers are stored in the .agent directory which is usually git-ignored. This keeps session-specific save points local to your machine and prevents cluttering the repository.

Can I give my markers custom names?

Yes. When you ask to save your progress, you can provide a descriptive name like 'before-refactoring-auth'. If no name is provided, the skill will auto-generate one with a timestamp.

When is the best time to invoke the nav-marker skill?

It is best used before taking long breaks, before starting risky code changes, at major feature milestones, or immediately before compacting the context window.

What specifically does a 'Theory of Mind' capture include?

It captures your ultimate goals, your specific coding preferences, any corrections you've made to the AI's behavior, and the current level of technical understanding shared between you and the agent.

How do I restore a saved context marker?

You can restore a marker by reading the specific file in the .agent/.context-markers/ directory or by using the command /nav:markers to select from a list of available checkpoints.

Navigator Context Marker

Name: Navigator Context Marker
Author: dkyazzentwatwa

bydkyazzentwatwa

•

Productivity & Workflow

Captures and preserves detailed conversation state, user intent, and technical progress as restorable checkpoints for Claude Code sessions.

Navigator Context Marker is a sophisticated state-preservation tool designed to prevent knowledge loss during complex development cycles in Claude Code. By generating deep 'Theory of Mind' snapshots—including architectural decisions, specific user preferences, and unresolved uncertainties—it allows developers to pause work, perform risky refactors, or compact context windows without losing the nuances of their current session. It systematically organizes progress into structured Markdown files within your project's local directory, ensuring seamless resumption after breaks or context clears.

Key Features

01Standardized checkpoint storage in .agent/.context-markers/ for easy local retrieval.

02High-efficiency state compression capable of reducing large conversations by up to 97%.

03Automated tracking of modified files, loaded documentation, and technical decisions.

04Natural language invocation using phrases like 'save my progress' or 'mark this point'.

05Deep 'Theory of Mind' capture including user goals, mental models, and past corrections.

0629 GitHub stars

Use Cases

01Creating a recovery point before initiating a major architectural refactor or experimental code change.

02Capturing vital project context and 'next steps' before clearing the conversation window to free up tokens.

03Preserving the current 'mental state' of a coding session before taking a lunch break or ending the workday.

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add dkyazzentwatwa/supernavigator nav-marker

For use in Claude.ai and ChatGPT

Download Skill