skills.rest
avifenesh
avifeneshCOMMUNITY
Explore all skills by this author →
Website𝕏@avi_feneshGitHub

repo-mapping

Generate and maintain AST-based repository maps of symbols and imports with ast-grep.

951|110|Updated Jan 15, 2026
Search Tags:#multi-language#imports#ast-grep#code-analysis#symbols#repo-map
One-click install
npx skills add https://github.com/avifenesh/awesome-slash --skill repo-mapping
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: repo-mapping
Source: https://github.com/avifenesh/awesome-slash/tree/main/plugins/repo-map/skills/repo-mapping
Command: npx skills add https://github.com/avifenesh/awesome-slash --skill repo-mapping

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps developers quickly create and maintain an AST-based map of repository symbols and imports using ast-grep, enabling faster code understanding and analysis.

Core Features & Use Cases

  • Generate on demand: create a cached map of repository symbols and imports for quick analysis and drift detection.
  • Update incrementally: refresh the map as the codebase evolves, without rebuilding from scratch.
  • Validate outputs: ensure the map is consistent with the actual codebase using a map-validator.

Quick Start

Ask me to init or update the repo map to begin generating and validating your AST-based map.

Frequently Asked Questions about repo-mapping

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

FAQPage Schema
How do I generate an AST-based repo map for symbols and imports?▼

An AST-based repo map uses ast-grep to parse your codebase and extract a cached map of repository symbols and imports, enabling quick code understanding, analysis, and drift detection across multi-language projects.

Can I update a repository map incrementally as the codebase evolves?▼

Yes, you can update the repository map incrementally to refresh symbols and imports as your codebase evolves, avoiding the need to rebuild the entire AST-based map from scratch each time changes occur.

Does this repo mapping approach work with multi-language codebases?▼

Yes, this repo mapping approach works with multi-language projects by leveraging ast-grep to parse and extract symbols and imports across different programming languages within the same repository map structure.

How do I validate that my repository map matches the actual codebase?▼

You validate the repository map against a map schema using the built-in map-validator, ensuring the extracted AST-based symbols and imports remain consistent with the actual codebase structure.

What happens if ast-grep is not installed when I try to build a repo map?▼

If ast-grep is not installed, the repo mapping process enforces safety checks that require explicit approval before running external tools, preventing automatic execution of uninstalled dependencies.

Where is the generated AST repository map stored?▼

The generated AST repository map is stored in platform state directories, allowing persistent caching of symbols and imports for on-demand access and incremental updates during future codebase analysis.

Related Skills

Explore More Software Engineering Skills→
gmcabritagmcabrita
6

ast-grep

Translate natural language queries into ast-grep YAML rules for structural code search.

Community
Advanced
richardmbaileyrichardmbailey

rb-explain-codebase

Analyze repository structure, control flow, and dependency graphs.

Community
Intermediate
mishahaninmishahanin
10

ast-grep

Translate natural language queries into structural AST patterns for code search.

Community
Advanced
bug-opsbug-ops
55

code-analysis

Analyze code with LSP-powered tools for types, definitions, and references.

Community
Advanced