# Uloop Get Hierarchy

> Uloop Get Hierarchy is an Agent Skill for apps & automation published in the kurotu/VRCQuestTools repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

Get the Unity scene hierarchy as a structured tree. Use for parent-child structure, descendants, roots, or subtrees under objects the user currently selected.

- Skill name: `uloop-get-hierarchy`
- Category: [Apps & Automation](https://www.openparable.com/skill/apps-automation/1)
- Source: https://github.com/kurotu/VRCQuestTools/blob/HEAD/.claude/skills/uloop-get-hierarchy/SKILL.md
- Repository: kurotu/VRCQuestTools (352 GitHub stars when collected)

## SKILL.md

# npx --yes uloop-cli@2.2.0 get-hierarchy

Get Unity Hierarchy structure from the whole scene, a root path, or selected Hierarchy objects.

Use this for hierarchy structure, especially descendants under the current selection. Use `find-game-objects --search-mode Selected` when you need selected object details or component properties.

## Usage

```bash
npx --yes uloop-cli@2.2.0 get-hierarchy [options]
```

## Parameters

| Parameter | Type | Default | Description |
|-----------|------|---------|-------------|
| `--root-path` | string | - | Root GameObject path to start from |
| `--max-depth` | integer | `-1` | Maximum depth (-1 for unlimited) |
| `--include-components` | boolean | `true` | Include component information |
| `--include-inactive` | boolean | `true` | Include inactive GameObjects |
| `--include-paths` | boolean | `false` | Include full path information |
| `--use-components-lut` | string | `auto` | Use LUT for components (`auto`, `true`, `false`) |
| `--use-selection` | boolean | `false` | Use selected GameObject(s) as root(s). When true, `--root-path` is ignored. |

## Global Options

| Option | Description |
|--------|-------------|
| `--project-path <path>` | Optional. Use only when the target Unity project is not the current directory. |

## Examples

```bash
# Get entire hierarchy
npx --yes uloop-cli@2.2.0 get-hierarchy

# Get hierarchy from specific root
npx --yes uloop-cli@2.2.0 get-hierarchy --root-path "Canvas/UI"

# Limit depth
npx --yes uloop-cli@2.2.0 get-hierarchy --max-depth 2

# Without components
npx --yes uloop-cli@2.2.0 get-hierarchy --include-components false

# Get hierarchy from currently selected GameObjects
npx --yes uloop-cli@2.2.0 get-hierarchy --use-selection
```

## Output

Returns JSON with:
- `message` (string): Human-readable guidance pointing at the saved file
- `hierarchyFilePath` (string): Filesystem path to the JSON file that contains the actual hierarchy data

The hierarchy itself is **not** in the response — it is written to the file at `hierarchyFilePath`. Open that file to read the `Context` and `Hierarchy` payload (GameObject tree, components, etc.).

---

Source: https://www.openparable.com/skill/apps-automation/uloop-get-hierarchy (OpenParable). Cite the canonical URL above.
