skills.rest
boazcstrike
boazcstrikeCOMMUNITY
Explore all skills by this author →
Website𝕏@boazcstrikeGitHub

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
One-click install
npx skills add https://github.com/boazcstrike/opencode --skill cartography-boazcstrike
Or copy as Structured Prompt for Agent▼
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.

Related Skills

Explore More Software Engineering Skills→
iludeilude
8

ignore-files-workflow

Synchronizes ignore entries across .gitignore and .dockerignore files.

Community
Intermediate
viktorbezdekviktorbezdek
10

onboard-to-codebase

Generate a structural codemap and system model for a newly cloned codebase.

Community
Advanced
manuelbrandner85manuelbrandner85

diagramming-code

Generate Mermaid diagrams from Trailmark code graphs.

Community
Intermediate
AirmomoAirmomo

quick-guide-builder

Build technical guides by cross-validating MCP documentation with source code.

Community
Intermediate