nav-stats

Generate a session efficiency report with token savings and cache performance.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes functions (resource) components.

What problem does it solve?

Understanding the true efficiency and cost-effectiveness of AI interactions can be opaque. This skill provides clear, quantifiable metrics on token usage, cache performance, and estimated time savings, making AI's value tangible.

Core Features & Use Cases

  • Real-time Efficiency Report: Generates a visual report showing documentation loaded, tokens saved, cache efficiency, and context usage.
  • Quantifiable Savings: Provides estimated time saved in minutes and an overall efficiency score (0-100).
  • Actionable Recommendations: Offers tailored advice to improve your AI workflow based on your session metrics.
  • Use Case: After a productive coding session, ask "show my stats" to see how many tokens Navigator saved you, how well the cache performed, and get tips to further optimize your context window.

Quick Start

Example: Display your session efficiency report

"show my stats"

Frequently Asked Questions about nav-stats

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

FAQPage Schema
How do I measure token usage and AI efficiency across my sessions?

Token usage metrics quantify how many tokens your AI interactions consumed and how much the cache saved. This Skill displays your session efficiency report showing tokens saved, cache performance, and an overall efficiency score (0-100) to help you understand your AI cost and resource consumption.

What does cache performance mean for AI cost optimization?

Cache performance measures how effectively cached context is reused across requests, reducing redundant token processing and lowering AI costs. The Skill reports your cache efficiency percentage and recommends optimizations to maximize reuse and minimize overall token expenditure.

Can I see time savings from my AI interactions quantified?

Yes, the Skill estimates time saved in minutes by analyzing how Navigator's documentation and context reduce your manual research and context-building overhead. It translates token and cache metrics into actionable time-savings figures in a shareable ASCII report.

What information do I need to generate an efficiency report?

Navigator must be initialized in your session to generate metrics. The Skill verifies initialization automatically, then executes the enhanced session stats script to compute token savings, cache efficiency, and recommendations without requiring manual input.

How can I improve my AI workflow efficiency based on the report?

The Skill provides tailored recommendations based on your session metrics—such as optimizing context window usage or leveraging cache more effectively. Use these actionable tips alongside your efficiency score to refine your AI interaction patterns and reduce token costs.