godot-optimization — Claude Code skill: what it does, how to install
Profiles Godot game performance and guides GDScript optimizations, from draw call batching to node caching and object pooling.
npx skills add Zate/cc-godot --skill godot-optimization -a claude-codeWhat godot-optimization does
This skill guides coding agents through profiling and fixing performance bottlenecks across 2D and 3D Godot projects. It targets engine monitors like frame times and physics intervals. Slowdowns become much easier to trace.
The instructions include GDScript patterns. The agent recommends replacing per-frame polling in _process with timers and caching node paths in @onready variables. It also swaps manual distance loops for Area2D triggers, uses MultiMeshInstance2D to batch repeated sprites, and implements an ObjectPool to avoid scene instantiation costs.
Repeated calls to get_tree().get_nodes_in_group() inside loops create noticeable frame drops, so the skill mandates caching group arrays early. It also details distance-based Level of Detail (LOD) handling for meshes and physics steps.
What it helps with
- eliminate frame drops and monitor engine metrics in GDScript
- replace per-frame polling in
_processwith interval timers - reduce draw calls using
MultiMeshInstance2D - implement object pools for frequently spawned scenes
Example prompts for the agent
- Review
EnemyManager.gdand stop querying node groups every frame. - Help me set up an
ObjectPoolfor bullets in Godot 4. - How can I convert individual coin sprites into a
MultiMeshInstance2D?
How to install godot-optimization
1Skills CLI (Vercel)
npx skills add Zate/cc-godot --skill godot-optimization -a claude-code2Manually: put the files in place
~/.claude/skills/godot-optimization/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/godot-optimization/
1Skills CLI (Vercel)
npx skills add Zate/cc-godot --skill godot-optimization -a codex2Manually: put the files in place
.agents/skills/godot-optimization/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add Zate/cc-godot --skill godot-optimization -a cursor2Manually: put the files in place
.cursor/skills/godot-optimization/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install Zate/cc-godot godot-optimization2Manually: put the files in place
.github/skills/godot-optimization/SKILL.md1Skills CLI (Vercel)
npx skills add Zate/cc-godot --skill godot-optimization -a gemini-cli2Platform CLI
gemini skills install https://github.com/Zate/cc-godot --path plugins/gd/skills/godot-optimizationManually: put the files in place
.devin/skills/godot-optimization/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add Zate/cc-godot --skill godot-optimization -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about godot-optimization
How to install godot-optimization in Claude Code?
Run npx skills add Zate/cc-godot --skill godot-optimization -a claude-code. Alternatively, copy the skill definition into ~/.claude/skills/godot-optimization/SKILL.md.
What does godot-optimization do?
It equips your coding assistant with Godot profiling guidelines and GDScript optimization techniques. The skill targets node lookups, draw calls, collision logic, and scene instantiation.
How does it handle repetitive draw calls?
The skill recommends replacing multiple individual sprite nodes with TileMap or MultiMeshInstance2D nodes, alongside texture atlasing to batch draws.
