directory-maplisted

Maps any directory tree into a structured, agent-readable taxonomy. Use this skill whenever the user wants to understand, document, or index a folder or codebase — including requests like "/directory-map", "map this project", "create a project index", "generate a directory overview", "index this repo", "help me understand what's in this folder", "create a DIRECTORY_MAP", or "build an index of this directory". Works on any language, stack, or project type. Produces three outputs: DIRECTORY_MAP.md (human-readable taxonomy), update-index.py (automated re-indexer), and index.json (machine-readable snapshot with an AgentIngress XML block for LLM context injection).
Idadabhai/directory-map · ★ 1 · Data & Documents · score 75

Install: claude install-skill Idadabhai/directory-map

# Directory Map Skill Produce a semantic audit and automated management framework for any directory. ## Outputs | File | Purpose | |------|---------| | `DIRECTORY_MAP.md` | Human-readable MECE taxonomy + `<AgentIngress>` XML block | | `update-index.py` | Cross-platform Python re-indexer (copy of `scripts/update-index.py`, customised) | | `index.json` | Machine-readable snapshot (generated by running update-index.py) | All outputs land in the target directory root. Nothing is moved, renamed, or deleted. --- ## Phase 1 — Explore the directory Before writing anything, build a mental model of the directory. Do this in parallel: 1. **List top-level items** — count files vs directories, note approximate total size 2. **Find project configs** — search for `package.json`, `pyproject.toml`, `Cargo.toml`, `go.mod`, `pom.xml`, `build.gradle`, `composer.json`, `*.csproj`, `Gemfile`. Read the top-level fields (name, version, dependencies) to determine tech stack and project type. 3. **Find deployment signals** — look for `vercel.json`, `netlify.toml`, `.github/workflows/`, `Dockerfile`, `docker-compose.yml`, `Procfile`, `fly.toml`, `railway.json`. 4. **Find data assets** — count `*.csv`, `*.json` (non-config), `*.parquet`, `*.xlsx`, `*.ipynb`, `*.py` script files 5. **Find documentation** — count `*.md`, `*.pdf`, `*.docx`, `*.txt` 6. **Find CLAUDE.md or agent config files** — note their locations and roles 7. **Detect existing index** — if `DIRECTORY_MAP.md` or `index.