This skill teaches an agent to write Unreal Engine 5.8 gameplay C++ that compiles the first time and survives garbage collection. It covers UCLASS and UPROPERTY reflection, where logic belongs in the Gameplay Framework, default subobjects, and the module dependencies that cause unresolved external symbol errors.
It also has the agent prove its work from a terminal: build the editor target, run automation tests headless and read the report, and name the checks it ran.
What You Get
- A workflow that starts from the uproject file, the Modules list and Build.cs
- A reflected actor pattern with a GC-safe component, and a C++ automation test pattern
- A reference on runtime components, TObjectPtr, TWeakObjectPtr, TStrongObjectPtr and FGCObject, USTRUCT and UENUM data, and OnRep replication
- Build and headless test commands for Windows, Linux and macOS
- A gotcha list covering UHT errors, linker errors, Live Coding after header changes and missing Super calls
Common Use Cases
- Fixing GENERATED_BODY, UHT or unresolved external symbol errors
- Tracking down a random crash caused by a raw UObject pointer freed by the garbage collector
- Creating Actor, Pawn, Character or component classes that match the project’s module layout
- Adding C++ automation tests and running them without opening the editor
What Makes It Unique
The skill is pinned to Unreal Engine 5.8 and treats compiling as the first test: the agent must say which commands it ran and paste the result lines, since it should compile is not a check. It warns that a wrong test filter runs nothing and still looks clean. Blueprints, input, AI and packaging each go to their own skill.
Under The Hood
The agent loads the SKILL.md and reads the components and garbage collection reference when it needs it. It reads your uproject file, module list and Build.cs, writes C++ source and test files, and runs shell commands: the engine build script to compile the editor target and the editor command line to run automation tests headless and export a report. It does not fetch web pages itself. An optional Epic editor connection can run tests in a live editor.