Skip to main content
affpapa.org
RU EN
skill CX Codex

godot-performance-optimization — Claude Code skill guide

Blueprint for profiling and resolving frame drops, draw call spikes, and memory leaks in Godot. Guides agents to profile before optimizing.

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓ 
npx skills add thedivergentai/Game-Dev-Agentic-Skills --skill godot-performance-optimization -a claude-code
Open on GitHub

What godot-performance-optimization does

This skill provides strict performance rules for Godot projects. It enforces running the built-in Profiler (F3) first to diagnose hot spots across Time, Memory, and Physics tabs before touching code. Common mistakes are flagged immediately: calling get_node() in _process(), running unshielded print() statements in release builds, or spawning instances inside tight loops.

For rendering and physics workloads, the skill details specific architecture fixes. It prescribes MultiMesh and TextureAtlas to batch draw calls, direct space-state queries to replace clusters of RayCast nodes, and WorkerThreadPool to keep background calculations off the main thread. It also requires shader pre-warming when targeting the Compatibility renderer.

Texture compression breaks pixel art. The guide explicitly demands turning off VRAM compression for pixel assets to avoid rendering artifacts.

What it helps with

  • profile frame drops and memory spikes using the Godot Profiler
  • batch sprite and mesh draw calls with MultiMesh
  • reuse spawned instances through object pooling
  • disable off-screen processing via VisibleOnScreenNotifier2D
  • offload heavy synchronous operations to WorkerThreadPool

Example prompts for the agent

  • Inspect my Godot enemy script and cache all get_node calls using @onready.
  • Help me set up an object pool for projectile spawning instead of instantiating in loops.
  • How should I pre-warm shaders in Godot's Compatibility renderer to avoid frame hitches?

How to install godot-performance-optimization

1Skills CLI (Vercel)

npx skills add thedivergentai/Game-Dev-Agentic-Skills --skill godot-performance-optimization -a claude-code

2Manually: put the files in place

~/.claude/skills/godot-performance-optimization/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/godot-performance-optimization/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about godot-performance-optimization

How do I install godot-performance-optimization in Claude Code?

Run npx skills add thedivergentai/Game-Dev-Agentic-Skills --skill godot-performance-optimization -a claude-code.

What does the godot-performance-optimization skill do?

It instructs coding agents to profile Godot games before altering code. It provides guidelines for object pooling, draw call batching, space-state physics queries, and off-screen entity culling.

What VRAM compression codecs does the skill recommend?

It advises S3TC or BPTC for desktop builds and ETC2 for mobile targets. Pixel art is an exception where compression should remain disabled to prevent visual degradation.

Similar skills

Everything for Game dev and 3D: Unity, Unreal, Godot, Blender →
performance-optimization gamedev-skills A skill that turns “the game runs slow” into a measured bottleneck and a specific fix: profile first, then pool objects, batch draw calls, cut allocations. CX Codex +1 7,400installs godot-gdscript gamedev-skills Guides coding assistants in writing statically typed GDScript 2.0 for Godot 4.7 and porting legacy scripts from Godot 3.x. Helpful when structuring node lifecycles and signals. CX Codex +1 6,500installs godot-best-practices agent-skills Enforces GDScript standards and scene architecture for Godot 4.x. Guides coding agents on static typing, signal connections, node references, and resource loading. CX Codex +1 2,100installs cli-anything-godot HKUDS Controls Godot projects from the command line, including scenes, GDScript runs, and exports. Useful when an agent needs to change or inspect a game project. CX Codex +1 548installs godot-prompter jame581 A skill pack for Godot 4.x game development. Your agent loads the relevant domain skill and follows engine-specific practice instead of generic advice. ★ 867repo stars godot-mcp-enhanced wgt19861219 Gives an agent 46 MCP tools to read, write, run and verify Godot 4.5–4.7 projects without opening the editor. CX Codex +1 ★ 103repo stars

From the same set51

godot-combat-system A skill that tells the agent how to build hitboxes, damage and i-frames in Godot. Useful for action games, RPGs and fighters. CX Codex +1 507installs godot-project-foundations Guides Godot 4 project architecture with feature-oriented directory layouts, naming standards, and clean Git ignore rules. CX Codex +1 499installs godot-audio-systems A skill with ready-made Godot audio scripts: voice pools, buses, attenuation, music transitions. Useful once your sound starts clipping or dropping out. CX Codex +1 502installs godot-resource-data-patterns A Godot skill that steers your agent toward Resource and RefCounted patterns for item databases, character stats and reusable data. CX Codex +1 497installs godot-state-machine-advanced A Godot skill for hierarchical finite state machines and pushdown automata: ready scripts for sub-states, state stacks and transition validation. CX Codex +1 486installs godot-tweening Blueprint for programmatic Godot animations using Tween. Helps configure UI transitions, easing curves, and safe lifecycle cleanup. CX Codex +1 475installs godot-economy-system Guides game economy architecture in Godot using wallet singletons, weighted loot, and shop logic. Works for RPGs and resource management titles. CX Codex +1 455installs godot-debugging-profiling A skill for debugging and profiling Godot games: leaks, orphan nodes, GPU profiler spikes, flaky headless CI runs. CX Codex +1 457installs

Project sponsors

Companies that keep this analytics open
Gold sponsor
Nutra.Club

Impressions, clicks and code copies — open statistics. We keep the numbers public for the same reason NeBlask itself is public. Become a sponsor