find-ref

Analyze .uasset references and GameplayTag usage in Unreal Engine projects.

1|1|Updated Dec 1, 2025
One-click install
npx skills add https://github.com/sipherxyz/universal-ue-skills --skill find-ref-sipherxyz
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: find-ref
Source: https://github.com/sipherxyz/universal-ue-skills/tree/main/skills/find-ref
Command: npx skills add https://github.com/sipherxyz/universal-ue-skills --skill find-ref-sipherxyz

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) and assets (resource) components.

What problem does it solve?

This Skill helps Unreal Engine developers quickly identify all assets that reference a specific asset or are referenced by it, and also track the usage of GameplayTags across the project. This is crucial for understanding the impact of changes, refactoring, and cleaning up unused assets.

Core Features & Use Cases

  • Asset Dependency Analysis: Discover which assets use a target asset (referencers) and which assets the target asset uses (dependencies).
  • GameplayTag Tracking: Find all assets that utilize specific GameplayTags, including their child tags.
  • Use Case: Before deleting an asset, use this Skill to ensure no other part of the project relies on it, preventing broken references and runtime errors.

Quick Start

Use the find-ref skill to find all assets that reference the Unreal Engine asset located at //Game/S2/Core_Boss/s2_boss_gaolanying/BP_AnimNotify_SpawnFan.

Frequently Asked Questions about find-ref

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

FAQPage Schema
How do I find asset references and dependencies in an Unreal Engine project?

To find asset references and dependencies, this Skill uses the SipherReferenceFinder commandlet to analyze relationships between .uasset files and identify which assets reference a target or are referenced by it.

What is the best way to track GameplayTag usage across Unreal Engine assets?

Tracking GameplayTag usage across Unreal Engine assets is handled by identifying all assets that utilize specified tags, including their child tags, to understand their impact before refactoring or deletion.

Do I need a specific plugin to run asset dependency analysis in Unreal Engine?

Yes, running asset dependency analysis requires a built S2Editor with the SipherAIBPTools plugin and specific engine and project paths configured to execute the commandlet.

How can I check for broken references before deleting an Unreal Engine asset?

Checking for broken references before deleting an Unreal Engine asset involves analyzing referencers to ensure no other part of the project relies on the target asset, preventing runtime errors.

What are the limitations of using a commandlet for asset refactoring in Unreal Engine?

Limitations of using a commandlet for asset refactoring include requiring exact engine and project paths to execute, and it only tracks specified GameplayTags and .uasset file relationships without detecting external code references.