Agent skill

Godot Performance Optimization

by thedivergentai in thedivergentai/GD-Agentic-Skills

Expert blueprint for performance profiling and optimization (frame drops, memory leaks, draw calls) using Godot Profiler, object pooling, visibility culling, and bottleneck identification.

LGPL-3.0Auto-check passedGame Development

Install Godot Performance Optimization

skills CLI
$ npx skills add thedivergentai/GD-Agentic-Skills --skill godot-performance-optimization -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install thedivergentai/GD-Agentic-Skills godot-performance-optimization --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/thedivergentai/GD-Agentic-Skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/godot-performance-optimization .claude/skills/godot-performance-optimization && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
godot-performance-optimization
GitHub stars
816
Token cost
~3k tokens
SKILL.md length
896 words
Files
15 (incl. scripts, references)
Skills in repo
98
Repo updated
First seen
Licence
LGPL-3.0

At a glance

Expert blueprint for performance profiling and optimization (frame drops, memory leaks, draw calls) using Godot Profiler, object pooling, visibility culling, and bottleneck identification.

  • Optimizing for target FPS
  • SKILL.md covers NEVER Do in Performance…, Profiler-Tab Decision Tree, Available Scripts and Expert Pointers (keep short), plus 2 more sections
  • Reducing memory usage

What it does

Godot Performance Optimization is an agent skill from thedivergentai/GD-Agentic-Skills. Expert blueprint for performance profiling and optimization (frame drops, memory leaks, draw calls) using Godot Profiler, object pooling, visibility culling, and bottleneck identification. Use when diagnosing lag, optimizing for target FPS, or reducing memory usage. Keywords profiling, Godot Profiler, bottleneck, object pooling, VisibleOnScreenNotifier, draw calls, MultiMesh.

Its SKILL.md is about 3k tokens, which your agent loads only when the skill is triggered. The skill folder holds 16 other files, including scripts and reference files (for example `references/migration-notes.md` and `references/profiler-budgets-and-prewarm.md`).

It sits in Game Development, covering Performance optimization and Game development. It works with Godot. The repository describes itself as: The official "Long-Term Memory" for Godot 4.7+ AI Agents. A high-density library of 99 expert skills and 27 genre blueprints, providing audited, strictly typed GDScript patterns… The licence is LGPL-3.0.

When your agent uses it

  • Optimizing for target FPS
  • Reducing memory usage

Example prompts

  • “/godot-performance-optimization”

What it can do on your machine

Read from SKILL.md and the folder at commit 4c4d0ff. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships 12 files in scripts/, which the agent can run.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Links to these hosts (documentation or services it may open):

    • docs.godotengine.org

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Godot Performance Optimization loads about 3k tokens when it runs, and up to ~4.7k if it reads all its reference files. Until then it costs about 102 tokens; SKILL.md has 896 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~102
When it runs · the whole SKILL.md, loaded when a task matches
~3k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~4.7k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

The full file from thedivergentai/GD-Agentic-Skills at commit 4c4d0ff, republished under its LGPL-3.0 licence (© thedivergentai). 896 words, ~3,011 tokens.

Download SKILL.mdSave it as .claude/skills/godot-performance-optimization/SKILL.md (or your agent's skills folder). This skill also uses 14 other files; get the full folder from GitHub.
name
godot-performance-optimization
description
Expert blueprint for performance profiling and optimization (frame drops, memory leaks, draw calls) using Godot Profiler, object pooling, visibility culling, and bottleneck identification. Use when diagnosing lag, optimizing for target FPS, or reducing memory usage. Keywords profiling, Godot Profiler, bottleneck, object pooling, VisibleOnScreenNotifier, draw calls, MultiMesh.

NEVER Do in Performance Optimization

  • NEVER optimize without profiling first — "I think physics is slow" without data? Premature optimization. ALWAYS use Debug → Profiler (F3) to identify actual bottleneck [20].
  • NEVER use print() in release builds — print() every frame = file I/O bottleneck + log spam. Use @warning_ignore or conditional if OS.is_debug_build(): [21].
  • NEVER ignore VisibleOnScreenNotifier2D for off-screen entities — Enemies processing logic off-screen = wasted CPU. Disable set_process(false) when screen_exited [22].
  • NEVER instantiate nodes in hot loops — for i in 1000: var bullet = Bullet.new() = 1000 allocations. Use object pools, reuse instances [23].
  • NEVER use get_node() in _process() — Calling get_node("Player") 60x/sec = tree traversal spam. Cache in @onready var player := $Player [24].
  • NEVER forget to batch draw calls — 1000 unique sprites = 1000 draw calls. Use TextureAtlas (sprite sheets) + MultiMesh for instanced rendering [25].
  • NEVER block the main thread for heavy operations — Avoid OS.delay_msec() or long synchronous data processing. Use WorkerThreadPool to keep framerates steady.
  • NEVER use complex collision shapes for physics queries — High-poly convex shapes are expensive to resolve. Prefer simplified primitives (Circle, Rectangle, Box).
  • NEVER forget to disconnect local lambda signals — Anonymous lambdas connected to global signals can cause memory leaks if the capturing object is freed.
  • NEVER use large textures without VRAM compression — VRAM is limited. Use S3TC/BPTC for desktop (DirectX/Vulkan) and ETC2 for mobile. Note: Disable compression for Pixel Art to avoid artifacts [13].
  • NEVER perform tree modifications during physics steps — Adding/removing nodes during _inter_ray or _physics_process can lock the physics server. Use call_deferred.
  • NEVER skip shader pre-warming in the Compatibility renderer — Unlike Forward+, OpenGL lacks Ubershaders. Pre-instantiate every mesh/VFX in front of the camera for 1 frame behind a loading screen to avoid hitches [21].

Debug → Profiler (F3)

Tabs:

  • Time: Function call times
  • Memory: RAM usage
  • Network: RPCs, bandwidth
  • Physics: Collision checks

Profiler-Tab Decision Tree

Open Debug → Profiler first. MANDATORY load only the script for the hot tab/symptom.

Do NOT Load every perf script for a single hitch.

Profiler / symptomLikely causeScript
Time — same script hotAlloc / get_node / processobject_pool_system.gd, cache @onready; custom_monitor_profiler.gd
Time — off-screen AI/VFXProcess while invisibleMANDATORY manual_culling_logic.gd
Memory — climbs over timeLeaks / unique resourcesshared_resource_strategy.gd; pair with debugging orphan tools
Physics — collision spikesQuery/node RayCast spamMANDATORY low_level_physics_query.gd
GPU / draw callsUnique sprites/meshesMANDATORY multimesh_optimizer.gd / multimesh_foliage_manager.gd / texture_array_batching.gd
SceneTree overhead at scaleCanvas/mesh item spamMANDATORY rendering_server_direct.gd
Main-thread hitch (gen/parse)Sync heavy workMANDATORY worker_thread_pool_manager.gd
Crowd path spikesNav agents same framenavigation_agent_optimization.gd
Custom game metricsMissing monitorscustom_performance_monitor.gd

Available Scripts

object_pool_system.gd

MANDATORY for hot-path spawn/despawn — reuse, do not invent Array pop pools inline.

manual_culling_logic.gd

VisibilityNotifier-driven process disable for CPU-heavy off-screen entities.

rendering_server_direct.gd

RenderingServer canvas/mesh path when SceneTree overhead dominates.

low_level_physics_query.gd

Direct space-state queries vs hundreds of RayCast nodes.

worker_thread_pool_manager.gd

WorkerThreadPool offload for heavy jobs.

multimesh_optimizer.gd / multimesh_foliage_manager.gd

Hardware instancing for dense meshes/foliage.

texture_array_batching.gd

Texture2DArray batching to cut material switches.

shared_resource_strategy.gd

Shared vs local-to-scene memory tradeoffs.

navigation_agent_optimization.gd

Staggered path updates for crowds.

custom_monitor_profiler.gd / custom_performance_monitor.gd

Performance.get_monitor / custom monitors for game-specific spikes.

Expert Pointers (keep short)

  • Compatibility renderer: pre-warm pipelines (hidden camera + unique meshes/materials one frame). Forward+/Mobile: Ubershaders still need instantiate-once detection.
  • VRAM: S3TC/BPTC desktop, ETC2 mobile; skip compression for pixel art.
  • AStar/path budgets belong in navigation_agent_optimization.gd — do not paste thrashy queue snippets as the golden path.

Deep dives (on demand)

Show full SKILL.md (357 more words)Show less

Reference

Progressive disclosure: open Official Documentation links only when researching a specific API; load Related Skills when routing to a peer domain — do not preload the whole lattice.

Official Documentation
Prerequisites
Complements
Downstream / consumers
  • godot-adapt-desktop-to-mobile — resolution/shader fallbacks and battery modes that apply these budgets on weaker GPUs.
  • godot-export-builds — export presets and renderer choices where compression and Compatibility pre-warm matter.
  • godot-genre-open-world — chunk streaming and HLOD systems that consume MultiMesh, culling, and thread-pool patterns at scale.
Master
  • godot-master — library router and mirrored module entry for cross-skill discovery.

© thedivergentai, LGPL-3.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 14 other files (scripts, references) in skills/godot-performance-optimization of thedivergentai/GD-Agentic-Skills.

  • SKILL.md
  • references/migration-notes.md
  • references/profiler-budgets-and-prewarm.md
  • scripts/custom_monitor_profiler.gd
  • scripts/custom_performance_monitor.gd
  • scripts/low_level_physics_query.gd
  • scripts/manual_culling_logic.gd
  • scripts/multimesh_foliage_manager.gd
  • scripts/multimesh_optimizer.gd
  • scripts/navigation_agent_optimization.gd
  • scripts/object_pool_system.gd
  • scripts/rendering_server_direct.gd
  • scripts/shared_resource_strategy.gd
  • scripts/texture_array_batching.gd
  • scripts/worker_thread_pool_manager.gd

Open the folder on GitHubat commit 4c4d0ff

Compare with similar skills

Godot Performance Optimization next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Godot Performance Optimization compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Godot Performance Optimization this skillthedivergentai/GD-Agentic-Skills816—~3kAutomated safety check: PassLGPL-3.0
Gdscript Advancedjame581/GodotPrompter799—~3.4kAutomated safety check: PassMIT
Godot Optimizationjame581/GodotPrompter799—~3kAutomated safety check: PassMIT
Profiler Get Rendering StatsIvanMurzak/Unity-MCP4.4k—~833Automated safety check: PassApache-2.0
Dependency Injectionjame581/GodotPrompter799—~2.8kAutomated safety check: PassMIT
Gdscript Patternsjame581/GodotPrompter799—~3.5kAutomated safety check: PassMIT

Similar skills

  • Gdscript Advanced

    jame581/GodotPrompter

    A skill your agent uses when writing production-grade GDScript — performance idioms, metaprogramming, @tool lifecycle, async pitfalls, signal/Callable trade-offs, profiler-driven idioms, and common…

    799 GitHub stars~3.4k tokensUpdated today
    Game DevelopmentAuto-check passed
  • Godot Optimization

    jame581/GodotPrompter

    A skill your agent uses when optimizing Godot games — profiler, draw calls, physics tuning, memory management, and common bottlenecks

    799 GitHub stars~3k tokensUpdated today
    Game DevelopmentAuto-check passed
  • Profiler Get Rendering Stats

    IvanMurzak/Unity-MCP

    Return current frame timing, FPS, vsync, target frame rate, threading mode, and graphics device type from Unity Time / QualitySettings / SystemInfo.

    4.4k GitHub stars~833 tokensUpdated 5 days ago
    Game DevelopmentAuto-check passed
  • Dependency Injection

    jame581/GodotPrompter

    A skill your agent uses when managing dependencies between systems — autoloads, service locators, @export injection, and scene injection patterns

    799 GitHub stars~2.8k tokensUpdated today
    Game DevelopmentAuto-check passed
  • Gdscript Patterns

    jame581/GodotPrompter

    A skill your agent uses when writing GDScript — static typing, await/coroutines, lambdas, match patterns, export annotations, inner classes, and common idioms

    799 GitHub stars~3.5k tokensUpdated today
    Game DevelopmentAuto-check passed
  • Godot Debugging

    jame581/GodotPrompter

    A skill your agent uses when debugging Godot projects — remote debugger, print techniques, signal tracing, common error patterns and fixes

    799 GitHub stars~3k tokensUpdated today
    Game DevelopmentAuto-check passed

More from thedivergentai/GD-Agentic-Skills

All 98 skills in this repo
  • Godot 2D Animation

    thedivergentai/GD-Agentic-Skills

    Expert patterns for 2D animation in Godot using AnimatedSprite2D and skeletal cutout rigs.

    816 GitHub stars~3.6k tokensUpdated 1 mo ago
    Auto-check passed
  • Godot 3D World Building

    thedivergentai/GD-Agentic-Skills

    Expert patterns for 3D level design using GridMap with MeshLibrary, CSG constructive solid geometry, occlusion, and runtime GridMap builders.

    816 GitHub stars~3.3k tokensUpdated 1 mo ago
    Auto-check passed
  • Godot Adapt 2D To 3D

    thedivergentai/GD-Agentic-Skills

    Expert patterns for migrating 2D games to 3D including node type conversions, camera systems (third-person, first-person, orbit), physics layer migration, sprite-to-model art pipeline, and control…

    816 GitHub stars~4.7k tokensUpdated 1 mo ago
    Auto-check passed
  • Godot Adapt 3D To 2D

    thedivergentai/GD-Agentic-Skills

    Expert patterns for simplifying 3D games to 2D including dimension reduction strategies, 2.5D fake-depth, isometric ports, camera flattening, physics conversion, 3D-to-sprite art pipeline, and…

    816 GitHub stars~4.5k tokensUpdated 1 mo ago
    Auto-check passed
  • Godot Agent Vision

    thedivergentai/GD-Agentic-Skills

    Agentic eyes for Godot work: cross-platform screenshot CLI (asset/region/window/screen) to budgeted WebP, TEMP editor viewport bridge under .gdskills/, and Taste Receptor Atlas v2 (~237…

    816 GitHub stars~3.5k tokensUpdated 1 mo ago
    Auto-check passed
  • Godot Animation Tree Mastery

    thedivergentai/GD-Agentic-Skills

    Expert patterns for AnimationTree including StateMachine transitions, BlendSpace2D for directional movement, BlendTree for layered animations, root motion, transition conditions, advance…

    816 GitHub stars~3.6k tokensUpdated 1 mo ago
    Auto-check passed

Works with

Questions about Godot Performance Optimization

What does Godot Performance Optimization do?

Expert blueprint for performance profiling and optimization (frame drops, memory leaks, draw calls) using Godot Profiler, object pooling, visibility culling, and bottleneck identification. Godot Performance Optimization is an agent skill from thedivergentai/GD-Agentic-Skills. Expert blueprint for performance profiling and optimization (frame drops, memory leaks, draw calls) using Godot Profiler, object pooling, visibility culling, and bottleneck identification.

When should I use Godot Performance Optimization?

Godot Performance Optimization fits situations like: optimizing for target FPS; reducing memory usage.

How do I install Godot Performance Optimization in Claude Code?

Run `npx skills add thedivergentai/GD-Agentic-Skills --skill godot-performance-optimization -a claude-code`. Or copy the skill folder (skills/godot-performance-optimization in thedivergentai/GD-Agentic-Skills) into .claude/skills/godot-performance-optimization in your project. Claude Code loads it when a task matches its description.

How do I install Godot Performance Optimization in Codex?

Run `npx skills add thedivergentai/GD-Agentic-Skills --skill godot-performance-optimization -a codex`. Or copy the skill folder (skills/godot-performance-optimization in thedivergentai/GD-Agentic-Skills) into .agents/skills/godot-performance-optimization in your project. Codex loads it when a task matches its description.

Can I use Godot Performance Optimization in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add thedivergentai/GD-Agentic-Skills --skill godot-performance-optimization -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/godot-performance-optimization, .gemini/skills/godot-performance-optimization, .github/skills/godot-performance-optimization and .opencode/skills/godot-performance-optimization in your project.

What does Godot Performance Optimization need to run?

SKILL.md names no scripts, command-line tools or credentials: Godot Performance Optimization is instructions for the agent only.

Does Godot Performance Optimization access the network?

SKILL.md names 1 domain. As links in the text: docs.godotengine.org. This is read from the text; nothing was executed.

Is Godot Performance Optimization safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Godot Performance Optimization use?

Godot Performance Optimization is published under the LGPL-3.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Godot Performance Optimization use?

About 3k tokens (SKILL.md is roughly 12k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 1.7k tokens, read only when the agent opens those files.

What are the alternatives to Godot Performance Optimization?

Skills that share tags, products or a category with Godot Performance Optimization: Gdscript Advanced (jame581/GodotPrompter, 799 stars), Godot Optimization (jame581/GodotPrompter, 799 stars), Profiler Get Rendering Stats (IvanMurzak/Unity-MCP, 4.4k stars) and Dependency Injection (jame581/GodotPrompter, 799 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Godot Performance Optimization?

thedivergentai (a GitHub user) maintains it in thedivergentai/GD-Agentic-Skills, which has 816 GitHub stars. The repository holds 98 skills in this directory. The repository was last updated on September 9, 2026.

Source: thedivergentai/GD-Agentic-Skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.