perf-profile

Analyzes game codebases against performance budgets and generates prioritized optimization recommendations.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Game projects often ship with frame rate drops, memory bloat, and slow load times because performance issues are discovered too late. This Skill performs structured static performance analysis of a codebase, compares findings against defined budgets, and produces a prioritized optimization report before problems reach production. ## Core Features & Use Cases - Budget-Driven Analysis: Loads target FPS, memory, load time, and draw call budgets from design docs, then measures estimated current values against them. - Multi-Domain Hotspot Detection: Scans CPU hot paths (per-frame update loops, allocations, physics queries), memory patterns, rendering costs, and I/O behavior to identify bottlenecks. - Prioritized Report Generation: Outputs a structured report with hotspot tables, ranked optimization recommendations including expected gain and risk, quick wins, and items needing runtime profiling. - Use Case: A developer suspects the enemy AI system is causing frame drops. They run the profiler scoped to that system, receive a report showing an unoptimized entity search in the per-frame update as the top hotspot, and get a concrete fix recommendation with estimated impact. ## Quick Start Use the perf-profile skill to analyze the full project against our 60fps budget and report the top performance hotspots with optimization recommendations.

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 before runtime testing?

Static performance analysis scans per-frame update functions, nested loops, allocation patterns, and physics queries to estimate costs against budgets. This identifies candidate hotspots early, which runtime profiling tools then confirm on target hardware.

How to find frame rate bottlenecks in game code?

Examine per-frame functions like Update or Tick for expensive operations: nested loops over entities, string operations, per-frame allocations, and repeated raycasts. Compare estimated costs against your frame budget, such as 16.67ms for 60fps.

Does static performance analysis replace runtime profilers?

No, static analysis identifies candidate hotspots through code inspection, but runtime profiling on target hardware confirms actual impact. Use static analysis first to prioritize where to point runtime profiling tools.

What performance budgets should a game project define?

Define target frame time (e.g., 16.67ms for 60fps), total and per-system memory limits, load time targets, draw call budgets, and network bandwidth limits for multiplayer. These budgets let you classify findings as OK, warning, or over budget.

When should I optimize versus defer performance fixes?

Optimize immediately for low-effort high-impact fixes. For medium or large effort items, decide between implementing now, reducing feature scope, deferring to a polish phase as a known issue, or escalating to an architectural decision.