perf-profile

Generate structured performance profiling reports comparing CPU, memory, rendering, and I/O hotspots against budgets.

Updated Dec 22, 2024
One-click install
npx skills add https://github.com/imgamer/AILearn --skill perf-profile-imgamer
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: perf-profile
Source: https://github.com/imgamer/AILearn/tree/main/game-studios/Claude-Code-Game-Studios-e375f/.claude/skills/perf-profile
Command: npx skills add https://github.com/imgamer/AILearn --skill perf-profile-imgamer

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Perf-profile helps you turn vague performance complaints into a structured profiling workflow that identifies bottlenecks, compares them against explicit budgets, and produces prioritized optimization recommendations.

Core Features & Use Cases

  • Profiling scope selection: Focus on a single system name or run a comprehensive full-profile across systems.
  • Budget-driven analysis: Load and apply performance targets such as frame time/FPS, memory, load time, draw calls, and (if relevant) network bandwidth.
  • Actionable optimization output: Produce a report with hotspots, estimated impact, fix effort, quick wins, and a decision phase to drive next actions.

Example use case: You suspect occasional frame drops and long level-load times; run perf-profile to estimate where CPU/memory/rendering/I/O budgets are exceeded, then follow the Fix Effort priorities to decide what to implement next.

Quick Start

Run perf-profile with the argument "full" to generate a comprehensive performance profile across all systems and a prioritized list of optimization next steps.

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 bottlenecks and frame-time instability in a game performance profiling report?

Performance profiling identifies bottlenecks by comparing estimated CPU, memory, rendering, and I/O hotspots against defined performance budgets. It evaluates frame-time stability to produce a prioritized list of optimization recommendations with estimated impact and fix effort.

What is the best way to prioritize game optimization fixes when memory growth and load-time delays exceed budgets?

Prioritizing game optimization fixes involves comparing memory growth and load-time delays against performance budgets. This generates a decision workflow ranking fixes by estimated impact and effort, highlighting quick wins to drive next actions.

Can I profile draw-call pressure and multiplayer network constraints without writing files?

Yes, you can profile draw-call pressure and network constraints using a read-only decision workflow. It estimates rendering costs and multiplayer bandwidth hotspots against budgets, generating optimization recommendations without writing files.

How do I start a full performance profiling investigation across all systems?

To start a comprehensive performance profiling investigation, run the tool with the "full" argument. This evaluates all systems, comparing CPU and memory hotspots against budgets to output a prioritized optimization roadmap.

Does memory budgeting work for both single-system scope and full-system performance investigations?

Memory budgeting works for both single-system and full-system performance investigations. You can focus profiling on a specific system name or run a comprehensive profile to estimate memory growth and I/O hotspots across all systems.