map SKILL.md skillA

map from sethgammon/citadel is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add sethgammon/citadel/map@git:20260611.0f3f8e7

Pins git:20260611.0f3f8e7 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
sethgammon/citadel
Path
skills/map/SKILL.md
Versions recorded
5
Latest version
git:20260611.0f3f8e7, committed Jun 11, 2026
First version recorded
Mar 29, 2026
Size
7,127 bytes
Repository stars
929
License
MIT

Structural codebase index generator. Builds a compact JSON map of files, exports, imports, dependency graph, and roles. Queryable by keyword. Injected into fleet agents as context slices to reduce token usage on code navigation.

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# /map -- Codebase Intelligence

## Orientation

Use `/map` when:
- Starting work on an unfamiliar codebase (build the index first)
- A fleet or archon campaign needs agents to know "what files matter for X"
- You want a quick structural overview (stats, roles, dependency graph)
- You need to find files related to a keyword without exploratory reads

Do not use `/map` for:
- Reading file contents (use Read)
- Searching for string patterns inside files (use Grep)
- Single-file edits where you already know the path

## Commands

| Command | Behavior |
|---|---|
| `/map` | Generate or refresh the index (skips if cache is fresh) |
| `/map --force` | Rebuild the index even if cache is fresh |
| `/map query <terms>` | Search the index for files matching keywords |
| `/map stats` | Print summary statistics (files, lines, languages, roles) |
| `/map slice <terms>` | Output a compact context slice for agent injection |
| `/map stale` | Detect added, changed, or removed indexed source files |

## Protocol

### Step 1: GENERATE INDEX

Run the index generator:

```bash
node scripts/map-index.js --generate --root .
```
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add sethgammon/citadel/map@sha256:3cfa26f3c6dea6d1

The line at the top of this page pins the label git:20260611.0f3f8e7, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_vhsiuvvgc3s6xqss.svg)](https://markdownregistry.com/a/art_vhsiuvvgc3s6xqss)

4 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 5 versions of this file, between Mar 29, 2026 and Jun 11, 2026, about one every 19 days.

versioncommittedcommitsizeaudit
git:20260611.0f3f8e7 latest2026-06-11 0f3f8e7 7,127 BA view · diff
git:20260611.a6479532026-06-11 a647953 7,114 BA view · diff
git:20260604.4ff456f2026-06-04 4ff456f 6,985 BA view · diff
git:20260503.631b94d2026-05-03 631b94d 5,966 BA view · diff
git:20260329.6c378a22026-03-29 6c378a2 5,845 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (7127 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

sethgammon/citadel · 929 stars · license MIT · pushed 2026-10-30 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_vhsiuvvgc3s6xqss
GET https://markdownregistry.com/api/v1/resolve?ref=sethgammon/citadel/map
GET https://markdownregistry.com/api/v1/blob/3cfa26f3c6dea6d109eac10bc83fd8ae53f81084895a71f8355df6aafd5b2552

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from sethgammon/citadel

AGENTS.md AGENTS.md file
sethgammon/citadel · AGENTS.md
git:20260911.5005453 · audit A · 929 stars
CLAUDE.md CLAUDE.md file
sethgammon/citadel · CLAUDE.md
git:20260911.5005453 · audit A · 929 stars
AGENTS.md@examples/berman-agents-md-only AGENTS.md file
sethgammon/citadel · examples/berman-agents-md-only/AGENTS.md
git:20260701.7169885 · audit A · 929 stars
AGENTS.md@examples/berman-deploy-steward AGENTS.md file
sethgammon/citadel · examples/berman-deploy-steward/AGENTS.md
git:20260701.7169885 · audit A · 929 stars
template-skill SKILL.md skill
sethgammon/citadel · scripts/fixtures/ecosystem/anthropics-template-skill/SKILL.md · Replace with description of the skill and when Claude should use it.
git:20260711.59dbe65 · audit B · 929 stars
architect SKILL.md skill
sethgammon/citadel · skills/architect/SKILL.md · Given a PRD, produces an implementation architecture: file tree, component breakdown, data model, and a phased build…
git:20260611.0f3f8e7 · audit A · 929 stars
archon SKILL.md skill
sethgammon/citadel · skills/archon/SKILL.md · Autonomous multi-session campaign agent. Decomposes large work into phases, delegates to sub-agents, reviews output…
git:20261021.eead012 · audit A · 929 stars
ascii-diagram SKILL.md skill
sethgammon/citadel · skills/ascii-diagram/SKILL.md · Generate perfectly aligned ASCII diagrams — architecture, flow, sequence, box-and-arrow. Uses a programmatic…
git:20260611.0f3f8e7 · audit A · 929 stars
autopilot SKILL.md skill
sethgammon/citadel · skills/autopilot/SKILL.md · Intake-to-delivery pipeline. Processes pending items from .planning/intake/: briefs new ideas, executes approved work…
git:20261009.7a64c3f · audit A · 929 stars
cost SKILL.md skill
sethgammon/citadel · skills/cost/SKILL.md · Deep cost exploration and transparency. Shows real token usage, session costs, campaign spend, burn rates, and model…
git:20260611.0f3f8e7 · audit A · 929 stars
create-app SKILL.md skill
sethgammon/citadel · skills/create-app/SKILL.md · End-to-end app creation from a single description. Five tiers: blank project, guided, templated, fully generated, or…
git:20260611.0f3f8e7 · audit A · 929 stars
create-skill SKILL.md skill
sethgammon/citadel · skills/create-skill/SKILL.md · Creates new skills from the user's repeating patterns. Interview-driven: discovers the task, analyzes failure modes…
git:20260922.465c020 · audit A · 929 stars

Every file in sethgammon/citadel

Other files named map

map SKILL.md skill
yeachan-heo/oh-my-claudecode · skills/map/SKILL.md · The yard's skill map — which skill owns which job, in delivery-loop order. Use when something needs doing but not which…
git:20261011.2d2ee02 · audit A · 40,492 stars
map SKILL.md skill
countbot-ai/countbot · workspace/skills/map/SKILL.md · 高德地图路线规划与 POI 搜索。支持驾车、步行、骑行、公交路线规划,以及景点、餐厅搜索。当用户询问路线、行程规划、景点推荐、餐厅推荐时使用。
git:20260304.c40dbb2 · audit A · 784 stars
map SKILL.md skill
snowflake-labs/cocoplus · .cortex/skills/cocomap/map/SKILL.md · Build and commit a Cortex function knowledge graph — maps structural dependencies and domain intent relationships…
v1.1.0 · audit A · 727 stars
map SKILL.md skill
yha9806/academic-writing-toolkit · .claude/skills/map/SKILL.md · Show literature-to-chapter coverage and the writing progress dashboard — which sources support which chapters, and word…
git:20260920.f7e7cc9 · audit A · 54 stars
map SKILL.md skill
varun-singhh/lfg · plugin/skills/map/SKILL.md · Charts an epic too big for one session as a map of decision tickets in dev-graph (and in Linear after an explicit yes)…
git:20261015.6b3a06b · audit A · 10 stars
map SKILL.md skill
duthaho/skillhub · .claude/skills/map/SKILL.md · Codebase orientation for an unfamiliar or large repo — "map this before I work in it." Fans out read-only Explore…
git:20260729.22fe8ab · audit A · 9 stars
map SKILL.md skill
higoralves/orc · orc/skills/map/SKILL.md · Ask which orc command, skill, or flow fits your situation — the router over everything orc ships.
git:20261024.096391f · audit A · 7 stars
map SKILL.md skill
gentbajko/capstone · skills/map/SKILL.md · Use when asked to build, refresh, update, or check a codebase's architecture reference docs - "map the codebase"…
git:20260830.b0cf619 · audit A · 5 stars

Browse by kind, by grade A, or by owner.