cartography

Generate hierarchical codemaps for repositories by analyzing file structures and content.

3|Updated Dec 23, 2025

Search Tags:#documentation #codebase #mapping #repository analysis #change detection #codemap

Ready to run

npx skills add https://github.com/boazcstrike/opencode --skill cartography-boazcstrike

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: cartography
Source: https://github.com/boazcstrike/opencode/tree/main/skills/cartography
Command: npx skills add https://github.com/boazcstrike/opencode --skill cartography-boazcstrike

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill helps users understand and map complex codebases by generating hierarchical codemaps, making it easier to navigate and document projects.

Core Features & Use Cases

Repository Mapping: Creates a structured overview of a codebase.
Codemap Generation: Generates .md files for each directory detailing its responsibility, design, flow, and integration points.
Change Detection: Identifies modifications within the codebase since the last mapping.
Use Case: When starting on a new, large project, use this Skill to generate an initial codemap, providing a clear understanding of the project's structure and key components.

Quick Start

Use the cartography skill to initialize a codemap for the current repository.

Frequently Asked Questions about cartography

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

FAQPage Schema

How do I generate a hierarchical codemap for my repository?▼

Generate a hierarchical codemap for your repository by analyzing file structures and content to produce structured markdown files. Each directory receives a detailed markdown file outlining its responsibility, design, flow, and integration points.

What is the best way to document a complex codebase structure?▼

Documenting a complex codebase structure is best achieved through automated codemap generation, which analyzes file content and creates markdown overviews. This provides a clear understanding of project architecture and key components for new contributors.

How does codebase change detection work for repository mapping?▼

Codebase change detection works by hashing file contents during repository mapping and comparing them against the last generated codemap. This identifies modifications within the codebase, allowing targeted updates to existing documentation.

Can I use inclusion and exclusion patterns for targeted repository analysis?▼

Yes, you can use inclusion and exclusion patterns for targeted repository analysis. The mapping process supports specific file pattern filtering and automatically integrates with Git ignore files to exclude irrelevant paths from the codemap.

Do I need any external dependencies to map my codebase structure?▼

No external dependencies are required to map your codebase structure. The cartography skill operates independently using its internal scripts to analyze repository file structures and generate documentation without third-party integrations.