RN

    repo nav

    0

    Generate hierarchical, progressive-disclosure Markdown indexes for codebase navigation by AI coding agents.

    Free

    Security scanned

    Works with the AI Agents you already use

    Claude CodeClaude CodeCursorCursorCodex CLICodex CLIDeepSeekDeepSeekMuseMuse+22 more
    RN

    repo nav

    Example session with this skill installed

    Generate a baseline repo-nav index for this project. Use the current directory as the Designated Root Folder.

    • Read your context and instructions
    • Compiled the repo nav

    I have initiated the repository navigation indexing for the current directory (Designated Root Folder: root). I used filelist.sh to generate the authoritative inventory and have processed the folder hierarchy from deepest to shallowest.

    Repository Indexing Result

    File/FolderStatusSummary
    DOCMAP.mdCreatedRoot index providing architectural overview and navigation guidance.
    src/auth/docmap.mdCreatedIndex for authentication logic, covering JWT and OAuth2 flows.
    src/db/docmap.mdCreatedIndex for database models and migration scripts.
    SCHEMA_MAP.mdCreatedMap of all tables, views, and indexes defined in the DRF.
    ARCHITECTURE_MAP.mdCreatedOverview of system layers and major responsibilities.
    
    # Designated Root Folder: Project Root
    
    ## Overview
    This repository implements a distributed microservices architecture for order processing. It handles authentication, inventory management, and payment gateway integration.
    
    ## Navigation Guidance
    AI agents should start with this `DOCMAP.md` to identify the relevant module. Folder-level `docmap.md` files provide specific file responsibilities and TODO markers.
    
    ## Primary Modules
    - `src/auth/`: Authentication service (JWT, OAuth2)
    - `src/orders/`: Core business logic for order lifecycles
    - `src/common/`: Shared utilities and middleware (Merged into parent)
    
    ## Database Schema Summary
    - **Table: Users** (Defined in `src/db/models/User.py`)
    - **Table: Orders** (Defined in `src/db/models/Order.py`)
    

    Next steps

    1. Review the generated DOCMAP.md at the project root.
    2. Verify that AGENTS.md has been updated with the new navigation instructions.
    3. Run an incremental update after your next major commit to refresh the summaries.

    Connects securely to your tools. The creator never sees your data.

    About this skill

    Large repositories often become a black box for AI coding agents, leading to high token costs and poor decision-making. This skill solves the "context window" problem by generating a hierarchical structure of index files using progressive disclosure. It builds a map of your codebase that allows agents to navigate directly to relevant files without scanning the entire tree.

    What it does

    • Hierarchical Indexing generates DOCMAP.md files at the root and folder levels to summarize architecture and business logic.
    • Progressive Disclosure ensures detailed information only appears at deeper levels, keeping agent context windows clean.
    • Change Detection identifies modified files using size-based comparison for fast, incremental index updates.
    • Cross-Cutting Maps creates specialized navigation for features, architecture, technology stacks, and database schemas.
    • Smart Merging absorbs small folder summaries into parent indexes to reduce file clutter while preserving context.

    How it works

    1. Plan & Confirm identifies the Designated Root Folder (DRF) and gets user approval for the indexing operation.
    2. Inventory Discovery uses ripgrep via mandatory shell scripts to create an authoritative file list.
    3. Progressive Analysis processes folders from deepest to shallowest, generating LLM-backed summaries and semantic tags.
    4. Map Generation compiles specialized indexes like SCHEMA_MAP.md and FEATURE_MAP.md from the docmap data.

    Frameworks & tools

    This skill requires ripgrep (rg) for repository discovery. It uses PowerShell on Windows and Bash on Unix-like systems for all automation and path handling.

    Why this beats prompting it yourself

    Manual prompts often result in hallucinated file structures or missing context in deep hierarchies. This tool enforces a strict reference workflow using shell-side validation and consistent templates, ensuring every file summary is evidence-based and every link is relative and functional.

    Use cases

    • Orienting a new AI agent to a massive legacy codebase.
    • Generating a database schema map that connects SQL definitions to application code.
    • Reducing token usage by preventing agents from recursively reading every file.
    • Creating a feature map to track requirements against implementation and tests.

    Known limitations

    Does not support external systems like Jira or GitHub. It does not perform AST parsing, call graph analysis, or dependency extraction. Requires ripgrep to be installed and available on the path.

    Find more skills like this on the Claude Skills Marketplace, the Codex Skills Marketplace and the Gemini Skills Marketplace, or browse All Claude Skills.

    Requires ripgrep (rg). No AST parsing or call graph generation. Dependency extraction is reserved for future versions. No support for external systems like Jira.

    How to use

    1. 1

      Connect your agent to the Agensi MCP

      Copy the prompt and paste it into Claude, ChatGPT, Cursor or any agent that supports MCP. It sets up the connection for you. Manual setup

    2. 2

      Sign in to Agensi

      Your agent shows a sign-in link. Sign in and click Allow.

    3. 3

      Ask for what you need

      Your agent loads this skill and uses it on your task. It always asks before buying a skill.

    Reviews

    No reviews yet

    Be one of the first to try it. Every listed skill goes through the trust checks below.

    Security scanned

    Checked by our 8-point scan before listing

    Fresh listing

    Recently published to Agensi

    Free to use

    No account required to browse

    Trust & safety

    Security scan

    Security scan passed 12 days ago

    • Free with an Agensi account

    Software
    ripgrep

    Permissions

    Terminal / Shell
    Read Files
    Write Files
    Listed12 days ago

    What's inside

    Frequently Asked Questions

    Repo nav eliminates 'context window bloat' by creating a hierarchical map of your codebase, allowing AI agents to understand the architecture and locate specific files without reading every line of code or using grep/find

    Yes, it uses PowerShell for Windows and Bash for Unix-like systems, though it requires the `ripgrep (rg)` utility to be installed on your system path for discovery operations.

    Unlike simple prompts, this skill uses shell-validated discovery and a 'deepest-to-shallowest' processing logic to ensure every index file is accurate, evidence-based, and free from hallucinations.

    This skill performs size-based change detection to identify modified files, allowing it to perform fast incremental updates rather than re-indexing the entire repository from scratch.

    The skill is designed to work with any AI coding agent that has shell access and the ability to read Markdown files, making it a universal tool for codebase navigation.

    Free