perf-profile

Profile game codebases and generate markdown reports with prioritized performance recommendations.

Updated Apr 10, 2026
One-click install
npx skills add https://github.com/polsegu/Claude-Code-Game-Dev --skill perf-profile-polsegu
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: perf-profile
Source: https://github.com/polsegu/Claude-Code-Game-Dev/tree/main/.claude/skills/perf-profile
Command: npx skills add https://github.com/polsegu/Claude-Code-Game-Dev --skill perf-profile-polsegu

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill provides a structured, measurable workflow for finding performance bottlenecks in a game codebase, estimating impact against defined budgets, and producing prioritized, actionable optimization recommendations.

Core Features & Use Cases

  • Scoped Profiling: Accepts a specific system name or full to target per-system analysis or a comprehensive project-wide profile.
  • Budget-Aware Analysis: Loads performance budgets (frame time, memory, draw calls, load times, network limits) from design docs and compares estimates against targets.
  • Multi-Domain Targets: Identifies CPU hotspots, memory growth, rendering inefficiencies, and I/O/network concerns with suggested fixes and estimated gains.
  • Prioritized Reporting: Emits a markdown report listing top hotspots, estimated headroom vs budgets, quick wins, and recommended next actions or escalation steps.
  • Use Case: Use this Skill to analyze a struggling physics subsystem that causes frame drops, get a ranked list of fixes, and decide whether to implement, scope down, or escalate architectural changes.

Quick Start

Run the perf-profile skill for 'full' to generate a prioritized performance profiling report across the entire project.

Frequently Asked Questions about perf-profile

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

FAQPage Schema
How do I find performance bottlenecks in my game codebase?▼

Identify performance bottlenecks by profiling CPU, memory, rendering, I/O, and network subsystems to estimate their impact on frame time and memory against defined budgets.

How do I profile a specific game system causing frame drops?▼

Profile a specific game system by targeting it with a scoped analysis instead of a full-project profile, estimating headroom against frame time budgets to produce ranked optimization fixes.

What is budget-aware performance profiling?▼

Budget-aware performance profiling compares estimated CPU hotspots, memory growth, and rendering inefficiencies against targets loaded from design docs to prioritize recommended next actions.

Can I analyze rendering inefficiencies and memory growth without modifying game files?▼

Yes, you can analyze rendering inefficiencies, memory growth, and CPU hotspots without modifying game files, producing a markdown profiling report with prioritized recommendations and next-step actions.

What's the best way to prioritize performance optimization recommendations?▼

Prioritize performance optimization recommendations by comparing estimated headroom against frame time and memory budgets, categorizing quick wins, and outlining architectural escalation steps in a markdown report.

Does game performance profiling work for per-system analysis or full-project profiling?▼

Game performance profiling works for both per-system analysis and full-project profiling, accepting a specific system name or 'full' to generate a comprehensive prioritized profiling report.