How does nav-stats calculate token savings?

It compares the tokens Navigator has actually loaded during your session against the 'baseline'—the total size of all documentation in your .agent/ directory.

How do I see my session report?

Simply ask Claude 'show my stats', 'how efficient am I?', or 'show session metrics' while using the Navigator workflow.

What does the Efficiency Score represent?

It is a holistic 0-100 metric calculated based on token savings (40%), cache efficiency (30%), and context window usage (30%).

Why is my cache efficiency low?

Low cache efficiency often suggests that your CLAUDE.md isn't properly configured or that prompt caching isn't being triggered by your current interaction pattern.

Does this skill require the Navigator repository?

Yes, this skill is part of the Navigator Just-in-Time documentation workflow and requires the project to be initialized with Navigator v3.5.0 or higher.

Navigator Session Stats

Name: Navigator Session Stats
Author: alekspetrov

byalekspetrov

•

分析与监控

Generates real-time efficiency reports to quantify token savings and optimize Claude's context usage.

关于

The nav-stats skill provides a detailed audit of your Claude Code session performance, specifically designed for projects using the Navigator Just-in-Time documentation workflow. It calculates critical metrics like token savings compared to baseline documentation, cache hit rates, and overall context health, while providing actionable recommendations to keep your session lean and responsive. This tool is essential for developers looking to validate their context engineering strategies and ensure peak performance during long-running AI coding sessions.

主要功能

Calculates token savings vs. full documentation baseline
Tracks cache efficiency using OpenTelemetry data
Provides context-aware optimization recommendations
47 GitHub stars
Generates a 0-100 holistic Efficiency Score
Estimates developer time saved in minutes

使用场景

Generating shareable performance reports to validate workflow efficiency
Quantifying the cost and token savings of JIT documentation workflows
Optimizing Claude's context window usage during complex refactors

关于

主要功能

Calculates token savings vs. full documentation baseline
Tracks cache efficiency using OpenTelemetry data
Provides context-aware optimization recommendations
47 GitHub stars
Generates a 0-100 holistic Efficiency Score
Estimates developer time saved in minutes

使用场景

Generating shareable performance reports to validate workflow efficiency
Quantifying the cost and token savings of JIT documentation workflows
Optimizing Claude's context window usage during complex refactors