skills.rest
SethGammon
SethGammonCOMMUNITY
Explore all skills by this author →
Website𝕏@SethGammonGitHub

map

Generate a structural JSON index of codebase files, exports, and imports.

820|78|Updated Mar 20, 2026
Search Tags:#codebase#dependencies#agents#query#mapping#index#fleet
One-click install
npx skills add https://github.com/SethGammon/Citadel --skill map-sethgammon
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: map
Source: https://github.com/SethGammon/Citadel/tree/main/skills/map
Command: npx skills add https://github.com/SethGammon/Citadel --skill map-sethgammon

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Structural codebase navigation is slow in large repos; this Skill builds a compact, queryable map of files, exports, imports, dependency graph, and roles to speed discovery and reduce token usage in agent context.

Core Features & Use Cases

  • Generates a structural index by scanning the project tree and collecting files, exports, imports, and symbols.
  • Builds a dependency graph and infers roles to enable fast, keyword-driven searches and fleet context injections.
  • Outputs to .planning/map/index.json and supports map slices for agent context integration.
  • Useful when onboarding to a new codebase, auditing large repositories, or powering automated code navigation in fleets.

Quick Start

Generate or refresh the index with the recommended root and review the resulting map file at .planning/map/index.json.

Frequently Asked Questions about map

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create a structural map of a codebase for faster navigation?▼

To create a structural codebase map, scan the project tree to collect files, exports, imports, and symbols. The process builds a dependency graph and infers file roles, outputting a queryable JSON index to accelerate code discovery.

What is a codebase map and how does it reduce token usage for agents?▼

A codebase map is a compact, queryable structural index of files, exports, imports, and dependency graphs. It reduces token usage by providing agents targeted contextual awareness through map slices instead of loading entire files.

Can I use a codebase index for fleet campaigns where agents need file awareness?▼

Yes, you can use a codebase index for fleet campaigns. The generated map supports context injections, enabling multiple agents to query structural file relationships and dependency graphs for coordinated automated navigation.

What is the best way to onboard to a new repository and audit large codebases?▼

The best way to onboard to new repositories or audit large codebases is generating a structural index. This maps files, exports, and dependency roles, enabling rapid keyword-driven searches and reducing manual discovery time.

Where does the generated codebase map index file get saved?▼

The generated codebase map index file is saved directly at .planning/map/index.json. This JSON output contains the structural map, allowing you to run query, stats, and slice operations for agent integration.

Related Skills

Explore More Software Engineering Skills→
pohlai88pohlai88

pnpm-workspace

Define pnpm-workspace.yaml and link local packages with the workspace protocol.

Community
Intermediate
AribSudiaAribSudia
2

arib-graph

Generate a JSON import graph of monorepo file dependencies using ripgrep.

Community
Intermediate
forbiddenlinkforbiddenlink
1

specter-scan

Index TypeScript and JavaScript codebases into a Specter knowledge graph.

Community
Intermediate
trehansaliltrehansalil

smart-explore

Explore codebases by parsing ASTs to discover functions and symbols.

Community
Advanced