nav-init

Create a Navigator documentation scaffold with Grafana metrics and CLAUDE integration.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes functions (resource) components.

What problem does it solve?

Setting up a new project with comprehensive documentation and an AI-native workflow can be a manual, error-prone process. This skill automates the entire initialization, ensuring a consistent and ready-to-use Navigator structure.

Core Features & Use Cases

  • Automated Project Setup: Creates the complete .agent/ directory structure, including task, system, and SOP directories, and copies essential templates.
  • Intelligent Project Detection: Automatically detects your project's name and tech stack (e.g., Next.js, Python FastAPI) from config files like package.json or pyproject.toml.
  • Integrated Metrics Setup: Installs Grafana dashboard files to enable visual monitoring of AI efficiency metrics.
  • Use Case: Starting a new Next.js project? Simply say "Initialize Navigator." The skill will detect your project, set up all documentation, configure basic settings, and even prepare Grafana for metrics, all in one go.

Quick Start

Example: Initialize Navigator in your project

"Initialize Navigator in this project"

Frequently Asked Questions about nav-init

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

FAQPage Schema
How do I set up project documentation and scaffolding automatically?

Project scaffolding automates directory creation, template placement, and metadata detection to establish a consistent documentation structure. This Skill creates the complete `.agent/` and `.claude/` directories, copies essential templates, and configures your project setup in one operation, eliminating manual file organization.

Can I automatically detect my project's tech stack and name?

Intelligent project detection reads configuration files like `package.json`, `pyproject.toml`, and similar manifests to automatically identify your project name and technology stack—Next.js, Python FastAPI, or others. This enables setup templates and documentation to match your specific framework without manual configuration.

What does initializing Navigator documentation include?

Navigator initialization sets up task, system, and SOP directories, installs Grafana dashboard files for metrics monitoring, configures CLAUDE.md with AI-native workflow settings, establishes token monitoring hooks, and updates `.gitignore` for proper version control, creating a complete ready-to-use documentation scaffold.

Do I need to manually configure Grafana metrics after project setup?

No. The initialization process installs Grafana dashboard files and prepares metrics infrastructure automatically. Your project is ready for visual monitoring of AI efficiency metrics without additional configuration, though you can customize dashboards afterward.

How does this differ from manual project initialization?

Manual setup requires creating directories, copying templates, detecting project info, and configuring monitoring separately—each step prone to inconsistency and errors. Automated initialization handles all these tasks atomically, ensuring a standardized, error-free structure across new projects and modules.

Can I use this for existing projects or only new ones?

This Skill applies to both new projects and existing modules requiring Navigator documentation and Grafana metrics. It creates the necessary directory structure and templates while auto-detecting your current project configuration, making it suitable for adding AI-native workflows to established codebases.