# Repo Map

> Use when you need to understand repository structure, ownership boundaries, or where to make a change.

- Skill: `davidondrej/repo-map` (Agent Skill)
- Install (CLI): `npx skillmds@latest add davidondrej/repo-map`
- Raw SKILL.md: https://api.skillmd.com/api/skills/davidondrej/repo-map/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: David Ondrej (https://skillmd.com/u/davidondrej)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/davidondrej/repo-map

---


# Repo Map

Use this skill before making structural assumptions about a workspace.

## Steps

1. Run `pwd`.
2. Run `rg --files | head -200` if `rg` is available.
3. If `rg` is unavailable, run `find . -maxdepth 3 -type f | sort | head -200`.
4. Read the root `AGENTS.md`.
5. Read the nearest nested `AGENTS.md` before editing a subdirectory.
6. Summarize the important directories and likely edit targets.

## Notes

Prefer real file inspection over guessing from names.