cartography

Generate hierarchical codemaps and repository dictionaries for codebase navigation.

Updated Feb 1, 2026
One-click install
npx skills add https://github.com/conglap189/opencode --skill cartography-conglap189
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: cartography
Source: https://github.com/conglap189/opencode/tree/main/skills/cartography
Command: npx skills add https://github.com/conglap189/opencode --skill cartography-conglap189

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Cartography solves the challenge of understanding large codebases by generating hierarchical codemaps and a repository atlas for explorers.

Core Features & Use Cases

  • Generates a .slim/cartography.json state file to track changes and file/folder hashes.
  • Creates empty codemap.md templates for folders to document responsibility, design, flow, and integration.
  • Delegates to Explorer agents to populate codemaps and maintain repository-wide atlas.

Quick Start

Run the cartography tool to initialize mapping in your repository and generate per-folder codemap.md templates.

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 a complex codebase?▼

To generate a hierarchical codemap for a complex codebase, run the cartography tool to initialize repository mapping and produce per-folder codemap.md templates for documenting module responsibility and flow.

What is the best way to track changes across multi-module repositories?▼

Tracking changes across multi-module repositories requires computing file and folder hashes saved in a .slim/cartography.json state file, enabling change detection and maintaining a repository-wide atlas for quick navigation.

How do I create a repository dictionary for codebase onboarding?▼

Creating a repository dictionary for codebase onboarding involves generating empty codemap.md templates per folder, which are then populated by delegated Explorer agents to document design, flow, and integration details.

Can I use include and exclude patterns to map specific repository folders?▼

Yes, you can apply include and exclude pattern handling to target specific directories, ensuring the generated codemaps and repository atlases focus only on the relevant parts of your multi-module codebase.

Do I need Python scripts to compute file hashes for codebase mapping?▼

Yes, computing file and folder hashes for codebase mapping requires Python scripts, which calculate the state stored in the .slim/cartography.json file to detect changes and maintain hierarchical codemaps.