Skip to main content
affpapa.org
RU EN
skill CX Codex

godot-project-foundations — Claude Code skill: setup and features

Guides Godot 4 project architecture with feature-oriented directory layouts, naming standards, and clean Git ignore rules.

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓ 
npx skills add thedivergentai/Game-Dev-Agentic-Skills --skill godot-project-foundations -a claude-code
Open on GitHub

What godot-project-foundations does

This skill enforces architectural structure for Godot 4 games. Instead of lumping files into broad script or sprite directories, it organizes folders by game feature. It applies snake_case for project files, PascalCase for scene tree nodes, and mandates %SceneUniqueNames over fragile get_node() hierarchies.

Included GDScript utilities take care of foundational tasks. You get project_bootstrapper.gd for folder generation, global_event_bus.gd for decoupled signals, and async_resource_loader.gd for threaded scene transitions. Version control rules block .godot/ cache commits and set up .gdignore files for source art directories.

Running dependency_auditor.gd during standard development is explicitly discouraged because it exists only for troubleshooting import errors. The skill also expects Untyped Declaration under Godot project settings configured as Warn or Error.

What it helps with

  • scaffold feature-based directory structures in Godot 4
  • prevent committing heavy engine cache files via .gitignore
  • replace fragile get_node() paths with %SceneUniqueNames
  • implement background scene loading without locking the main thread

Example prompts for the agent

  • Scaffold a Godot 4 project directory layout with feature folders for player and UI.
  • Audit node names in this scene and replace hardcoded paths with %SceneUniqueNames.
  • Generate a project .gitignore and configure the global event bus script.

How to install godot-project-foundations

1Skills CLI (Vercel)

npx skills add thedivergentai/Game-Dev-Agentic-Skills --skill godot-project-foundations -a claude-code

2Manually: put the files in place

~/.claude/skills/godot-project-foundations/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/godot-project-foundations/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about godot-project-foundations

How to install godot-project-foundations in Claude Code?

Run npx skills add thedivergentai/Game-Dev-Agentic-Skills --skill godot-project-foundations -a claude-code in your terminal.

Why does the skill enforce feature folders over file type folders?

Grouping all scripts or textures into monolithic directories hurts maintainability as games grow. Keeping scenes, logic, and assets together within each feature folder keeps components self-contained.

How does this skill handle node referencing inside scenes?

It bans hardcoded get_node() paths because re-parenting nodes breaks them. Instead, it relies on %SceneUniqueNames to maintain stable node lookups.

Similar skills

Everything for Game dev and 3D: Unity, Unreal, Godot, Blender →
godot-gdscript gamedev-skills Guides coding assistants in writing statically typed GDScript 2.0 for Godot 4.7 and porting legacy scripts from Godot 3.x. Helpful when structuring node lifecycles and signals. CX Codex +1 6,500installs godot-physics gamedev-skills Configures Godot 4.7 2D and 3D physics bodies, collision layers, Area triggers, and raycasts. It prevents jitter and collision mask misconfigurations. CX Codex +1 6,300installs godot-best-practices agent-skills Enforces GDScript standards and scene architecture for Godot 4.x. Guides coding agents on static typing, signal connections, node references, and resource loading. CX Codex +1 2,100installs cli-anything-godot HKUDS Controls Godot projects from the command line, including scenes, GDScript runs, and exports. Useful when an agent needs to change or inspect a game project. CX Codex +1 548installs godot-prompter jame581 A skill pack for Godot 4.x game development. Your agent loads the relevant domain skill and follows engine-specific practice instead of generic advice. ★ 867repo stars godot-mcp-enhanced wgt19861219 Gives an agent 46 MCP tools to read, write, run and verify Godot 4.5–4.7 projects without opening the editor. CX Codex +1 ★ 103repo stars

From the same set50

godot-2d-physics Guides coding agents through Godot 2D physics architecture. Prevents common pitfalls across collision layers, raycasts, and custom space queries. CX Codex +1 516installs godot-ui-containers Provides blueprints and rules for responsive Godot UI using Container nodes. Useful when building adaptive menus, shop grids, or virtualized scroll lists. CX Codex +1 507installs godot-input-handling A skill that gives your coding agent ready patterns for Godot input: InputMap actions, gamepads, rebinding, deadzones and input buffering. CX Codex +1 509installs godot-combat-system A skill that tells the agent how to build hitboxes, damage and i-frames in Godot. Useful for action games, RPGs and fighters. CX Codex +1 507installs godot-audio-systems A skill with ready-made Godot audio scripts: voice pools, buses, attenuation, music transitions. Useful once your sound starts clipping or dropping out. CX Codex +1 502installs godot-resource-data-patterns A Godot skill that steers your agent toward Resource and RefCounted patterns for item databases, character stats and reusable data. CX Codex +1 497installs godot-performance-optimization Blueprint for profiling and resolving frame drops, draw call spikes, and memory leaks in Godot. Guides agents to profile before optimizing. CX Codex +1 483installs godot-state-machine-advanced A Godot skill for hierarchical finite state machines and pushdown automata: ready scripts for sub-states, state stacks and transition validation. CX Codex +1 486installs

Project sponsors

Companies that keep this analytics open
Gold sponsor
Nutra.Club

Impressions, clicks and code copies — open statistics. We keep the numbers public for the same reason NeBlask itself is public. Become a sponsor