perf-profile

Profile CPU, memory, and rendering budgets to identify performance bottlenecks.

33|8|Updated Mar 26, 2026
One-click install
npx skills add https://github.com/TraftG/opencode-game-studio --skill perf-profile-traftg
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: perf-profile
Source: https://github.com/TraftG/opencode-game-studio/tree/main/.opencode/skills/perf-profile
Command: npx skills add https://github.com/TraftG/opencode-game-studio --skill perf-profile-traftg

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Profiling performance to locate bottlenecks across CPU, memory, and rendering workloads, enabling targeted optimizations within budget constraints.

Core Features & Use Cases

  • Structured profiling workflow collects CPU, memory, and rendering metrics and compares them to budgets.
  • Hotspot detection & prioritized recommendations generates a report with estimated impact, effort, and risk.
  • Use cases include profiling a full game loop, a single subsystem (AI, rendering, physics), or a release build to validate performance targets.

Quick Start

Run perf-profile on your codebase to generate a prioritized performance profile 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 performance bottlenecks in my game build?

To identify performance bottlenecks, profile CPU, memory, and rendering workloads against target hardware budgets using a structured workflow. This process detects hotspots and generates a prioritized report with estimated impact, effort, and risk.

What is the best way to profile a single subsystem like AI or rendering?

The best way to profile a single subsystem like AI or rendering is applying a scoped profiling workflow to that specific codebase. This isolates CPU and memory metrics, comparing them against your defined budgets to highlight localized hotspots.

Do I need source code and target hardware to profile performance?

Yes, you need access to project source code, defined performance budgets, and a target environment to profile performance accurately. These requirements ensure the collected CPU, memory, and rendering metrics reflect real-world constraints.

How does hotspot detection prioritize performance optimization recommendations?

Hotspot detection prioritizes performance optimization recommendations by estimating the impact, effort, and risk of each fix in a structured report. This allows you to target CPU, memory, or rendering bottlenecks that offer the highest value.

Can I validate release build performance targets against memory and rendering budgets?

Yes, you can validate release build performance targets by profiling full-system builds against memory and rendering budgets. This generates a report confirming whether your release build meets the required CPU and hardware constraints.