Skip to content
SkillModel-led3,148 tokens in use

Performance Optimization

Finds and fixes game frame-rate problems by measurement in Godot, Unity, Unreal or Roblox: CPU or GPU bound first, then the biggest fix.

9,682 stars on the repository Apache License 2.0gamedev-skills/awesome-gamedev-agent-skills · skills/disciplines/performance-optimization
npx skills add gamedev-skills/awesome-gamedev-agent-skills
View source

Install command as written in the repository's README

Skill label

measured from its files

What installing Performance Optimization costs

96tokens idle
3,148tokens in use
5,137tokens, up to

Idle is what sits in context while the skill is installed. In use is its instructions, loaded when it runs. Up to adds the files its instructions link. Counts are approximate, made offline with cl100k_base.

Model dependence Model-led

Script-ledMixedModel-led

Mostly instructions, so how well it works depends on the model that follows them.

This describes the skill's structure, how much of it is scripts. It does not say how well it works.

Touches

Nothing detected: no shell, network, file writes, git or credentials in its files.

Declared tags come from the skill's frontmatter; detected ones from its scripts, its code blocks and the commands it names in inline code. This is detected, not audited.

How it scores

Quality

How well the skill is written, counted from its own files: its frontmatter, its steps, examples, stated output and constraints, its size and whether every file it ships is one it names.How we score it →
Excellent
  • Frontmatter8/15
  • Structure25/25
  • Examples15/15
  • Output7/15
  • Size11/15
  • Resources15/15

Security

Starts at 100 and loses points for each thing in the skill's files that a reader should look at first.How we score it →
Excellent

No findings.

Repository health

Pre-computed score based on development activity, maintenance, community, maturity, and trend momentum.How we score it →
Good
  • Development activity92
  • Maintenance96
  • Community60
  • Maturity24
  • Momentum40

This skill runs one loop: set a budget, measure, find the single bottleneck, fix it, measure again and report the numbers. It turns a complaint such as low FPS or a hitch into a frame-time budget (16.67 ms at 60 FPS), uncaps VSync before measuring and profiles a release-like build.

It lists where each engine reports the CPU and GPU split, then gives fixes that recur: object pooling, fewer draw calls and state changes, and removing per-frame allocations that cause GC spikes.

What You Get

  • A step-by-step measurement workflow that ends in a report of scene, hardware, build type, before and after, bottleneck and fix
  • A table of where Godot, Unity, Unreal and Roblox show the CPU and GPU split
  • A headless Godot script that reports average, p95 and p99 frame time and exits with code 1 when p95 exceeds the budget
  • Patterns for object pooling, batching and instancing, and zero-allocation Update code in Unity

Common Use Cases

  • Diagnosing a game that drops below 60 FPS in big fights
  • Removing a periodic GC hitch caused by allocations in Update
  • Tracking down a hitch the first time an effect or enemy appears
  • Adding a frame-time check to CI

What Makes It Unique

It insists on numbers before changes and lists the measurement traps: VSync hiding headroom, Godot TIME_PROCESS being the worst frame of the last second, editor and Deep Profile timings, mobile thermal throttling and Unity mobile defaulting to 30 FPS. It also says what was measured headless and what still needs the user’s device.

Under The Hood

The skill is instructions and one reference file on profiling and budgets, with no scripts of its own. It tells the agent to run the game and its tools to measure: Godot with VSync disabled and a headless frame-time script, Unity and Unreal profilers and console commands, and Unreal csvprofile, which writes a CSV capture file. It also tells the agent to edit code for pooling and allocation fixes and to ask the user to run phone sessions. It does not fetch web pages or call APIs.

Join founders building with open source

Opinionated takes, migration guides, cost-saving tips, and insights from the open source ecosystem.

Subscribe on SubstackJoin 750+ subscribers