cathrynlavery

Repo Atlas — AI skill for Claude Code

AI community

A Claude Code skill that builds a persistent context system (atlas) for any git repository — directory trees, entrypoints, architecture docs, and agent on-ramp for fast LLM onboarding.

How to install Repo Atlas

This entry records only its repository, not the path inside it, so there is no exact command to give. Open cathrynlavery/repo-atlas and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What Repo Atlas does

A Claude Code skill that builds a persistent context system (atlas) for any git repository — directory trees, entrypoints, architecture docs, and agent on-ramp for fast LLM onboarding.

Alternatives in AI

Memmy Agent — 🍙 A personal AI agent & local memory hub for all AI agents, gives every AI one shared, fully controlled memor 1k ★
Load AI Docs — Load documentation from their respective websites into local markdown files our agents can use as context 296 ★
Mnem — Git for AI Agent Knowledge 144 ★

README

Repo Atlas

A [Claude Code](https://claude.ai/code) skill that builds a **persistent context system** for any git repository — so engineers and LLM agents can understand your codebase fast with minimal searching.

Built by [@cathrynlavery](https://twitter.com/cathrynlavery) at [founder.codes](https://founder.codes)

What It Does

Run `/repo-atlas` in any project and it will:

Auto-generate a repo map with directory tree, entrypoints, file stats, and changelog
Guide you through writing architecture, domain model, critical flows, state sources, gotchas, and test docs
Add an agent on-ramp to your CLAUDE.md with a two-agent workflow (plan + verify)
Create build targets (make atlas-generate / make atlas-check) for CI integration

The result is a `docs/atlas/` folder with 10 structured docs that any engineer or AI agent can load for instant context.

Pair With Codex

After generating your atlas, use the [Codex skill](https://github.com/cathrynlavery/codex-skill) to get a second opinion. Codex will independently review your atlas docs for accuracy, gaps, and missed gotchas — giving you an automated quality check powered by OpenAI Codex.

/repo-atlas          # Build the atlas
/codex Review my atlas docs for accuracy and completeness

Supports

**Languages:** Python, JavaScript/TypeScript, Go, Rust, Swift, Java, Kotlin, C/C++, C#, PHP, Elixir, Dart

**Build systems:** npm, Cargo, Go modules, pip/pyproject, Gradle, Maven, XcodeGen, SPM, Bundler, CMake, Bazel, Earthly

**CI:** GitHub Actions, GitLab CI, CircleCI, Jenkins, Travis, Azure Pipelines, Bitbucket Pipelines, Cloud Build, CodeBuild

Install

Copy the skill into your Claude Code skills directory:

# Clone and copy
git clone https://github.com/cathrynlavery/repo-atlas.git
cp -r repo-atlas ~/.agents/skills/repo-atlas

# Or just copy the directory manually

Then in any project, say `/repo-atlas` or "map this repo" or "create atlas docs".