Codebase Map 1

    1

    Turn an unfamiliar repository into compact agent context and a visual architecture map.

    Free

    Security scanned

    Works with the AI Agents you already use

    Claude CodeClaude CodeCursorCursorCodex CLICodex CLIMuseMuseDotsDots+21 more

    codebase-map

    Example session with this skill installed

    $codebase-map How does a new user registration flow work in this repository?

    • Read your context and instructions
    • Compiled the codebase-map

    I have scanned the repository and indexed the registration logic. I've identified the entry points in the API gateway and traced the flow through the auth service to the persistence layer.

    User Registration Flow Map

    sequenceDiagram
        participant U as User
        participant G as Gateway (routes/auth.ts)
        participant S as AuthService (services/identity.js)
        participant D as Database (models/user.model.ts)
    
        U->>G: POST /api/v1/register
        G->>S: validatePayload(data)
        Note over S: confirmed: uses bcrypt for hashing
        S->>D: findUnique({ email })
        D-->>S: null
        S->>D: create({ data })
        D-->>S: UserObject
        S-->>G: Token + Profile
        G-->>U: 201 Created
    

    The flow is centered on routes/auth.ts and services/identity.js. The indexing identified that while the API structure is confirmed, the exact retry logic for the database connection is currently

    inferred based on generic middleware patterns.

    Generated Artifacts:

    • reports/codebase-map/core-api/index.json (Source of truth)
    • reports/codebase-map/core-api/architecture.html (Interactive map)
    • reports/codebase-map/core-api/context.md (Agent orientation)

    Next steps

    1. Open reports/codebase-map/core-api/architecture.html to see the full component map.
    2. Review evidence.md to see the specific symbol paths for validatePayload.
    3. Run a focused map on the email-worker if you need to see the post-registration welcome flow.

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

    About this skill

    codebase-map is an agent skill that turns an unfamiliar repository into (1) a compact index an agent can retrieve from before reading source files, and (2) a visual answer to broad architecture questions or specific questions about how the repo works. Every concept, label, edge and flow is derived from repository evidence. Outputs a self-contained HTML architecture report plus context.md, evidence.md and index.json. Includes a verifier script and a tiny example app. Open source on GitHub: https://github.com/adianvel/codebase-map

    Requires local filesystem access. Performance on massive repos depends on clear boundaries. Visuals are limited to code evidence.

    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 any payment.

    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 forever

    No account required to browse

    Trust & safety

    Security scan

    Security scan passed today

    • Free with an Agensi account

    Permissions

    Terminal / Shell
    Read Files
    Write Files
    Network Access
    Listedtoday

    What's inside

    Frequently Asked Questions

    The skill performs a deep scan of your repository's structure, lockfiles, and symbols to build an evidence-based graph, ensuring diagrams and indexes reflect actual code rather than guesses based on filenames.

    Yes, it is language-agnostic. It analyzes universal project markers like Git history, configuration files, and source code symbols to map any tech stack, from Python and JavaScript to Go and Rust.

    By generating a compact 'context.md' and structured 'index.json', the skill distills a massive repo into a lightweight summary that allows other agents to understand the architecture without consuming your entire token window.

    No external setup is required; once the skill is added to your environment, simply run the `$codebase-map` command within any local repository directory to begin the indexing process.

    The skill produces an inline Mermaid diagram for immediate viewing, a structured JSON index for programmatic use, and a self-contained HTML report that provides a searchable, visual interface for your code's architecture.

    For exceptionally large repositories, it is recommended to run the mapping process on specific sub-directories or modules to maintain optimal performance and diagram clarity.

    New in Prompt & Skill Engineering