Godot Composition

This is a strict architectural style guide for building Godot games using composition instead of inheritance hierarchies. You get nine ready-to-use components (health, hitbox, velocity, state machine, status effects) plus wiring patterns that enforce single responsibility through what it calls the "Orchestrator" model. The parent node does no logic, just connects specialized worker nodes via signals up and method calls down. It's opinionated about avoiding get_node calls, deep inheritance chains, and mixing input with physics. Best for mid-sized projects where you're tired of refactoring brittle player controllers or want to share combat logic between enemies and NPCs without copy-pasting. The "never" section is longer than the implementation examples, which tells you what kind of discipline this expects.

skills.sh installs: 326
GitHub stars: 464
last updated: Aug 21, 2026

View on GitHub

Install

$ npx -y skills add thedivergentai/gd-agentic-skills --skill godot-composition --agent claude-code

Installs into .claude/skills of the current project.

Files

Core Philosophy

This skill enforces Composition over Inheritance ("Has-a" vs "Is-a"). In Godot, Nodes are components. A complex entity (Player) is simply an Orchestrator managing specialized Worker Nodes (Components).

The Golden Rules

Single Responsibility: One script = One job.
Encapsulation: Components are "selfish." They handle their internal logic but don't know who owns them.
The Orchestrator: The root script (e.g., player.gd) does no logic. It only manages state and passes data between components.
Decoupling: Components communicate via Signals (up) and Methods (down).

Decision Tree — Composition vs Autoload vs Inheritance

Situation	Choose
Gameplay entity behaviors (HP, hitbox, move, interact)	Composition — child components + orchestrator (composition_root_init.gd)
Cross-scene services (audio bus, save, net, economy ledger)	Autoload — not a component on the player
True is-a engine specialization (custom Control/Node with shared lifecycle)	Inheritance exception — rare; never for "adds a gun" / "adds HP"