cartography

Generate hierarchical codemaps and detect file changes in repositories.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/frNNcs/.config --skill cartography-frnncs
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: cartography
Source: https://github.com/frNNcs/.config/tree/main/opencode/skills/cartography
Command: npx skills add https://github.com/frNNcs/.config --skill cartography-frnncs

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill helps users understand and map complex code repositories by automatically analyzing file structures, detecting changes, and generating documentation templates.

Core Features & Use Cases

  • Repository Analysis: Automatically scans and understands the hierarchical structure of a codebase.
  • Change Detection: Identifies added, removed, or modified files to track codebase evolution.
  • Codemap Generation: Creates codemap.md files for directories, providing a template for documenting responsibility, design, flow, and integration points.
  • Use Case: When starting on a new, large project, use this Skill to generate an initial map of the codebase, making it easier to navigate and understand its components.

Quick Start

Use the cartography skill to initialize mapping 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 a large codebase repository?

To generate a hierarchical codemap for a codebase repository, this Skill automates file analysis to map the structure and outputs a `codemap.md` file documenting directory responsibilities and integration points.

Can I track codebase changes and detect added or removed files automatically?

Yes, you can track codebase changes automatically. The Skill performs change detection by identifying added, removed, and modified files, updating the mapping state in `.slim/cartography.json`.

Do I need Python to initialize codebase mapping and repository analysis?

Yes, you need Python installed. The Skill requires Python scripts to initialize repository analysis, execute change detection, and handle state updates for generating codemap files.

What is the best way to document directory design and integration points in a new project?

The best way to document directory design and integration points is using the generated `codemap.md` files, which provide structured templates for capturing responsibility, flow, and integration details.

How does repository analysis handle ongoing change tracking for software engineering projects?

Repository analysis handles ongoing change tracking by running Python scripts to detect file modifications over time, ensuring the hierarchical codemap and `.slim/cartography.json` state remain current.