project-map

Discover git repositories and generate consolidated multi-repo project documentation.

Updated Feb 7, 2026
One-click install
npx skills add https://github.com/VitorAndTxr/omni-sw --skill project-map-vitorandtxr
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: project-map
Source: https://github.com/VitorAndTxr/omni-sw/tree/main/skills/project-map
Command: npx skills add https://github.com/VitorAndTxr/omni-sw --skill project-map-vitorandtxr

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Multi-repo project mapping and documentation automation that reconciles fragmented repos into a single, navigable project documentation set. It automatically discovers all git repositories under a root, maps each repository in parallel via background Task agents invoking /repo-map, and aggregates results into consolidated project-level documentation including cross-repo service maps and diagrams.

Core Features & Use Cases

  • Discover all repositories under a project root (one level deep) and skip non-relevant directories such as docs, node_modules, and .git.
  • Map each repository in parallel via background Task agents invoking /repo-map.
  • Aggregate artifacts into project-level documentation: cross-repo service maps, shared diagrams, inter-service workflow docs, and an auto-generated CLAUDE.md with progressive disclosure optimization.
  • Use cases: onboarding to a multi-repo project, mapping all repositories, generating architecture documentation for multi-repo projects.

Quick Start

Run the project-map skill at your project root to discover repositories, map them in parallel, and generate consolidated project documentation.

Frequently Asked Questions about project-map

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

FAQPage Schema
How do I generate architecture documentation for a multi-repo project?

To generate architecture documentation for a multi-repo project, use automated repository discovery and parallel mapping to aggregate artifacts into consolidated cross-repo service maps and inter-service workflow docs.

What is the best way to automate onboarding documentation across multiple repositories?

Automating onboarding documentation across multiple repositories involves discovering all git repositories under a project root and mapping them in parallel to produce standardized, navigable project-level docs.

Can I automatically generate a CLAUDE.md file for a multi-repo environment?

Yes, you can automatically generate a CLAUDE.md file for a multi-repo environment by aggregating mapped repository artifacts with progressive disclosure optimization into a single project-level file.

How does parallel repository mapping work for cross-repo architecture documentation?

Parallel repository mapping works by dispatching background Task agents to invoke /repo-map on each discovered repository, aggregating the results into cross-repo architecture documentation and shared diagrams.

Does multi-repo project mapping skip non-relevant directories like node_modules and docs?

Yes, multi-repo project mapping skips non-relevant directories such as docs, node_modules, and .git during repository discovery to ensure only relevant codebases are mapped and documented.

What are the limitations of automated project-level documentation generation for multi-repo projects?

A limitation of automated project-level documentation generation is that repository discovery only searches one level deep under the project root, missing nested repositories in deeper directory structures.