perf-profile

Identify game performance bottlenecks and produce prioritized optimization reports.

14|1|Updated Apr 12, 2026
One-click install
npx skills add https://github.com/Euraika-Labs/Codex-Code-Game-Studios --skill perf-profile-euraika-labs
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: perf-profile
Source: https://github.com/Euraika-Labs/Codex-Code-Game-Studios/tree/main/.agents/skills/perf-profile
Command: npx skills add https://github.com/Euraika-Labs/Codex-Code-Game-Studios --skill perf-profile-euraika-labs

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill provides a structured workflow to identify performance bottlenecks across game systems, measure current behavior against defined performance budgets, and produce prioritized, actionable optimization recommendations to meet target FPS, memory, and load-time goals.

Core Features & Use Cases

  • Scope selection: Focus profiling on a specific system name or run a full-system profile across the entire project.
  • Performance budget alignment: Load and compare against target FPS, memory, draw call, load time, and network budgets from design docs or AGENTS.md.
  • Static analysis targets: Suggest CPU, memory, rendering, and I/O hotspots to inspect (e.g., Update/_process hotspots, allocation patterns, overdraw, shader complexity, sync asset loads).
  • Reporting and prioritization: Generate a structured markdown report listing hotspots, estimated impact, fix effort, quick wins, and next-step decisions for scheduling or escalation.
  • Use Case: Run against the rendering system to find draw-call and shader hotspots that push frame time over a 16.67ms budget and receive prioritized fixes and timeline options.

Quick Start

Run the perf-profile skill specifying a system name or the keyword full to generate a prioritized performance profiling report.

Frequently Asked Questions about perf-profile

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

FAQPage Schema
How do I identify and prioritize game performance bottlenecks?

Game performance profiling requires access to your project codebase, design performance budgets, and optionally runtime profiling data. You receive a structured markdown report comparing current hotspots against target FPS, memory, and load-time goals to guide optimization scheduling.

Can I profile a specific game system instead of the whole project?

Yes, you can target a specific game system or run a full-system profile across the entire project codebase. Specifying a system name scopes the analysis to relevant CPU, memory, rendering, or I/O hotspots to produce focused optimization recommendations.

How do I check my game's frame time against a 16.67ms budget?

You check frame time by loading target FPS and draw call budgets from design docs to compare against current profiling data. This budget alignment highlights rendering and shader hotspots pushing frame time over the 16.67ms limit, providing prioritized quick wins and fixes.

What is performance budget alignment for game optimization?

Performance budget alignment is comparing current CPU, memory, rendering, and I/O behavior against defined target limits from design docs. It measures current hotspots against target FPS, draw calls, and load-time goals to produce prioritized optimization recommendations.

Does game performance profiling work without runtime profiling data?

Yes, game performance profiling works without runtime data by performing static analysis on the project codebase to suggest hotspots like allocation patterns and shader complexity. However, providing runtime profiling data and design budgets yields more accurate budget comparisons and prioritized fixes.