Agent skill

Godot Economy System

by thedivergentai in thedivergentai/GD-Agentic-Skills

Expert patterns for game economies including currency management (multi-currency, wallet system), shop systems (buy/sell prices, stock limits), dynamic pricing (supply/demand), loot tables (weighted…

LGPL-3.0Auto-check passedGame Development

Install Godot Economy System

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

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

GitHub CLI
$ gh skill install thedivergentai/GD-Agentic-Skills godot-economy-system --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-economy-system .claude/skills/godot-economy-system && 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-economy-system
GitHub stars
821
Token cost
~3k tokens
SKILL.md length
925 words
Files
17 (incl. scripts, references)
Skills in repo
98
Repo updated
First seen
Licence
LGPL-3.0

At a glance

Expert patterns for game economies including currency management (multi-currency, wallet system), shop systems (buy/sell prices, stock limits), dynamic pricing (supply/demand), loot tables (weighted…

  • Works in 4 steps: currency_resource.gd — denomination… → wallet_manager_singleton.gd — balances +… → transaction_manager.gd — validated… → …
  • Resource management systems
  • SKILL.md covers Decision Tree: Currency…, NEVER Do in Economy Systems, Golden Path (MANDATORY) and Decision Points → Scripts, plus 3 more sections
  • Keywords: EconomyManager

What it does

Godot Economy System is an agent skill from thedivergentai/GD-Agentic-Skills. Expert patterns for game economies including currency management (multi-currency, wallet system), shop systems (buy/sell prices, stock limits), dynamic pricing (supply/demand), loot tables (weighted drops, rarity tiers), and economic balance (inflation control, currency sinks). Use for RPGs, trading games, or resource management systems. Trigger keywords: EconomyManager, currency, shopitem, loottable, dynamicpricing, buysellspread, currencysink, inflation, itemrarity.

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

It sits in Game Development, covering Game development and Trading and backtesting. 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

  • Resource management systems
  • Keywords: EconomyManager

Example prompts

  • “/godot-economy-system”

Workflow steps

4 steps, taken from the first numbered list in SKILL.md.

  1. currency_resource.gd — denomination metadata
  2. wallet_manager_singleton.gd — balances + signals
  3. transaction_manager.gd — validated spend/grant pipeline
  4. Shop / loot / UI only after wallet+transactions exist

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 14 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 Economy System loads about 3k tokens when it runs, and up to ~4.2k if it reads all its reference files. Until then it costs about 125 tokens; SKILL.md has 925 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~125
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.2k

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). 925 words, ~3,010 tokens.

Download SKILL.mdSave it as .claude/skills/godot-economy-system/SKILL.md (or your agent's skills folder). This skill also uses 16 other files; get the full folder from GitHub.
name
godot-economy-system
description
Expert patterns for game economies including currency management (multi-currency, wallet system), shop systems (buy/sell prices, stock limits), dynamic pricing (supply/demand), loot tables (weighted drops, rarity tiers), and economic balance (inflation control, currency sinks). Use for RPGs, trading games, or resource management systems. Trigger keywords: EconomyManager, currency, shop_item, loot_table, dynamic_pricing, buy_sell_spread, currency_sink, inflation, item_rarity.

Decision Tree: Currency Representation

Economy typeStore asWhy
Soft currency (gold, scrap) with UI decimalsint cents / smallest unitExact math; display value / 100.0
Premium / idle quantities >> 2^31BigInt / multi-limb int (or carefully scaled float only if approx OK)32-bit int caps ~2.1B
Multiplayer / persistent walletAuthoritative int (or BigInt) on serverClient never finalizes spends
Prices with fractional display onlyStill int smallest unitAvoid 0.1 + 0.2 float drift

NEVER mix "use float for money" and "never use float for money" without this tree — pick one column and stick to it.

NEVER Do in Economy Systems

  • NEVER skip buy/sell spread — Same buy/sell price = infinite money.
  • NEVER skip currency sinks — Repairs, taxes, fees, consumables prevent inflation.
  • NEVER validate spends only on the client — Server/host is source of truth in multiplayer.
  • NEVER hardcode loot weights in scripts — Use Resources (loot_table_weighted.gd).
  • NEVER subtract before current >= amount — Underflow / negative wallets corrupt saves.
  • NEVER let UI mutate balances directly — UI requests; wallet_manager_singleton.gd / transaction_manager.gd decides.
  • NEVER ignore transaction logs in serious RPGs — Audit trail for missing currency.
  • NEVER exceed max caps without clamping — Cap before wrap / overflow.

Golden Path (MANDATORY)

  1. currency_resource.gd — denomination metadata
  2. wallet_manager_singleton.gd — balances + signals
  3. transaction_manager.gd — validated spend/grant pipeline
  4. Shop / loot / UI only after wallet+transactions exist

Delete ad-hoc EconomyManager gold tutorials — do not re-inline wallet logic in scenes.

Decision Points → Scripts

TaskLoadDo NOT Load
Balances / Autoload walletwallet_manager_singleton.gdInline gold ints on Player
Spend/grant validationtransaction_manager.gdUI calling gold -= n
Shop buy/sell + stockshop_item_data.gd + shop_system_logic.gdEqual buy/sell prices
Sales / reputation pricingdynamic_price_modifier.gd—
Weighted lootloot_table_weighted.gdHardcoded % in enemy scripts
Loot → wallet bridgeloot_drop_economy_bridge.gd—
HUD synccurrency_label_sync.gdPolling wallet in _process without signals
Save walleteconomy_persistence_handler.gd—
Pickup VFXcurrency_pickup_effect.gd—
Multi-item bartertrade_contract_resource.gd—

Available Scripts (full catalog)

Elite Deltas

MANDATORY for GPM logging, dynamic valuation, and moved shop/loot tutorials: economy-elite-patterns.md. Do NOT Load for wallet + transaction golden path only.

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
  • Resources — Currencies, shop items, loot tables, and trade contracts belong as shareable Resource assets so designers can retune prices and drop weights without code changes.
  • Resource — Use duplicate() when applying runtime price modifiers or per-merchant stock so one shop cannot mutate the shared .tres template for every vendor.
  • GDScript exports — @export buy/sell spreads, stock caps, currency ids, and loot weights so economy balance stays Inspector-driven.
  • Singletons (Autoload) — A WalletManager Autoload is the engine-supported pattern for balances that must survive scene changes (world ↔ shop ↔ menu).
  • Autoloads versus regular nodes — Keep global wallet state in Autoload; keep merchant UI and one-off shop logic as scene nodes so tests and multiplayer authority stay composable.
  • Using signals — Emit balance_changed / transaction_failed so HUD labels and pickup VFX subscribe without writing wallet balances from the UI.
  • Saving games — Persist wallet dictionaries (and stocked shop state) with the rest of progression data; never leave soft currency only in memory.
  • FileAccess — Read/write save payloads that include economy blobs; pair with project user:// paths for player-writable balance files.
  • JSON — Serialize currency_id → amount dictionaries as JSON-compatible structures for transparent save/load and analytics dumps.
  • Random number generation — Weighted loot and drop rolls must use Godot RNG APIs (randf, seeded RNG) rather than ad-hoc modulo hacks.
  • RandomNumberGenerator — Seedable RNG instances make loot-table Monte Carlo and deterministic balance tests reproducible.
  • High-level multiplayer — Spend/grant validation must be authoritative on the server; clients request transactions and apply confirmed balance RPCs only.
Show full SKILL.md (287 more words)Show less
Prerequisites
  • godot-resource-data-patterns — Currency, ShopItem, LootTable, and TradeContract definitions are Resource-first; load this before inventing parallel data formats for prices and drops.
  • godot-autoload-architecture — WalletManager as Autoload needs disciplined ownership, init order, and namespacing so economy state does not become a god-object dump.
  • godot-signal-architecture — Balance and transaction signals must stay “signal up / call down” so UI never mutates the wallet directly.
  • godot-gdscript-mastery — Typed Resources, Dictionary wallets, and atomic purchase helpers assume solid GDScript patterns (guards before subtract, no float money).
Complements
  • godot-inventory-system — Buy/sell and barter are atomic wallet↔inventory exchanges; stock and capacity checks belong with inventory, not only with price math.
  • godot-save-load-systems — Economy persistence handlers should plug into the project save schema (versioning, migrate, encrypt premium balances if needed).
  • godot-rpg-stats — Charisma/reputation discounts and sink costs (repairs) need a consistent modifier layer rather than hardcoding multipliers in the shop UI.
  • godot-ui-containers — Shop screens and currency HUD layouts should bind to wallet signals; containers own presentation, WalletManager owns truth.
  • godot-quest-system — Quest gold rewards and turn-in sinks are major currency sources/sinks; wire rewards through the transaction API, not ad-hoc gold +=.
  • godot-combat-system — Loot-drop bridges listen to combat/loot events and grant funds without embedding economy rules inside damage pipelines.
Downstream / consumers
  • godot-monte-carlo-balancer — After sinks, loot weights, and shop spreads are Resource-driven, Monte Carlo farm/career sims prove inflation and time-to-afford bands before shipping curves.
  • godot-multiplayer-networking — Predicted UI spends and authoritative grant/spend RPCs build on the wallet’s request/validate/apply split.
  • godot-genre-idle-clicker — Idle/prestige currencies and sink loops assemble this skill with long-horizon balance and offline accrual genre glue.
  • godot-genre-action-rpg — Action-RPG shops, crafting sinks, and drop economies compose wallet + inventory + loot tables for progression pacing.
Master
  • godot-master — Library router and mirrored module entry; use when discovering peer skills or syncing shared script mirrors after Domain Skill edits.

© 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 16 other files (scripts, references) in skills/godot-economy-system of thedivergentai/GD-Agentic-Skills.

  • SKILL.md
  • references/economy-elite-patterns.md
  • references/migration-notes.md
  • scripts/currency_label_sync.gd
  • scripts/currency_pickup_effect.gd
  • scripts/currency_resource.gd
  • scripts/dynamic_price_modifier.gd
  • scripts/economy_logger.gd
  • scripts/economy_persistence_handler.gd
  • scripts/item_value_estimator.gd
  • scripts/loot_drop_economy_bridge.gd
  • scripts/loot_table_weighted.gd
  • scripts/shop_item_data.gd
  • scripts/shop_system_logic.gd
  • scripts/trade_contract_resource.gd
  • scripts/transaction_manager.gd
  • scripts/wallet_manager_singleton.gd

Open the folder on GitHubat commit 4c4d0ff

Compare with similar skills

Godot Economy System 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 Economy System compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Godot Economy System this skillthedivergentai/GD-Agentic-Skills821—~3kAutomated safety check: PassLGPL-3.0
Godot Gdscript Patterns925236118/AlphaAgent10310 repos~5kAutomated safety check: PassMIT
2D Map and Scene Generator0x0funky/agent-sprite-forge4.4k—~2.9kAutomated safety check: PassMIT
Godot UI Integrationzimo-xiao-zheng/godot-ui-integration285—~1.5kAutomated safety check: PassMIT
Godot Wechat Minigame Adaptergodothub/godot-minigame187—~1.5kAutomated safety check: PassMIT
AI Game Art Pipelineybuild-ai/ai-game-art-pipeline-skill297—~1.1kAutomated safety check: PassMIT

Similar skills

  • Godot Gdscript Patterns

    925236118/AlphaAgent

    Master Godot 4 GDScript patterns including signals, scenes, state machines, and optimization.

    103 GitHub starsUsed in 10 repos~5k tokens
    Game DevelopmentAuto-check passed
  • 2D Map and Scene Generator

    0x0funky/agent-sprite-forge

    Plans and builds 2D game maps and scenes, from tilemaps and parallax backgrounds to HD-2D plates, with collision checks, a playable HTML preview and Tiled, Godot or LDtk export.

    4.4k GitHub stars~2.9k tokensUpdated 4 days ago
    Game DevelopmentAuto-check passed
  • Godot UI Integration

    zimo-xiao-zheng/godot-ui-integration

    Build or revise Godot UI from an approved design, separated art, or a visual reference when scene structure, gameplay binding, and runtime visual verification all matter.

    285 GitHub stars~1.5k tokensUpdated 1 mo ago
    Game DevelopmentAuto-check passed
  • Godot Wechat Minigame Adapter

    godothub/godot-minigame

    Apply the bundled self-contained Godot WeChat Mini Game adapter kit to an official Godot checkout.

    187 GitHub stars~1.5k tokensUpdated 25 days ago
    Game DevelopmentAuto-check passed
  • AI Game Art Pipeline

    ybuild-ai/ai-game-art-pipeline-skill

    Provider-neutral open-source skill for planning and producing game-runtime art assets and animation: static props/icons, canonical character sheets, combat sprites, 3D/video motion references…

    297 GitHub stars~1.1k tokensUpdated 3 mo ago
    Game DevelopmentAuto-check passed
  • MCP Driver

    RandallLiuXin/GodotMaker

    Runtime debugging and live project inspection via godot-mcp.

    550 GitHub starsUsed in 1 repo~1.1k tokens
    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.

    821 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.

    821 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…

    821 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…

    821 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…

    821 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…

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

Works with

Questions about Godot Economy System

What does Godot Economy System do?

Expert patterns for game economies including currency management (multi-currency, wallet system), shop systems (buy/sell prices, stock limits), dynamic pricing (supply/demand), loot tables (weighted…. Godot Economy System is an agent skill from thedivergentai/GD-Agentic-Skills. Expert patterns for game economies including currency management (multi-currency, wallet system), shop systems (buy/sell prices, stock limits), dynamic pricing (supply/demand), loot tables (weighted drops, rarity tiers), and economic balance (inflation control, currency sinks).

When should I use Godot Economy System?

Godot Economy System fits situations like: resource management systems; keywords: EconomyManager.

How do I install Godot Economy System in Claude Code?

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

How do I install Godot Economy System in Codex?

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

Can I use Godot Economy System 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-economy-system -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-economy-system, .gemini/skills/godot-economy-system, .github/skills/godot-economy-system and .opencode/skills/godot-economy-system in your project.

What does Godot Economy System need to run?

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

Does Godot Economy System 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 Economy System 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 Economy System use?

Godot Economy System 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 Economy System 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.2k tokens, read only when the agent opens those files.

What are the alternatives to Godot Economy System?

Skills that share tags, products or a category with Godot Economy System: Godot Gdscript Patterns (925236118/AlphaAgent, 103 stars), 2D Map and Scene Generator (0x0funky/agent-sprite-forge, 4.4k stars), Godot UI Integration (zimo-xiao-zheng/godot-ui-integration, 285 stars) and Godot Wechat Minigame Adapter (godothub/godot-minigame, 187 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Godot Economy System?

thedivergentai (a GitHub user) maintains it in thedivergentai/GD-Agentic-Skills, which has 821 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.