skills.rest
MisterVitoPro
MisterVitoProCOMMUNITY
Explore all skills by this author →
GitHub

code-atlas:map

Scan a codebase to generate atlas.json and state.json architecture indexes.

Updated Jul 1, 2026
Search Tags:#codebase#code-analysis#gitignore#atlas#artifact-generation#claude-plugin#architecture-index
One-click install
npx skills add https://github.com/MisterVitoPro/qa-swarm --skill code-atlas-map
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: code-atlas:map
Source: https://github.com/MisterVitoPro/qa-swarm/tree/main/plugins/code-atlas/skills/map
Command: npx skills add https://github.com/MisterVitoPro/qa-swarm --skill code-atlas-map

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill scans a repository to produce a machine-readable architecture index by generating atlas.json and state.json under .code-atlas/, enabling Claude to understand the codebase without a full manual exploration. It also updates .gitignore to exclude the generated cache when present and is designed to run once on a new codebase to bootstrap session understanding.

Core Features & Use Cases

  • Generates atlas.json and state.json under .code-atlas/ as a curated architecture index for quick session reads.
  • Appends .code-atlas/ to .gitignore when present to keep caches out of version control.
  • Runs on full repository or a scoped path to bootstrap Claude’s understanding for new codebases.

Quick Start

Run this skill to scan your repository and generate the architecture index under .code-atlas/.

Frequently Asked Questions about code-atlas:map

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

FAQPage Schema
How do I generate a codebase architecture index for Claude to understand my repository?▼

You can generate a codebase architecture index by scanning your repository to produce atlas.json and state.json under .code-atlas/. This architecture index allows Claude to quickly read and understand the codebase without requiring full manual exploration.

What is the best way to bootstrap Claude's understanding of a new codebase?▼

The best way to bootstrap Claude's understanding is to run a repository scan that generates a curated architecture index. This produces a machine-readable architecture index under .code-atlas/, enabling Claude to quickly read the codebase structure when starting a new session.

Can I scan a specific directory path instead of the full repository for architecture indexing?▼

Yes, you can scan a scoped path instead of the full repository. The codebase architecture index generation operates on either the entire repository or a user-specified path, producing the same atlas.json and state.json artifacts under .code-atlas/.

Does generating a codebase architecture index update my .gitignore file?▼

Yes, generating a codebase architecture index conditionally updates .gitignore. It appends the .code-atlas/ directory to .gitignore when present, ensuring the generated cache files are kept out of version control.

What files are created when scanning a codebase to produce an architecture index?▼

Scanning a codebase to produce an architecture index creates atlas.json and state.json under the .code-atlas/ directory. It also records a baseline commit and timing data for reproducibility during the bootstrap process.

Related Skills

Explore More Software Engineering Skills→
Monjyu1101Monjyu1101
1

gitnexus-explorer

Index a codebase into a knowledge graph with GitNexus and expose an interactive web UI.

Community
Advanced
hammadurrehman2006hammadurrehman2006

codebase-discovery-expert

Map large codebases and produce compact Markdown summaries of modules and entry points.

Community
Advanced
anderson-0anderson-0
4

architecture-map

Generate Mermaid architecture diagrams from source code with dependency analysis.

Community
Advanced
thornboothornboo

codebase-visualizer

Generate an interactive HTML codebase map from a repository structure.

Community
Basic