perf-profile

Analyzes game codebases to identify performance bottlenecks and generate prioritized optimization reports.

13|Updated Jul 30, 2026
One-click install
npx skills add https://github.com/frabcd/codex-ai-game-studio --skill perf-profile-frabcd
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: perf-profile
Source: https://github.com/frabcd/codex-ai-game-studio/tree/main/plugins/ai-game-studio/skills/perf-profile
Command: npx skills add https://github.com/frabcd/codex-ai-game-studio --skill perf-profile-frabcd

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Game projects often suffer from frame drops, memory bloat, and slow load times without a clear picture of where the problems are. This Skill performs a structured static performance analysis of your codebase, compares findings against defined budgets, and produces a prioritized optimization report. ## Core Features & Use Cases - Budget-Aware Analysis: Loads target FPS, memory, load time, and draw call budgets from design docs or AGENTS.md, then flags each metric as OK, WARNING, or OVER. - Multi-Domain Hotspot Detection: Scans CPU hot paths (per-frame update loops, allocations, physics queries), memory patterns, rendering costs (draw calls, overdraw, shaders), and I/O behavior. - Prioritized Recommendations: Outputs a report with hotspots ranked by estimated impact and fix effort, quick wins, and decision options for large fixes including scope reduction or architectural escalation. - Use Case: A Unity or Godot project misses its 60fps target. Run a full profile to get a table of hotspots with estimated frame-time impact, then decide which optimizations to implement now versus defer to the Polish phase. ## Quick Start Use the perf-profile skill to run a full performance profile of this project against our 60fps budget and list the top hotspots.

Frequently Asked Questions about perf-profile

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

FAQPage Schema
How do I profile game performance without runtime tools?

Static analysis scans per-frame update functions, allocation patterns, physics queries, and rendering code to estimate costs against budgets. It identifies candidate hotspots, but runtime profiling on target hardware is still needed to confirm actual impact.

How to find frame rate bottlenecks in Unity or Godot projects?

Examine Update, _process, and Tick functions for nested loops, string operations, per-frame allocations, and expensive physics raycasts. Compare estimated costs against your frame budget, such as 16.67ms for 60fps, to rank hotspots by impact.

Does this skill work with both Unity and Godot engines?

Yes, the analysis targets engine-agnostic patterns including Update, _process, and Tick functions across Unity, Godot, Unreal, and browser projects. It adapts profiling targets based on the codebase it inspects.

Can static analysis replace runtime profiling tools?

No, static analysis identifies candidate hotspots and estimates impact, but it cannot measure actual runtime behavior. The skill explicitly flags items requiring runtime profiling on target hardware to confirm before optimizing.

What happens when a performance fix requires major effort?

For medium or large fixes, the skill presents options: implement the optimization, reduce feature scope, defer to the Polish phase as a known issue, or escalate to an architectural decision. Deferred items are recorded in the report.