code-map

Generate a YAML codemap of repository structure, API endpoints, and services.

11|7|Updated Apr 2, 2026
One-click install
npx skills add https://github.com/sean-m-cooper/ai_tools --skill code-map-sean-m-cooper
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: code-map
Source: https://github.com/sean-m-cooper/ai_tools/tree/main/skills/code-map
Command: npx skills add https://github.com/sean-m-cooper/ai_tools --skill code-map-sean-m-cooper

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Generates an AI-optimized map of the codebase at the repository root to help AI agents and engineers quickly understand project structure, APIs, services, and conventions.

Core Features & Use Cases

  • Compact, machine-readable codemap.yaml that captures structure, endpoints, models, and dependencies.
  • Facilitates onboarding, codebase exploration, and impact analysis after major changes.
  • Use case: regenerate the map after repo restructures to guide automated tooling and human reviewers.

Quick Start

Generate or refresh the repository codemap at the repository root.

Frequently Asked Questions about code-map

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

FAQPage Schema
How do I generate an AI-optimized codemap for my repository?

Generate an AI-optimized codemap for your repository by running the skill to parse your solution structure, extract API endpoints, catalog services, and output a machine-readable codemap.yaml file at the repository root.

What is the best way to map a codebase architecture for new contributors?

Mapping a codebase architecture for new contributors is best handled by generating a compact YAML codemap that captures top-level directories, dependencies, and models to accelerate onboarding and codebase exploration.

How do I document API endpoints and services after major repository changes?

Document API endpoints and services after major repository changes by regenerating the codemap.yaml file, which automatically parses the updated solution structure and catalogs the modified services and controllers.

Can I use a codemap.yaml file to guide automated codebase tooling?

Yes, you can use a codemap.yaml file to guide automated tooling because it provides a compact, machine-readable representation of your project structure, APIs, services, and conventions for AI agents.

Does the codebase mapping process require any external dependencies?

The codebase mapping process requires no external dependencies, allowing you to directly parse the solution structure and output the YAML codemap at the repository root without installing additional components.

When should I regenerate the repository codemap?

You should regenerate the repository codemap after major changes or repository restructures to ensure the codemap.yaml accurately reflects your current architecture, APIs, and dependencies for impact analysis.