dev-codebase-exploration

Explores Unity codebases using token-efficient breadth-first analysis and targeted YAML searches.

Updated Apr 13, 2026
One-click install
npx skills add https://github.com/Unity-UPM-Packages/Antigravity-skills --skill dev-codebase-exploration-unity-upm-packages
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: dev-codebase-exploration
Source: https://github.com/Unity-UPM-Packages/Antigravity-skills/tree/main/.agents/skills/dev-codebase-exploration
Command: npx skills add https://github.com/Unity-UPM-Packages/Antigravity-skills --skill dev-codebase-exploration-unity-upm-packages

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Exploring an unfamiliar Unity project often wastes tokens on third-party packages, massive YAML files, and irrelevant implementation details. This Skill enforces a disciplined, token-efficient exploration procedure so you can understand project architecture without burning context on noise. ## Core Features & Use Cases - Token Protection Rules: Blocks searches and reads inside Packages/, Library/, and Plugins/ directories by default, and forbids full reads of .prefab, .unity, and .asset files in favor of targeted grep searches. - 5-Step Exploration Workflow: Guides analysis from high-level directory scans through assembly definitions, entry points, and interface contracts before any deep implementation dive. - Structured Reporting: Produces a Mermaid architecture diagram, an execution flow summary, and an explicit declaration of what was deliberately skipped. - Use Case: When joining a new Unity project, ask for an overview and receive a module dependency map and initialization flow explanation without reading a single third-party package file. ## Quick Start Ask the assistant to explain how this Unity project is structured and how its main modules work together.

Frequently Asked Questions about dev-codebase-exploration

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

FAQPage Schema
How do I understand a new Unity project codebase quickly?▼

Start with a breadth-first scan of the Assets/ directory, then read README and .asmdef files to map module dependencies. Next find entry points like Bootstrapper.cs or GameManager.cs, review interfaces and data models, and only then read concrete implementations relevant to your question.

How to explore Unity code without wasting tokens on third-party code?▼

Exclude Packages/, Library/, and Plugins/ directories from all searches and reads unless investigating a related compile error. Focus analysis on Assets/ and use assembly definition files to understand module boundaries before opening any C# files.

Can I read Unity prefab and scene files directly?▼

Reading entire .prefab, .unity, or .asset files is discouraged because they are massive YAML documents. Instead use grep searches for specific component names, variables, or m_FileID references to extract only the information you need.

When should I read Unity ProjectSettings files?▼

Read files inside ProjectSettings/ only when the task directly relates to rendering, physics, input, or build pipeline issues. For general architecture exploration, these files are out of scope and consume unnecessary context.

What are the limitations of automated codebase exploration?▼

Breadth-first exploration deliberately skips areas like UI prefabs, networking packages, and third-party integrations to conserve tokens. The output includes a blind spots declaration so you can request targeted deep dives into skipped areas when needed.