skills.rest
FrancisVarga
FrancisVargaCOMMUNITY
Explore all skills by this author →
GitHub

perf-profile

Generate a structured performance profiling workflow identifying CPU, memory, rendering, and I/O bottlenecks.

Updated May 13, 2026
Search Tags:#game optimization#performance profiling#load time#CPU hotspots#optimization roadmap#memory budgeting#rendering draw calls
One-click install
npx skills add https://github.com/FrancisVarga/the-dream-machine --skill perf-profile-francisvarga
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: perf-profile
Source: https://github.com/FrancisVarga/the-dream-machine/tree/main/.claude/skills/perf-profile
Command: npx skills add https://github.com/FrancisVarga/the-dream-machine --skill perf-profile-francisvarga

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It eliminates guesswork about where performance time and memory are going by generating a structured profiling workflow tied to explicit performance budgets.

Core Features & Use Cases

  • Budget-driven performance profiling: Loads target FPS/frame time, memory, load time, draw-call, and (if relevant) network bandwidth limits to judge results against expectations.
  • Codebase hotspot identification: Pinpoints likely CPU, memory, rendering, and I/O bottlenecks by targeting common “hot path” functions and patterns (per-frame costs, allocations, expensive queries, overdraw, missing LOD/occlusion, sync asset loading, frequent network messages).
  • Optimization plan output with prioritization: Produces a report including budgets vs estimates, a ranked list of recommendations with expected gain and risk, plus quick wins and items requiring deeper investigation or architectural decisions.
  • Decision + next steps orchestration: Guides the user to implement, reduce scope, defer, or escalate for architecture when fix effort is significant.

Quick Start

Run perf-profile on your game to generate a budget-aware performance report and optimization recommendations for the targeted system, using either its system name or the argument full.

Frequently Asked Questions about perf-profile

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

FAQPage Schema
How do I identify CPU hotspots and memory bottlenecks in my game?▼

Game performance profiling pinpoints CPU, memory, rendering, and I/O bottlenecks by targeting common hot path functions like per-frame costs, allocations, and expensive queries. It generates a structured workflow tied to explicit budgets.

What is budget-driven performance profiling for game optimization?▼

Budget-driven performance profiling loads target FPS, frame time, memory, load time, and draw-call limits to judge profiling results against expectations. It eliminates guesswork about where performance time and memory are going.

How do I create an optimization roadmap for rendering draw calls and load times?▼

An optimization roadmap produces a ranked list of recommendations with expected gain and risk, plus quick wins and items requiring deeper investigation. It scopes next-actions based on fix effort to implement, defer, or escalate.

Can I run a full-project performance analysis for suspected regressions?▼

You can run a comprehensive full-project analysis for suspected performance regressions and budget overruns. The workflow applies to profiling a named system or analyzing the entire project using the full argument.

When should I escalate optimization fixes for architectural decisions?▼

You should escalate optimization fixes when significant fix effort is required. The profiling workflow guides you to implement, reduce scope, defer, or escalate for architecture based on the estimated effort.

Why does my game exceed its memory budget during per-frame allocations?▼

Memory budget overruns often stem from common hot path allocations and expensive queries. Performance profiling identifies these bottlenecks and provides ranked recommendations with estimated impact to address them.

Related Skills

Explore More Software Engineering Skills→
jame581jame581
538

godot-optimization

Profile Godot 4.3+ projects to identify and remove performance bottlenecks.

Community
Advanced
whmathews15whmathews15
1

tech-debt

Review technical debt mentions and generate a prioritized inventory with impact and effort classifications.

Community
Intermediate
j0KZj0KZ

performance-profiler

Profile CPU usage, memory leaks, and bundle size in Node.js and browsers.

Community
Advanced
dyCuong03dyCuong03
6

wave4-world-update-allocator-per-frame-native

Allocate per-frame NativeArrays via WorldUpdateAllocator in Unity DOTS.

Community
Intermediate