map-codebase

Map codebases into structured analysis files for readiness assessment.

14|Updated Jan 29, 2026
One-click install
npx skills add https://github.com/Hypership-Software/vibe-check --skill map-codebase-hypership-software
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: map-codebase
Source: https://github.com/Hypership-Software/vibe-check/tree/main/skills/map-codebase
Command: npx skills add https://github.com/Hypership-Software/vibe-check --skill map-codebase-hypership-software

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Provide a focused, conceptual overview of a repository so teams can understand stack, architecture, conventions, and high-risk areas without running a full production readiness assessment.

Core Features & Use Cases

  • Standalone Mapping: Walk the repo to identify languages, frameworks, entry points, and top-level structure.
  • Mode-aware Exploration: Supports compact and standard modes depending on codebase size and can spawn a mapper subagent when available.
  • Structured Output: Produces a set of analysis files (.vibe-check/analysis/) such as stack.md, secrets.md, auth.md, and ai-security.md for downstream assessments.
  • Use Case: Useful for onboarding, pre-audit reconnaissance, or getting a quick readiness snapshot before a deeper /check run.

Quick Start

Run the map-codebase skill to produce a codebase map and write analysis files to .vibe-check/analysis/.

Frequently Asked Questions about map-codebase

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

FAQPage Schema
How do I generate a codebase map for readiness assessment?

Generate a codebase map by running the skill to walk your repository, identify languages and frameworks, and write structured analysis files such as stack.md and secrets.md into the .vibe-check/analysis/ directory.

What is codebase mapping and when do I need it?

Codebase mapping provides a focused, conceptual overview of a repository's stack, architecture, and conventions. You need it for onboarding, pre-audit reconnaissance, or getting a quick readiness snapshot before a deeper assessment run.

How do I analyze a large repository architecture without running a full audit?

You can analyze a large repository by using standard mode exploration, which can spawn a mapper subagent to handle the increased scale and produce structured analysis files without the overhead of a full production readiness assessment.

Does codebase mapping work for compact repositories and small projects?

Yes, codebase mapping supports a compact mode designed for smaller repositories, allowing you to quickly identify entry points, top-level structure, and high-risk areas without spawning unnecessary subagents.

What analysis files are produced when mapping a codebase?

Mapping a codebase produces structured markdown analysis files in the .vibe-check/analysis/ directory, including stack.md, secrets.md, auth.md, and ai-security.md, which document detected capabilities for downstream assessments.

What are the limitations of using a conceptual codebase map for security review?

A conceptual codebase map provides a high-level readiness snapshot and pre-audit reconnaissance but does not replace a full production readiness assessment, meaning it may not detect deep architectural vulnerabilities or complex compliance issues.