repo-map-codex

Generate a project map and evidence catalog in markdown from repository files.

18|1|Updated Mar 19, 2026
One-click install
npx skills add https://github.com/dachent/skills --skill repo-map-codex
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: repo-map-codex
Source: https://github.com/dachent/skills/tree/main/repo-map-codex
Command: npx skills add https://github.com/dachent/skills --skill repo-map-codex

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This skill eliminates planning ambiguity by automatically generating a grounded project map and evidence catalog, ensuring that subsequent development is based on verified repository facts rather than assumptions.

Core Features & Use Cases

  • Multi-Mode Discovery: Automatically detects project types including software-git, software-no-git, business-artifact, and mixed-business-coding.
  • Evidence Cataloging: Systematically logs project dependencies, validation surfaces, and risk areas into durable markdown artifacts.
  • Use Case: When starting a new development task in an unfamiliar codebase, use this skill to generate a comprehensive map of entrypoints, dependencies, and current project status before writing a single line of code.

Quick Start

Invoke the repo map codex skill to analyze the current directory and generate the project evidence catalog and map.

Frequently Asked Questions about repo-map-codex

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

FAQPage Schema
How do I map repository dependencies and risks before starting development in an unfamiliar codebase?

A project map and evidence catalog systematically logs project dependencies, validation surfaces, and risk areas into durable markdown artifacts. This eliminates planning ambiguity by ensuring subsequent development uses verified repository facts rather than assumptions.

What's the best way to ground AI project planning in actual repository data instead of assumptions?

The best way to ground AI project planning in actual repository data is to generate an evidence catalog that systematically logs dependencies and validation surfaces. This approach grounds planning in verified repository facts, eliminating planning ambiguity for subsequent development tasks.

Can I generate project maps for non-software directories like business artifact collections?

Yes, project maps can be generated for business artifact collections. Multi-mode discovery automatically detects project types including software-git, software-no-git, business-artifact, and mixed-business-coding to identify dependencies, risks, and validation surfaces across diverse project structures.

How do I generate an evidence catalog to identify validation surfaces in my project?

You generate an evidence catalog by analyzing your current directory to identify validation surfaces, dependencies, and risk areas. The process requires read-only filesystem access to read project data and the ability to write structured markdown artifacts to a dedicated planning directory.

Does the repository mapping process work with projects that do not use Git?

Yes, the repository mapping process works with projects that do not use Git. Multi-mode discovery automatically detects software-no-git project types alongside software-git, business-artifact, and mixed-business-coding configurations to map dependencies and risks.

What filesystem permissions are needed to catalog project dependencies and risk areas?

Cataloging project dependencies and risk areas requires read-only access to the project filesystem for analysis and the ability to write structured markdown artifacts to a dedicated planning directory to store the evidence catalog and project map.