godot-genre-simulation — Claude Code skill for Godot tycoon games
A skill for building simulation and tycoon games in Godot: integer-cent economy, physics-driven ticks, NPC schedules. Useful once your city or factory starts to stutter.
npx skills add thedivergentai/Game-Dev-Agentic-Skills --skill godot-genre-simulation -a claude-codeWhat godot-genre-simulation does
The skill lays down rules for management sims and tycoons in Godot: how money is counted, how game time advances, how the UI refreshes. It ships scripts the agent loads on demand — tycoon_economy.gd for integer-cent currency, sim_tick_manager.gd with a tick accumulator on _physics_process, simulation_tick_controller.gd for pause and speed. There is also a producer/consumer graph, schedule-driven NPC agents and a CSV-to-Resource bake.
One hard rule: never keep primary currency in a float. The skill insists on integer cents because fractional accumulation drifts in a financial model. The second rule is that simulation logic must not ride the frame rate, so ticks run through _physics_process or a delta accumulator. Thousands of entities inside _process() get the same treatment — a tick manager and rotating pools instead.
Heavy economic loops are meant to go into WorkerThreadPool, and UI labels should refresh on signals rather than every frame. For stationary management screens there is OS.low_processor_usage_mode. Worth knowing: part of the reference material is cut off, so for an uncommon API the agent will have to check the Godot docs itself.
What it helps with
- keep currency in integer cents so rounding errors do not pile up
- decouple game time from frame rate with a tick accumulator
- spread thousands of entity updates across pools instead of one
_process() - offload heavy economic loops to
WorkerThreadPool - refresh resource panels on a signal rather than every frame
Example prompts for the agent
- Build the tycoon economy: currency in integer cents, income and expense as separate lines
- Set up game hours on
_physics_processwith a delta accumulator and pause - Spread NPC schedules across ticks so hundreds of agents do not stall the game
How to install godot-genre-simulation
1Skills CLI (Vercel)
npx skills add thedivergentai/Game-Dev-Agentic-Skills --skill godot-genre-simulation -a claude-code2Manually: put the files in place
~/.claude/skills/godot-genre-simulation/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/godot-genre-simulation/
1Skills CLI (Vercel)
npx skills add thedivergentai/Game-Dev-Agentic-Skills --skill godot-genre-simulation -a codex2Manually: put the files in place
.agents/skills/godot-genre-simulation/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add thedivergentai/Game-Dev-Agentic-Skills --skill godot-genre-simulation -a cursor2Manually: put the files in place
.cursor/skills/godot-genre-simulation/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install thedivergentai/Game-Dev-Agentic-Skills godot-genre-simulation2Manually: put the files in place
.github/skills/godot-genre-simulation/SKILL.md1Skills CLI (Vercel)
npx skills add thedivergentai/Game-Dev-Agentic-Skills --skill godot-genre-simulation -a gemini-cli2Platform CLI
gemini skills install https://github.com/thedivergentai/Game-Dev-Agentic-Skills --path skills/godot-genre-simulationManually: put the files in place
.devin/skills/godot-genre-simulation/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add thedivergentai/Game-Dev-Agentic-Skills --skill godot-genre-simulation -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-genre-simulation
How do I install godot-genre-simulation in Claude?
Run npx skills add thedivergentai/Game-Dev-Agentic-Skills --skill godot-genre-simulation -a claude-code. The skill then lives at ~/.claude/skills/godot-genre-simulation/SKILL.md.
What does godot-genre-simulation do?
It gives the agent rules and scripts for simulation and tycoon games in Godot: integer-cent economy, physics ticks, NPC schedules, production graphs. The agent loads the relevant script when it reaches that system.
Why integer cents instead of float for currency?
The skill bans float for primary currency because fractional accumulation drifts in a financial model. Integer cents or fixed-point math instead.