skills.rest
ApexSigma-Solutions
ApexSigma-SolutionsOFFICIAL
Explore all skills by this author →
WebsiteGitHub

cartography

Generate repository codemaps with file and folder hashes.

Updated Jan 24, 2026
Search Tags:#automation#codebase#repository#map#codemap#change-detection
One-click install
npx skills add https://github.com/ApexSigma-Solutions/Soma --skill cartography
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: cartography
Source: https://github.com/ApexSigma-Solutions/Soma/tree/main/.claude/Skills/cartography
Command: npx skills add https://github.com/ApexSigma-Solutions/Soma --skill cartography

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Cartography helps orchestrators map and understand codebases by generating hierarchical codemaps and change-tracking state.

Core Features & Use Cases

  • Initialize mapping state and compute file/folder hashes to track changes over time.
  • Auto-create empty codemap.md templates in relevant folders for explorers to fill in.
  • Detect changes and update internal state, delegating exploration tasks to agents.

Quick Start

Initialize mapping: python3 cartographer.py init --root /repo --include "src//*.ts" --exclude "node_modules/" Check changes: python3 cartographer.py changes --root /repo Update state: python3 cartographer.py update --root /repo

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 an unfamiliar repository?▼

To generate a hierarchical codemap, initialize the mapping state to compute file and folder hashes, which then produces per-folder codemap.md templates for explorers to document the repository structure.

How can I track codebase changes over time using file and folder hashes?▼

You can track codebase changes by running the update command to recalculate file and folder hashes, detecting modifications against the persisted state in .slim/cartography.json and delegating exploration to agents.

Does the codebase mapping tool respect .gitignore and custom include/exclude patterns?▼

Yes, the codebase mapping tool natively respects .gitignore rules and supports custom include/exclude pattern handling, ensuring reproducible repository maps filtered to relevant source files.

What is the best way to onboard engineers onto a large, unfamiliar codebase?▼

The best way to onboard engineers is by generating hierarchical codemaps that outline folder structures and tracking state changes, enabling quick comprehension of unfamiliar codebases for audits and maintenance.

Can I use this codebase mapping script for repository audits and maintenance tasks?▼

Yes, you can use the script for repository audits and maintenance tasks, as it records file and folder hashes to detect structural changes and generates per-folder codemaps for comprehensive codebase analysis.

Related Skills

Explore More Software Engineering Skills→
SaintForeSaintFore

cartography

Map repository files and generate hierarchical codemap.md templates with change tracking.

Community
Intermediate
erikstmartinerikstmartin
16

cartography

Map repositories to codemaps and architecture documentation with per-folder templates.

Community
Intermediate
IndianBoy42IndianBoy42

cartography

Generate hierarchical codemaps and track repository state in .slim/cartography.json.

Community
Intermediate
jk278jk278

git-analyzer

Analyze git repositories to summarize commit history and file changes.

Community
Intermediate