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.