perf-profile

Profile CPU, memory, rendering, and I/O hotspots against performance budgets.

Updated Mar 28, 2026
One-click install
npx skills add https://github.com/scomofo/dragon-forge --skill perf-profile-scomofo
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: perf-profile
Source: https://github.com/scomofo/dragon-forge/tree/main/.agents/skills/perf-profile
Command: npx skills add https://github.com/scomofo/dragon-forge --skill perf-profile-scomofo

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill solves the problem of guessing where performance goes wrong by providing a structured workflow to identify hotspots, measure them against budgets, and produce prioritized optimization recommendations.

Core Features & Use Cases

  • Scope selection for focused or full profiling: Use a specific system name to profile only one area or use full to profile across all systems.
  • Budget-driven analysis: Load performance targets such as frame time/FPS, memory, load time, draw calls, and (when relevant) network constraints, then compare estimates to decide OK/WARNING/OVER.
  • Actionable outputs with prioritization: Generate a report including hotspots and a priority-ordered fix plan with risk and estimated gains, plus quick wins and items needing deeper investigation.

Use Case: If stutter or slow load times appear during a specific gameplay feature (e.g., hatchery progression), profile only that system, map CPU/memory/render/I/O hotspots to the closest budgets, and produce a ranked optimization plan to execute in the next sprint.

Quick Start

Run the perf-profile skill with the argument full to generate a comprehensive performance profile report and prioritize the next optimization actions.

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 affecting game performance?

Performance profiling identifies hotspots by comparing estimated CPU, memory, rendering, and I/O behavior against explicit performance budgets to produce prioritized optimization recommendations.

What is the best way to prioritize game optimization tasks when frame rates drop?

Prioritize game optimization by generating a profiling report that ranks bottlenecks by estimated gains and risk, providing fix-vs-scope-vs-defer-vs-architecture guidance for your next sprint.

How do I profile a specific gameplay system for stutter and slow load times?

Profile specific gameplay systems by passing the system name as an argument to map CPU, memory, render, and I/O hotspots to the closest performance budgets instead of profiling the full codebase.

Can I analyze draw calls and loading behavior against explicit memory budgets?

Yes, budget-driven analysis loads performance targets for frame time, memory, load time, and draw calls, comparing codebase estimates to flag behavior as OK, WARNING, or OVER budget.

Does performance profiling work for whole-repository optimization scenarios?

Yes, performance profiling applies to whole-repository scenarios by using the full argument to analyze all systems, mapping allocation patterns and rendering costs to generate a comprehensive report.

When should I defer fixing a performance hotspot versus changing the architecture?

Use the generated optimization report's fix-vs-scope-vs-defer-vs-architecture guidance to decide whether to apply quick wins, investigate deeper, or defer hotpath fixes based on estimated gains and risk.