scenario-godot-architecture
Use when structuring Godot 4.7 game code: folders, scenes and nodes, signals or an event bus autoload, custom Resources for item data, components (health, hitbox, hurtbox), an inventory, save and load, InputMap and key rebinding for keyboard, mouse and gamepad, GDScript static typing and style, or G…
Install / Use
npx skills add scenario-labs/skills --skill scenario-godot-architectureInstalls into whichever agent you are using.
SKILL.md
Installable skill definition
Quality Score
Category
MarketingSupported Platforms
Tags
Our assessment of scenario-godot-architecture
scenario-godot-architecture scores 86/100 on our quality scale, 398th of 639 Marketing skills we index.
Its SKILL.md is 20 KB long, well organised into 11 sections and no code examples: a thorough specification that gives an agent plenty to work with.
With 1,048 GitHub stars, it is one of the more widely adopted skills in the catalogue.
Maintenance, license and trust
- The repository was last updated 35 days ago, so scenario-godot-architecture is actively maintained.
- It is released under the MIT license, a permissive license that allows use, modification and commercial use with attribution.
- Its trust signals score 100/100, with no cautions. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.
Safety scan
No issues foundOur scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands.
Automated pattern scan on 2026-11-20. It catches known dangerous patterns, not every risk — read a skill before letting an agent act on it.
scenario-godot-architecture compared with similar skills
All 4 of these similar skills score higher than scenario-godot-architecture; compare them before choosing.
| Skill | Score | Stars | Updated | Format |
|---|---|---|---|---|
| scenario-godot-architecture (this skill)by scenario-labs | 86 | 1.0k | 35d ago | SKILL.md |
| algorithmic-artby anthropics | 100 | 177.9k | 2mo ago | SKILL.md |
| pptxby anthropics | 100 | 177.9k | 2mo ago | SKILL.md |
| prospectingby coreyhaines31 | 100 | 60.1k | 11d ago | SKILL.md |
| ad-creativeby coreyhaines31 | 100 | 60.1k | 11d ago | SKILL.md |
Frequently asked questions
- How do I install scenario-godot-architecture?
- Run
npx skills add scenario-labs/skills --skill scenario-godot-architecture. The install tabs above show the steps for each supported agent. - Which AI agents does scenario-godot-architecture work with?
- It is written for Universal, as a SKILL.md file. Other agents that read the same format can often use it too.
- Is scenario-godot-architecture safe to use?
- Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. It is MIT-licensed and scores 100/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
- Is scenario-godot-architecture still maintained?
- The repository was last updated 35 days ago, so scenario-godot-architecture is actively maintained.
Skill content
View source on GitHubname: scenario-godot-architecture description: "Use when structuring Godot 4.7 game code: folders, scenes and nodes, signals or an event bus autoload, custom Resources for item data, components (health, hitbox, hurtbox), an inventory, save and load, InputMap and key rebinding for keyboard, mouse and gamepad, GDScript static typing and style, or GDScript vs C#; or when code is spaghetti, a folder scan breaks in the export, a save loads wrong, the gamepad does nothing, or @onready is null." license: MIT
Godot architecture (gameplay programmer and architect)
Target: Godot 4.7.2.stable, macOS Apple Silicon.
Expert architecture in Godot means scenes that run alone, data in Resources, behavior in small
components, and every boundary (save file, input, export) proven by a test. This skill holds the
expert rules from the sources, corrected where Godot 4.7.2 behaves differently, plus a tested G1
core (inventory, health and damage, save and load, input with rebinding) and the tools that build
and audit it. If a sibling skill named here is missing from your available skills, load it with
skill_get (Scenario MCP) or ask the user to install it
(https://github.com/scenario-labs/skills#install); unattended, proceed from tool schemas and flag
the gap.
REQUIRED BACKGROUND: scenario-godot-expert (channels, gd_run, the review loop, 4.7 traps).
Status (2026-10-02, round 2): everything below ran in Godot 4.7.2 here. 12 live tests: 11 pass,
the C# check was not run. 30 GUT tests and 17 offline lint checks also pass; round-2 probes are P15
to P17 in references/procedures.md.
Stance (the expert delta)
-
Every scene runs alone; the owner injects. A scene that reaches up (
get_node("/root/..."),../) is coupled to one tree. Use "call down, signal up, event out" (Eric Peterson, yB3Wv-Lr7pg [00:05:54]; Godot docs, Scene organization). An event bus autoload holds signals and no state (Peterson [00:17:36]). State is owned high in the tree and injected downward, because_readyruns children first (Mark Wilson, BgrHnJDt2ww [00:12:29]).arch_audit.gdinstantiates each scene alone and flags errors, NodePaths that do not resolve and node exports left empty. -
Definitions are Resources; per-instance state is not. Keep item databases in typed custom Resources, not Dictionaries: no id typos, and paths follow file moves (Godotneers, 4vAkTHeoORk [00:12:57]). A loaded Resource is one shared instance: a change through one reference is seen by the next
load()(verified), so treat definitions as read-only. Stacks, health and cooldowns go in RefCounted or Node objects. For a per-instance copy (durability, rolled stats) useduplicate()when the Resource is flat, andduplicate_deep(Resource.DEEP_DUPLICATE_ALL)when it holds external sub-resources:duplicate(true)kept those shared (verified). One Resource class per file, and a default for every_initparameter (Godot docs, Resources): an inner-class Resource reloaded its field as null, and_init(p_hp)without a default lost its fields (verified). -
Never list folders at runtime; build a registry at edit time. Folder scans work in the editor and break in exports (Godotneers [01:13:35]). In an exported
.pck,DirAccess.get_files_atreturned only*.tres.remap(a naive scan loaded 0 of 3), whilelist_directoryand theItemCatalogfrombuild_catalogfound all 3 (verified). The pack is case-sensitive: a wrong-case path loaded on macOS with only a "Case mismatch" warning and did not exist in the pack, so name every file and folder in lowercase snake_case (Godot docs, Project organization; lint A11, A12). A.gdignoremust be empty and takes no patterns (lint A15). It hides a folder from the importer, not fromload(): an.svginside failed with "No loader found", while a text.tresstill loaded (verified [added]). -
A save file is data, never code. Verified 4.7.2 [added]:
- a
.treswritten touser://with an embedded GDScript ran that script onload(); str_to_varandConfigFile.parseboth built a Node fromObject(Node,...)text.
Use a JSON envelope (
format,version,data) withJSON.from_native. It keeps int, StringName and Vector3, while plain JSON returns 3 as 3.0. It refuses objects: it logs an error and writes null. Write atomically (.tmp,.bak, rename) and migrate by version. Plan saving from the start (Wilson [00:17:03]). - a
-
Stable roots, one level entry point, spawns under a stable parent.
MainGamecoordinates fixed containers, and the level exposes spawn markers and never owns the player (FAT Earth Studios, V4SO7foDoW4 [00:04:56]). Projectiles go underEntityRootorEffectRoot, because freeing a tower freed its children (Godotneers, W8gYHTjDCic [01:05:16]). Change levels at idle time (FAT Earth [00:10:13]). Changing level insidebody_enteredlogs "Removing a CollisionObject node during a physics callback";request_level()defers and is clean. Fix to the source'sinstantiate() as BaseLevel[added]: a wrong type gave null and leaked the instance after the old level was gone, so checkis BaseLevelfirst and free it on refusal (verified). -
Input is one table, written by a tool.
InputActions.defaults()feedssetup_input, which writes[input]intoproject.godot. Every event usesdevice = -1. Verified: a joypad event built in code defaults to device 0 and does not match pad 1. Keyboard reports device 16 and mouse 32 in 4.7 (version deltas). Bind keys byphysical_keycode[added]. Store runtime rebinds as plain JSON inuser://, never as InputEvent resources. -
Static typing is a gate, not a style. Typing warnings are off by default (Godot docs, Static typing). At warn level (1) nothing prints headless, so
typing_gatesets them to error (2) on an APFS clone. Typed code is faster by less than Boon's 116% (mNa0m2fvGOc [00:01:39]; see Numbers). Cast policy (docs, Static typing):x as Treturns null silently, while a typed assignmentvar l: Label = nodefails loudly ("Trying to assign value of type 'Button' to a variable of type 'Label'") and aborts the function. Useisand a typed local, or the typed assignment where a wrong type is a bug; keepasfor a null you handle.var n := get_node("X")infers plainNode, and the gate rejectsn.position("not present on the inferred type Node"): writevar n: Node2D = $X. Nested typed collections do not compile ("Nested typed collections are not supported");Array[Array]andDictionary[StringName, Array]do. Use typed math:clampfran 1.70x to 1.74x faster thanclampover 1M calls, andclamp()on Colors is a parse error, so useColor.clamp()(verified). -
Flip the sprite, not the body. FAT Earth's rule (zLdTvkLsmgA [00:04:30]) holds, but the cause differs. Verified in 2D: shapes followed the mirror, but
move_and_sliderewrote scale (-1, 1) as rotation 180 and scale.y -1, so per-framescale.x = -1flipped the body every frame. Useflip_hand mirror the marker positions. -
preloadis a strong reference held by the script (FAT Earth, zLdTvkLsmgA [00:05:34]). Verified: a preloaded.treswas cached as soon as its holder script loaded, with no instance, and stayed cached after the probe dropped the script; aload()in_readywas released when its node was freed. A permanent node preloading menu > cutscene > level keeps the chain alive: preload small pieces next to their user, load levels and menus on demand (lint A09).
Also from the sources (short rules)
| Rule | Source | Checked here |
| --------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------ | ------------------------------------------------------------------------------------------------------------ |
| Open sets talk by duck typing: has_method(&"take_damage"), groups as classifiers, propagate_call(&"on_game_over"), call_group. Your own components use is Hurtbox3D | Godotneers, W8gYHTjDCic [00:19:36, 00:38:12] | propagate_call reached a grandchild |
| A silent collision is a layer or mask bug first | W8gYHTjDCic [01:03:09] | arch_audit flags layer 0 with mask 0; unmatched_masks (P16) flags mask bits no object uses as a layer |
| A state Resource as source of truth lets you dump and reload the whole game to retest a bug. Dev builds only: never load a player-supplied .tres (stance 4) | Szuflita, 1qHPKg_Xovs [00:06:11] | dump to user://debug/, reload with CACHE_MODE_IGNORE: values intact |
| top_level = true, or a plain Node between two Node2D, cuts transform inheritance | Godot docs, Scene organization | parent moved to x=100: both children stayed at x=10, a normal child went to 110 |
| ItemList.select() emits no item_selected: call the handler. The list requests 0x0: set custom_minimum_size (250 px in the source) | 4vAkTHeoORk [00:53:45, 00:47:32] | 0 signals, minimum size (0, 0) |
| Craft checks copy the recipe before erasing from it | 4vAkTHeoORk [01:07:14] | Inventory.has_all test |
| A dialog in a captured-mouse 3D game sets MOUSE_MODE_VISIBLE and restores the previous mode on close | 4vAkTHeoORk [00:37:01] | headless reads mode 0 whatever you set: test windowed or by hand |
| Build a debug god mode early (no gravity, no hurtbox, faster) | zLdTvkLsmgA [00:02:34] | concept, not run |
| Git: ignore .godot/, commit .uid sidecars, LFS patterns in .gitattributes, commit cleanly before an add-on or a Godot upgrade | BatteryAcidDev, c3Jf-av_5NE [00:02:40, 00:22:20] | git check-attr routes png to lfs; scripts get .gd.uid, text .tres files do not (git-lfs not installed) |
Establish first
- 2D or 3D, genre, single or local multiplayer (local multiplayer needs one action set per device,
not
device = -1). - Target platforms (exports are case-sensitive; C# cannot export to the web).
- Language: GDScript by default; C# needs the .NET build plus the SDK (check for a
.csproj; note inreferences/expert-notes.md). - Save needs (slots, autosave, versioning, cloud), devices (pads, rebinding), and whether a GUI editor has th
Truncated for display — read the full file on GitHub.
Related Skills
algorithmic-art
177.9kCreating algorithmic art using p5.js with seeded randomness and interactive parameter exploration. Use this when users request creating art using code, generative art, algorithmic art, flow fields, or particle systems.
pptx
177.9kUse this skill any time a .pptx or .potx file is involved in any way — as input, output, or both. This includes: creating slide decks, pitch decks, or presentations; reading, parsing, or extracting text from any .pptx or .potx file (even if the extracted content will be used elsewhere, like in an em…
prospecting
60.1kWhen the user wants to find and qualify prospects for outbound, or asks who to target first, which signal to prioritize, or where to spot buyers with the problem: buying signals, enrichment, verification, account research.
ad-creative
60.1kWhen the user wants to write or judge ad creative, or asks which ad, hook, or angle to run or kill: headlines, primary text, and variations for Google, Meta, LinkedIn, and TikTok, fresh angles when creative fatigues. Test hypotheses name the metric, comparison, and expected direction.
Languages
Trust signals
From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.
