repo-mapping

Construct and maintain AST-based repository maps tracking symbols and imports.

951|110|Updated Jan 15, 2026
One-click install
npx skills add https://github.com/agent-sh/agentsys --skill repo-mapping-agent-sh
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: repo-mapping
Source: https://github.com/agent-sh/agentsys/tree/main/.kiro/skills/repo-mapping
Command: npx skills add https://github.com/agent-sh/agentsys --skill repo-mapping-agent-sh

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Automatically organize and maintain a cached AST-based map of repository symbols and imports to speed code intelligence and drift detection.

Core Features & Use Cases

  • Build an AST-based repository map on demand
  • Update maps incrementally as the codebase changes
  • Validate map output with a map-validator to ensure consistency
  • Use cases include dependency analysis and cross-file symbol tracing in large repos.

Quick Start

Ask your AI to generate or refresh the repo map for your current project state.

Frequently Asked Questions about repo-mapping

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

FAQPage Schema
How do I build an AST-based repository map for a large monorepo?

To build an AST-based repository map, you can initialize the mapping process on demand to track symbols and imports across your codebase. This requires ast-grep for parsing and validates the cached output to ensure consistency.

What is AST-based repo mapping used for in code analysis?

AST-based repo mapping is used to automatically organize cached repository symbols and imports. It speeds up code intelligence, enables cross-file symbol tracing, and detects drift in large codebases.

Can I update my repository map incrementally as the codebase changes?

Yes, you can update the repository map incrementally as your codebase changes. This maintains an accurate cached map of symbols and imports without needing to rebuild the entire structure from scratch.

Do I need ast-grep to parse symbols and imports for code mapping?

Yes, ast-grep is required to parse symbols and imports for code mapping. The Skill uses ast-grep for parsing and stores the validated mapping results in platform state directories.

How does a map-validator ensure consistency during symbol tracing?

A map-validator ensures consistency by validating the AST-based map output after generation or incremental updates. This guarantees the cached repository symbols and imports accurately reflect the current codebase state.

Does AST-based repo mapping work across multiple programming languages?

Yes, AST-based repo mapping applies to large monorepos across multiple languages. It tracks symbols and imports on demand, enabling cross-file dependency analysis regardless of the specific language used.