Does it overwrite my existing project files?

No, the skill includes safety checks to prevent overwriting existing .agent folders and carefully appends Navigator-specific instructions to your CLAUDE.md file.

How does the token monitoring hook work?

It installs a PostToolUse hook in .claude/settings.json that runs a monitor script after every action, warning you when your context window is nearly full.

What is the purpose of the Grafana dashboard?

It provides a visualization layer for Claude Code metrics, allowing you to monitor tool usage and performance via a pre-configured Prometheus/Grafana stack.

What is the primary benefit of using Navigator Initializer?

It creates a standardized documentation structure that helps Claude Code access context more efficiently, reducing token usage by up to 92% while improving task accuracy.

What tech stacks does the auto-detector support?

It automatically identifies configurations for Node.js, Python, Go, Rust, PHP, and Ruby projects to customize the documentation templates.

Navigator Initializer

Name: Navigator Initializer
Author: alekspetrov

byalekspetrov

•

Learning & Documentation

Bootstraps the Navigator Just-in-Time Documentation structure to optimize Claude Code's performance and token efficiency.

Navigator Initializer automates the setup of a high-performance documentation and workflow structure within your project. It creates a dedicated .agent/ directory containing task templates, system architecture notes, and standard operating procedures (SOPs). By auto-detecting your project's tech stack and configuring advanced token monitoring hooks, it enables a Just-in-Time Documentation (JITD) workflow that significantly reduces token consumption while providing Claude with the precise context needed for complex engineering tasks.

Key Features

01Intelligent project tech stack and dependency auto-detection

02Automated CLAUDE.md updates and .gitignore configuration

03Automated .agent/ directory structure creation (SOPs, tasks, system)

04Integrated Grafana metrics dashboard for Claude Code observability

0547 GitHub stars

06Real-time token budget monitoring with automated alerts at 70% and 85% usage

Use Cases

01Implementing token-saving documentation workflows in existing complex codebases

02Configuring performance monitoring and observability for Claude Code sessions

03Setting up a new project for high-efficiency AI-assisted development

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add alekspetrov/navigator nav-init

For use in Claude.ai and ChatGPT

Download Skill