{"id":"f4d45ff7-fe61-4985-8945-515f17d65b63","shortId":"5KcBhm","kind":"skill","title":"ue5-performance-packaging","tagline":"UE5.6/UE5.7 performance and packaging readiness workflow. Use when requests involve PIE performance checks, runtime stat review, pre-package validation, build configuration sanity, and release readiness checklists.","description":"# Quick Start\n- Confirm target platform and build configuration.\n- Collect current performance symptoms and packaging goal.\n- Output a pre-package checklist plus measurement plan.\n\n# UE5.7 API Anchors\n- Runtime quality and frame-budget anchors:\n  - `UGameUserSettings::SetOverallScalabilityLevel(...)`\n  - `UGameUserSettings::SetFrameRateLimit(...)`\n  - `UGameUserSettings::ApplySettings(...)`\n- Packaging settings anchors:\n  - `UProjectPackagingSettings`\n  - `BuildConfiguration`, `MapsToCook`, `DirectoriesToAlwaysCook`\n  - `UsePakFile`, `bUseIoStore`, `bGenerateChunks`\n- Asset dependency validation anchors:\n  - `FAssetRegistryModule`, `IAssetRegistry`\n  - `GetAssetsByPath(...)`\n  - `GetDependencies(...)`, `GetReferencers(...)`\n- Profiling instrumentation anchors:\n  - `TRACE_CPUPROFILER_EVENT_SCOPE(...)`\n  - `DECLARE_CYCLE_STAT(...)`\n- Practical runtime stat commands:\n  - `stat unit`, `stat gpu`, `stat scenerendering`, `memreport -full`\n\n# Performance and Packaging Contract\n- Every performance/packaging task must define:\n  - target platform + build config + test map\n  - reproducible capture scenario (camera path, duration, net mode)\n  - baseline metrics and acceptance thresholds\n  - packaging configuration set and dependency scan scope\n  - go/no-go output with explicit blockers\n- If any item is missing, readiness evaluation is incomplete.\n\n# Workflow\n## 1) Reproducible Baseline Capture\n- Freeze test map, camera path, scalability, and net mode.\n- Capture `stat unit` and `stat gpu` under same scenario repeatedly.\n- Use median or percentile metrics, not single-frame spikes.\n\n## 2) Hotspot Isolation\n- Identify top-cost gameplay/render systems in the capture window.\n- Correlate high-cost actors/assets with scene context.\n- Add scoped CPU markers for custom systems when attribution is unclear.\n\n## 3) Asset and Dependency Validation\n- Scan target paths for missing or broken asset references.\n- Query dependencies and referencers for problematic assets.\n- Validate required map/game mode assets are included in package scope.\n\n## 4) Packaging Configuration Validation\n- Check `UProjectPackagingSettings` fields for target release policy.\n- Validate maps-to-cook, always-cook directories, and build configuration.\n- Validate Pak/IoStore/chunk strategy against distribution requirements.\n\n## 5) Package Readiness Trial\n- Run pre-package checklist and dry-run style verification.\n- Isolate first blocking packaging error and dependency chain.\n- Record unresolved blockers with owner and risk.\n\n## 6) Go/No-Go Decision\n- Approve only when metrics and packaging checks meet thresholds.\n- Report remaining risks and recommended mitigation actions.\n- Lock scenario and settings used for sign-off evidence.\n\n# Constraints\n- Do not claim optimization wins without measurable before/after data.\n- Keep profiling scenario reproducible (map, camera path, net mode).\n- Distinguish editor overhead from packaged runtime behavior.\n- Avoid changing quality scalability settings without reporting it.\n- Keep packaging checks deterministic; avoid ad-hoc config toggles during sign-off.\n- Always report metric units (ms, fps, memory) and capture duration.\n\n# Failure Handling\n- Symptom: performance data is noisy across runs.\n  - Locate: non-deterministic scenario setup and background variance.\n  - Fix: lock scenario, warm up run, and compare median/percentile values.\n- Symptom: optimization claims do not reproduce.\n  - Locate: mismatched quality settings, map, or runtime mode.\n  - Fix: publish exact capture config and rerun before/after under same conditions.\n- Symptom: package build fails with long error cascade.\n  - Locate: first blocking error and its direct dependency chain.\n  - Fix: resolve earliest blocker first; rerun to reveal next blockers.\n- Symptom: packaged build launches with missing assets.\n  - Locate: cook list coverage and dependency graph gaps.\n  - Fix: include missing maps/directories and resolve broken references.\n- Symptom: packaged build perf is worse than PIE baseline.\n  - Locate: packaged-only config differences and runtime content path.\n  - Fix: compare packaged config to baseline and align scalability/device settings.\n- Symptom: memory usage regresses near content-heavy scenes.\n  - Locate: high-memory assets and streaming policy behavior.\n  - Fix: reduce resident asset pressure and adjust streaming/cook strategy.\n\n# Packaging Ops\n- Prefer explicit map/cook lists over implicit discovery for release builds.\n- Use AssetRegistry queries to validate dependencies before packaging.\n- Keep one source of truth for release packaging settings per target profile.\n- Re-run readiness checks after any packaging setting change.\n\n# UE5.6 / UE5.7 Compatibility Notes\n- `UGameUserSettings`, `UProjectPackagingSettings`, and AssetRegistry APIs above are stable in UE5.6/UE5.7.\n- `ProjectPackagingSettings.h` lives under `Developer/DeveloperToolSettings` in both versions.\n\n# Escalation\n- Escalate when performance bottleneck requires engine-level profiling or renderer changes.\n- Escalate when packaging issues stem from third-party plugin build failures.","tags":["ue5","performance","packaging","unrealengine5","skills","teixasalone","aec","agent-skills","animations","blender","camera","collisions"],"capabilities":["skill","source-teixasalone","skill-ue5-performance-packaging","topic-aec","topic-agent-skills","topic-animations","topic-blender","topic-camera","topic-collisions","topic-computer-vision","topic-dotnet","topic-embodied-ai","topic-game-framework","topic-gaussian-splatting","topic-graphics"],"categories":["UnrealEngine5-Skills"],"synonyms":[],"warnings":[],"endpointUrl":"https://skills.sh/teixasalone/UnrealEngine5-Skills/ue5-performance-packaging","protocol":"skill","transport":"skills-sh","auth":{"type":"none","details":{"cli":"npx skills add teixasalone/UnrealEngine5-Skills","source_repo":"https://github.com/teixasalone/UnrealEngine5-Skills","install_from":"skills.sh"}},"qualityScore":"0.456","qualityRationale":"deterministic score 0.46 from registry signals: · indexed on github topic:agent-skills · 12 github stars · SKILL.md body (5,091 chars)","verified":false,"liveness":"unknown","lastLivenessCheck":null,"agentReviews":{"count":0,"score_avg":null,"cost_usd_avg":null,"success_rate":null,"latency_p50_ms":null,"narrative_summary":null,"summary_updated_at":null},"enrichmentModel":"deterministic:skill-github:v1","enrichmentVersion":1,"enrichedAt":"2026-05-18T19:07:26.023Z","embedding":null,"createdAt":"2026-05-10T01:06:37.591Z","updatedAt":"2026-05-18T19:07:26.023Z","lastSeenAt":"2026-05-18T19:07:26.023Z","tsv":"'1':163 '2':196 '3':228 '4':259 '5':288 '6':318 'accept':139 'across':412 'action':336 'actors/assets':213 'ad':387 'ad-hoc':386 'add':217 'adjust':561 'align':534 'alway':276,395 'always-cook':275 'anchor':58,65,74,85,93 'api':57,614 'applyset':71 'approv':321 'asset':82,229,240,248,253,491,550,558 'assetregistri':577,613 'attribut':225 'avoid':373,385 'background':421 'baselin':136,165,516,532 'before/after':355,454 'behavior':372,554 'bgeneratechunk':81 'block':305,468 'blocker':152,313,478,484 'bottleneck':631 'broken':239,506 'budget':64 'build':25,38,124,280,460,487,510,575,650 'buildconfigur':76 'buseiostor':80 'camera':131,170,362 'captur':129,166,176,207,403,450 'cascad':465 'chain':310,474 'chang':374,605,639 'check':17,263,327,383,600 'checklist':31,52,296 'claim':350,435 'collect':40 'command':104 'compar':430,528 'compat':608 'condit':457 'config':125,389,451,521,530 'configur':26,39,142,261,281 'confirm':34 'constraint':347 'content':525,543 'content-heavi':542 'context':216 'contract':116 'cook':274,277,493 'correl':209 'cost':202,212 'coverag':495 'cpu':219 'cpuprofil':95 'current':41 'custom':222 'cycl':99 'data':356,409 'decis':320 'declar':98 'defin':121 'depend':83,145,231,243,309,473,497,581 'determinist':384,417 'developer/developertoolsettings':623 'differ':522 'direct':472 'directori':278 'directoriestoalwayscook':78 'discoveri':572 'distinguish':366 'distribut':286 'dri':299 'dry-run':298 'durat':133,404 'earliest':477 'editor':367 'engin':634 'engine-level':633 'error':307,464,469 'escal':627,628,640 'evalu':159 'event':96 'everi':117 'evid':346 'exact':449 'explicit':151,567 'fail':461 'failur':405,651 'fassetregistrymodul':86 'field':265 'first':304,467,479 'fix':423,447,475,500,527,555 'fps':400 'frame':63,194 'frame-budget':62 'freez':167 'full':112 'gameplay/render':203 'gap':499 'getassetsbypath':88 'getdepend':89 'getreferenc':90 'go/no-go':148,319 'goal':46 'gpu':108,181 'graph':498 'handl':406 'heavi':544 'high':211,548 'high-cost':210 'high-memori':547 'hoc':388 'hotspot':197 'iassetregistri':87 'identifi':199 'implicit':571 'includ':255,501 'incomplet':161 'instrument':92 'involv':14 'isol':198,303 'issu':643 'item':155 'keep':357,381,584 'launch':488 'level':635 'list':494,569 'live':621 'locat':414,439,466,492,517,546 'lock':337,424 'long':463 'map':127,169,272,361,443 'map/cook':568 'map/game':251 'maps-to-cook':271 'maps/directories':503 'mapstocook':77 'marker':220 'measur':54,354 'median':187 'median/percentile':431 'meet':328 'memori':401,538,549 'memreport':111 'metric':137,190,324,397 'mismatch':440 'miss':157,237,490,502 'mitig':335 'mode':135,175,252,365,446 'ms':399 'must':120 'near':541 'net':134,174,364 'next':483 'noisi':411 'non':416 'non-determinist':415 'note':609 'one':585 'op':565 'optim':351,434 'output':47,149 'overhead':368 'owner':315 'packag':4,8,23,45,51,72,115,141,257,260,289,295,306,326,370,382,459,486,509,519,529,564,583,591,603,642 'packaged-on':518 'pak/iostore/chunk':283 'parti':648 'path':132,171,235,363,526 'per':593 'percentil':189 'perf':511 'perform':3,6,16,42,113,408,630 'performance/packaging':118 'pie':15,515 'plan':55 'platform':36,123 'plugin':649 'plus':53 'polici':269,553 'practic':101 'pre':22,50,294 'pre-packag':21,49,293 'prefer':566 'pressur':559 'problemat':247 'profil':91,358,595,636 'projectpackagingsettings.h':620 'publish':448 'qualiti':60,375,441 'queri':242,578 'quick':32 're':597 're-run':596 'readi':9,30,158,290,599 'recommend':334 'record':311 'reduc':556 'refer':241,507 'referenc':245 'regress':540 'releas':29,268,574,590 'remain':331 'render':638 'repeat':185 'report':330,379,396 'reproduc':128,164,360,438 'request':13 'requir':250,287,632 'rerun':453,480 'resid':557 'resolv':476,505 'reveal':482 'review':20 'risk':317,332 'run':292,300,413,428,598 'runtim':18,59,102,371,445,524 'saniti':27 'scalability/device':535 'scalabl':172,376 'scan':146,233 'scenario':130,184,338,359,418,425 'scene':215,545 'scenerend':110 'scope':97,147,218,258 'set':73,143,340,377,442,536,592,604 'setframeratelimit':69 'setoverallscalabilitylevel':67 'setup':419 'sign':344,393 'sign-off':343,392 'singl':193 'single-fram':192 'skill' 'skill-ue5-performance-packaging' 'sourc':586 'source-teixasalone' 'spike':195 'stabl':617 'start':33 'stat':19,100,103,105,107,109,177,180 'stem':644 'strategi':284,563 'stream':552 'streaming/cook':562 'style':301 'symptom':43,407,433,458,485,508,537 'system':204,223 'target':35,122,234,267,594 'task':119 'test':126,168 'third':647 'third-parti':646 'threshold':140,329 'toggl':390 'top':201 'top-cost':200 'topic-aec' 'topic-agent-skills' 'topic-animations' 'topic-blender' 'topic-camera' 'topic-collisions' 'topic-computer-vision' 'topic-dotnet' 'topic-embodied-ai' 'topic-game-framework' 'topic-gaussian-splatting' 'topic-graphics' 'trace':94 'trial':291 'truth':588 'ue5':2 'ue5-performance-packaging':1 'ue5.6':606 'ue5.6/ue5.7':5,619 'ue5.7':56,607 'ugameuserset':66,68,70,610 'unclear':227 'unit':106,178,398 'unresolv':312 'uprojectpackagingset':75,264,611 'usag':539 'use':11,186,341,576 'usepakfil':79 'valid':24,84,232,249,262,270,282,580 'valu':432 'varianc':422 'verif':302 'version':626 'warm':426 'win':352 'window':208 'without':353,378 'workflow':10,162 'wors':513","prices":[{"id":"620d04e6-d65f-4fb9-b39c-7c53e4bc808f","listingId":"f4d45ff7-fe61-4985-8945-515f17d65b63","amountUsd":"0","unit":"free","nativeCurrency":null,"nativeAmount":null,"chain":null,"payTo":null,"paymentMethod":"skill-free","isPrimary":true,"details":{"org":"teixasalone","category":"UnrealEngine5-Skills","install_from":"skills.sh"},"createdAt":"2026-05-10T01:06:37.591Z"}],"sources":[{"listingId":"f4d45ff7-fe61-4985-8945-515f17d65b63","source":"github","sourceId":"teixasalone/UnrealEngine5-Skills/ue5-performance-packaging","sourceUrl":"https://github.com/teixasalone/UnrealEngine5-Skills/tree/main/skills/ue5-performance-packaging","isPrimary":false,"firstSeenAt":"2026-05-10T01:06:37.591Z","lastSeenAt":"2026-05-18T19:07:26.023Z"}],"details":{"listingId":"f4d45ff7-fe61-4985-8945-515f17d65b63","quickStartSnippet":null,"exampleRequest":null,"exampleResponse":null,"schema":null,"openapiUrl":null,"agentsTxtUrl":null,"citations":[],"useCases":[],"bestFor":[],"notFor":[],"kindDetails":{"org":"teixasalone","slug":"ue5-performance-packaging","github":{"repo":"teixasalone/UnrealEngine5-Skills","stars":12,"topics":["2d","aec","agent-skills","animations","blender","camera","collisions","computer-vision","dotnet","embodied-ai","game-framework","gaussian-splatting","graphics","machine-learning","ue4-program","unreal-engine","virtual-worlds","webgl","webgl2","webxr"],"license":"mit","html_url":"https://github.com/teixasalone/UnrealEngine5-Skills","pushed_at":"2026-05-18T15:42:31Z","description":"Provide reusable workflows for Unreal Engine 5.6/5.7 to simplify Blueprint, C++, UI, PCG, replication, debugging, and performance tasks.","skill_md_sha":"e672cc951020aea465173700fe05333d516864ca","skill_md_path":"skills/ue5-performance-packaging/SKILL.md","default_branch":"main","skill_tree_url":"https://github.com/teixasalone/UnrealEngine5-Skills/tree/main/skills/ue5-performance-packaging"},"layout":"multi","source":"github","category":"UnrealEngine5-Skills","frontmatter":{"name":"ue5-performance-packaging","description":"UE5.6/UE5.7 performance and packaging readiness workflow. Use when requests involve PIE performance checks, runtime stat review, pre-package validation, build configuration sanity, and release readiness checklists."},"skills_sh_url":"https://skills.sh/teixasalone/UnrealEngine5-Skills/ue5-performance-packaging"},"updatedAt":"2026-05-18T19:07:26.023Z"}}