Agent skill

Godot Resource Data Patterns

by thedivergentai in thedivergentai/GD-Agentic-Skills

Expert blueprint for data-oriented design using Resource/RefCounted classes (item databases, character stats, reusable data structures).

LGPL-3.0Auto-check passedGame Development

Install Godot Resource Data Patterns

skills CLI
$ npx skills add thedivergentai/GD-Agentic-Skills --skill godot-resource-data-patterns -a claude-code

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

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

At a glance

Expert blueprint for data-oriented design using Resource/RefCounted classes (item databases, character stats, reusable data structures).

  • Implementing data systems OR inventory/stats/dialogue databases
  • SKILL.md covers NEVER Do in Resource Design, Decision Tree: Resource vs…, Available Scripts — MANDATORY… and Expert WHY (critical), plus 2 more sections
  • Tasks that involve Game development
  • Tasks that involve Caching

What it does

Godot Resource Data Patterns is an agent skill from thedivergentai/GD-Agentic-Skills. Expert blueprint for data-oriented design using Resource/RefCounted classes (item databases, character stats, reusable data structures). Covers typed arrays, serialization, nested resources, and resource caching. Use when implementing data systems OR inventory/stats/dialogue databases. Keywords Resource, RefCounted, ItemData, CharacterStats, database, serialization, @export, typed arrays.

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

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

  • Implementing data systems OR inventory/stats/dialogue databases
  • Tasks that involve Game development
  • Tasks that involve Caching

Example prompts

  • “/godot-resource-data-patterns”

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 13 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 Resource Data Patterns loads about 2.5k tokens when it runs, and up to ~4.2k if it reads all its reference files. Until then it costs about 105 tokens; SKILL.md has 804 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~105
When it runs · the whole SKILL.md, loaded when a task matches
~2.5k
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). 804 words, ~2,546 tokens.

Download SKILL.mdSave it as .claude/skills/godot-resource-data-patterns/SKILL.md (or your agent's skills folder). This skill also uses 15 other files; get the full folder from GitHub.
name
godot-resource-data-patterns
description
Expert blueprint for data-oriented design using Resource/RefCounted classes (item databases, character stats, reusable data structures). Covers typed arrays, serialization, nested resources, and resource caching. Use when implementing data systems OR inventory/stats/dialogue databases. Keywords Resource, RefCounted, ItemData, CharacterStats, database, serialization, @export, typed arrays.

NEVER Do in Resource Design

  • NEVER modify resource instances directly — Without .duplicate(), changing a value (like HP) modifies the shared .tres for everyone.
  • NEVER use untyped arrays in Resources — @export var items: Array allows logic errors. Always use Array[ResourceClass] for type safety.
  • NEVER store Node references in Resources — Objects that only exist in a specific SceneTree cannot be serialized. Store NodePath or UID.
  • NEVER perform heavy calculations in Resource getters/setters — Resources should be data containers. Offload logic to Nodes or specialized RefCounted classes.
  • NEVER skip ResourceSaver.save() error checks — Saving can fail due to permissions, disk space, or path issues. Always check the return code.
  • NEVER use Resources for high-frequency runtime data — If a value changes 60 times a second (like velocity), a standard variable is faster than a Resource property.
  • NEVER allow circular Resource references — If A.tres references B.tres and B.tres references A.tres, the engine may crash on load.
  • NEVER forget the _init defaults — Resources created via new() or in the Inspector need default values in their constructor to be editable.
  • NEVER share a Resource between entities if they need unique state — Use resource_local_to_scene = true or duplicate() for components.
  • NEVER use .tres for massive datasets — If you have 10,000 items, a JSON or custom binary format might be more efficient than individualized Resource files.

Decision Tree: Resource vs RefCounted vs Node

TypeUse whenDisk / Inspector
ResourceShared definitions, saveable data, @export authoring.tres/.res, Inspector ✅
RefCountedTemporary runtime calcs, non-persistent helpersNo disk / weak Inspector
NodeScene entities with process/signals in the treeScene files

Use Resources for: item defs, stats templates, abilities, dialogue tables, enemy configs. Use RefCounted for: damage calc scratchpads, ephemeral state machines, non-saved utilities.

Available Scripts — MANDATORY by Scenario

ScenarioMANDATORY read
Per-instance mutable stats (HP) sharing a base .tresresource_local_to_scene.gd
Nested Item → Weapon → StatusEffect trees / save whole graphnested_resource_serialization.gd
Many entities sharing one config (flyweight)resource_flyweight_caching.gd / flyweight_enemy_config.gd
Custom @export data containerscustom_data_resource.gd
Reactive stats with signalscharacter_stats_resource.gd
Inventory arrays of Resourcesresource_based_inventory.gd
Save Resource trees to diskresource_save_system.gd — check Error
Preload / O(1) cache before playresource_preloading_strategy.gd
Runtime Resource.new() lootdynamic_resource_generation.gd
Validate / pool / factoryresource_validator.gd / resource_pool.gd / data_factory_resource.gd

Expert WHY (critical)

CAUTION: Runtime HP/mana on a shared .tres without duplicate(true) or resource_local_to_scene mutates the asset on disk — the "damaging one damages all" bug.

  • .res vs .tres: binary .res in production; .tres for design diffs; nested trees save with parent via ResourceSaver.
  • Cache: ResourceLoader.CACHE_MODE_REPLACE after external edits bypass stale cache.
  • Local-to-scene / duplicate: mandatory for per-instance components — resource_local_to_scene.gd.
  • 10k+ rows: individualized .tres files lose to JSON/binary — see Official Docs binary serialization.

Deep dive (load on demand)

Pattern 1–7 walkthroughs (ItemData, databases, RefCounted calcs, directory scan, O(1) cache) — references/resource-patterns-deep.md. Implement nested weapons from nested_resource_serialization.gd, not memory.

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.

Show full SKILL.md (330 more words)Show less
Official Documentation
  • Resources — Custom Resource scripts, .tres/.res, sharing vs duplicate(), and resource_local_to_scene for per-instance state.
  • Data preferences — When to store data in Resources vs dictionaries, ConfigFile, or plain scripts for inspector and serialization needs.
  • Resource — duplicate, emit_changed, resource_path, and local-to-scene flags used by every data container pattern here.
  • ResourceLoader — Cached load / threaded requests that power flyweight sharing and preload caches.
  • ResourceSaver — Persist custom Resources to user:// or res:// and always check the returned Error.
  • RefCounted — Lightweight runtime objects when you need refcounting without disk serialization or Inspector exports.
  • Saving games — Broader save strategies that pair with ResourceSaver for slot-based .tres state.
  • Background loading — Threaded ResourceLoader polling so databases and VFX packs do not hitch the main thread.
  • GDScript exports — Typed @export / Array[T] so item and quest Resources stay Inspector-safe.
  • Binary serialization API — Compact FileAccess packing when thousands of rows outgrow individualized .tres files.
  • Scene organization — Why shared Resources live outside scene trees and how component scenes compose exported data.
Prerequisites
  • godot-project-foundations — Project layout, import, and res:// hygiene before authoring shared .tres databases.
  • godot-gdscript-mastery — class_name, typed arrays, setters, and @tool discipline every custom Resource script depends on.
Complements
  • godot-signal-architecture — Ownership and fan-out for Resource changed / custom signals that drive reactive UI and stats.
  • godot-save-load-systems — Slot versioning, migration, and secure paths that wrap ResourceSaver/ResourceLoader save flows.
  • godot-scene-management — Packed scenes and threaded loads that consume preloaded Resource caches without hitch spikes.
  • godot-ability-system — Ability/buff definitions are Resource data; this skill owns the container and serialization patterns.
  • godot-dialogue-system — Dialogue graphs and line tables are nested Resources that reuse typed-array and save patterns here.
  • godot-performance-optimization — Flyweight sharing, pooling RefCounted payloads, and when .res beats text .tres at scale.
Downstream / consumers
  • godot-inventory-system — Item stacks, equipment, and bags consume ItemData / inventory Resource arrays defined here.
  • godot-procedural-generation — Generators that instantiate loot, quests, and configs via Resource.new() at runtime.
  • godot-monte-carlo-balancer — .tres stats and economy tables are the preferred extract source — build the data layer before regex farms.
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 15 other files (scripts, references) in skills/godot-resource-data-patterns of thedivergentai/GD-Agentic-Skills.

  • SKILL.md
  • references/migration-notes.md
  • references/resource-patterns-deep.md
  • scripts/character_stats_resource.gd
  • scripts/custom_data_resource.gd
  • scripts/data_factory_resource.gd
  • scripts/dynamic_resource_generation.gd
  • scripts/flyweight_enemy_config.gd
  • scripts/nested_resource_serialization.gd
  • scripts/resource_based_inventory.gd
  • scripts/resource_flyweight_caching.gd
  • scripts/resource_local_to_scene.gd
  • scripts/resource_pool.gd
  • scripts/resource_preloading_strategy.gd
  • scripts/resource_save_system.gd
  • scripts/resource_validator.gd

Open the folder on GitHubat commit 4c4d0ff

Compare with similar skills

Godot Resource Data Patterns 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 Resource Data Patterns compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Godot Resource Data Patterns this skillthedivergentai/GD-Agentic-Skills821—~2.5kAutomated 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 3 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 24 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 Resource Data Patterns

What does Godot Resource Data Patterns do?

Expert blueprint for data-oriented design using Resource/RefCounted classes (item databases, character stats, reusable data structures). Godot Resource Data Patterns is an agent skill from thedivergentai/GD-Agentic-Skills. Expert blueprint for data-oriented design using Resource/RefCounted classes (item databases, character stats, reusable data structures).

When should I use Godot Resource Data Patterns?

Godot Resource Data Patterns fits situations like: implementing data systems OR inventory/stats/dialogue databases; tasks that involve Game development; tasks that involve Caching.

How do I install Godot Resource Data Patterns in Claude Code?

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

How do I install Godot Resource Data Patterns in Codex?

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

Can I use Godot Resource Data Patterns 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-resource-data-patterns -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-resource-data-patterns, .gemini/skills/godot-resource-data-patterns, .github/skills/godot-resource-data-patterns and .opencode/skills/godot-resource-data-patterns in your project.

What does Godot Resource Data Patterns need to run?

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

Does Godot Resource Data Patterns 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 Resource Data Patterns 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 Resource Data Patterns use?

Godot Resource Data Patterns 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 Resource Data Patterns use?

About 2.5k tokens (SKILL.md is roughly 10k 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 Resource Data Patterns?

Skills that share tags, products or a category with Godot Resource Data Patterns: 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 Resource Data Patterns?

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.