uvs-understand

Generate structured architecture and stack maps from codebases.

2|Updated Apr 11, 2026
One-click install
npx skills add https://github.com/utsavanand/uv-suite --skill uvs-understand
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: uvs-understand
Source: https://github.com/utsavanand/uv-suite/tree/main/skills/uvs-understand
Command: npx skills add https://github.com/utsavanand/uv-suite --skill uvs-understand

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Entering a new codebase or multi-service system is hard; you need an accurate map of architecture, domains, entry points, and data flows to plan work and avoid blind spots.

Core Features & Use Cases

  • Repo mode maps a single codebase to an architecture overview, domain map, and key entry points.
  • Stack mode maps multiple services to show how they connect (REST, queues, shared DBs/libs) and identify danger zones.
  • Use case: onboarding to a new project, generate a documented map you can reference.

Quick Start

Provide a target path to map, and the skill will generate architecture and stack maps in the session output.

Frequently Asked Questions about uvs-understand

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

FAQPage Schema
How do I map the architecture and domains of a new codebase?

To map codebase architecture and domains, provide a target repository path. The skill generates an architecture overview, domain map, and key entry points to document the system structure.

Can I map multiple services to see how they connect across a stack?

Yes, you can map multiple services using stack mode. It generates a stack map showing service connections via REST, queues, and shared databases, while identifying architectural danger zones.

What is the best way to identify entry points and data flows in a repository?

Identifying entry points and data flows requires analyzing the codebase structure. This skill processes the target path to produce a structured repo-model map highlighting domains, connections, and key data flows.

Does this tool work with both single repositories and multi-service stacks?

Yes, it works with both single repositories and multi-service stacks. Repo mode maps a single codebase, while stack mode maps multiple services to show connections and identify danger zones.

How do I generate diagrams for a codebase architecture?

To generate architecture diagrams, provide a target path for the codebase or stack. The skill produces graphify-based diagrams and provenance-stamped output files in the session directory.

When should I use stack mode instead of repo mode for codebase mapping?

Use repo mode to map a single codebase to an architecture overview and domain map. Use stack mode when mapping multiple services to understand connections, shared libraries, and danger zones.