Godot Genre Card Game

Solid foundation for CCG and deckbuilder mechanics in Godot, covering the stuff that trips people up: resource-based card definitions, LIFO effect stacks for proper trigger resolution, and hand arc layouts using Curve2D instead of fighting with Control positioning. The anti-patterns section is actually useful, especially the warnings about z-index management during drag-and-drop and using signal-driven updates instead of _process() spam for card stats. Includes tweening patterns for card movement, deck shuffling with discard pile auto-reshuffle, and the command pattern for decoupling card effects from UI. Leans opinionated on architecture but that's the point. Good starting blueprint if you're past the prototype stage and need your card game to feel responsive instead of janky.

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

View on GitHub

Install

$ npx -y skills add thedivergentai/gd-agentic-skills --skill godot-genre-card-game --agent claude-code

Installs into .claude/skills of the current project.

Files

NEVER Do (Expert Anti-Patterns)

Logic & Architecture

NEVER hardcode card logic inside UI scripts; strictly encapsulate gameplay effects in Callable objects or Command resources pushed to a LIFO stack.
NEVER perform board-state calculations (Power/Toughness) in _process(); strictly use Signal-driven triggers or a centralized EffectStack resolver.
NEVER forget LIFO Stack Resolution; strictly use Array.push_back() and Array.pop_back() to resolve reactions from top-to-bottom.

UX & Animation

NEVER skip Z-Index management during drag-and-drop; strictly raise the card to the front on click to prevent it sliding under other cards.
NEVER allow instant card "teleportation" between piles; strictly use create_tween() / tween_property chains (0.2s+) for pile moves.
NEVER use global_position for cards in hand; strictly position them using a Curve2D layout with sample_baked() for smooth arcs.