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.