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

godot-genre-puzzle — Claude Code skill: what it does, how to install

Architectural guidelines for Godot puzzle games. Helps set up grid mechanics, native UndoRedo actions, and soft-lock checks without dragging down frame rates.

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

What godot-genre-puzzle does

This skill guides the agent through building Sokoban-style games, match-3 layouts, and spatial puzzles in Godot. It decouples board state from the SceneTree and mandates Vector2i coordinates. Floating-point coordinates are rejected to prevent precision drift across turns. Win condition and soft-lock validations are kept out of _process(), running strictly after a piece move is committed.

The logic centers around modular scripts for smooth movements, level data serialization via .tres files, and AStarGrid2D.diagonal_mode hints. Maintaining a hand-rolled command stack alongside Godot's built-in UndoRedo is treated as a critical anti-pattern. The skill requires a single undo authority managed through puzzle_undo_manager.gd.

What it helps with

  • implement move history using Godot's native UndoRedo
  • maintain board state in Vector2i decoupled from the SceneTree
  • check win conditions and unsolvable states only on move commits
  • manage tile movement while killing conflicting tweens

Example prompts for the agent

  • Set up an undo and redo system for a Sokoban puzzle using Godot UndoRedo
  • Create a Vector2i grid manager that stores puzzle state outside the SceneTree
  • How do I run soft-lock checks after committing a tile move?

How to install godot-genre-puzzle

1Skills CLI (Vercel)

npx skills add thedivergentai/Game-Dev-Agentic-Skills --skill godot-genre-puzzle -a claude-code

2Manually: put the files in place

~/.claude/skills/godot-genre-puzzle/SKILL.md

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

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

Questions about godot-genre-puzzle

How to install godot-genre-puzzle in Claude Code?

Run npx skills add thedivergentai/Game-Dev-Agentic-Skills --skill godot-genre-puzzle -a claude-code.

What does the godot-genre-puzzle skill do?

It enforces best-practice architecture for Godot puzzle games, focusing on Vector2i grids, turn history, and decoupled validation.

Why does the skill reject custom command stacks for undo?

Running two undo paths causes state desynchronization, so the skill mandates Godot's built-in UndoRedo via puzzle_undo_manager.gd.

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-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 godot sanjeed5 A Cursor rule that steers the agent toward Godot 4.x conventions: scene composition over inheritance, signals over direct node calls, careful resource loading. ★ 3,579repo stars godot-ui Zate Gives the agent working knowledge of Godot Control nodes, themes and common screens. Useful when building menus, HUDs or inventories. CX Codex +1 2,700installs godot-asset-generator agent-skills Generates 2D sprites, tilesets, and UI assets using image generation APIs, then configures them for Godot 4.x. Useful for rapid game prototyping. CX Codex +1 1,000installs

From the same set51

godot-genre-platformer Equips AI coding assistants with Godot platformer movement standards, from coyote timing and jump buffering to camera smoothing. Handy for building responsive character controls. CX Codex +1 342installs godot-quest-system A skill that steers your coding agent through building a Godot quest system: objectives, progress, rewards, branching chains. Useful when an RPG needs its quest logic sorted out. CX Codex +1 344installs godot-genre-idle-clicker A skill for idle games in Godot: big numbers, exponential costs, offline income and prestige. CX Codex +1 338installs godot-composition-apps Architecture rules for Godot apps and tool windows: an orchestrator plus components, signals up, calls down. CX Codex +1 330installs godot-genre-visual-novel An agent skill for building visual novels in Godot: branching narrative, dialogue, rollback and persistent flags. CX Codex +1 330installs godot-genre-simulation A skill for building simulation and tycoon games in Godot: integer-cent economy, physics-driven ticks, NPC schedules. Useful once your city or factory starts to stutter. CX Codex +1 330installs godot-genre-horror Provides horror game blueprints and rules for Godot projects. It structures tension pacing, sensory stalker logic, and inventory scarcity. CX Codex +1 324installs godot-genre-rts A blueprint for real-time strategy in Godot: drag-box selection, command queues, fog of war, resource economy and AI opponents, with a list of what to avoid. CX Codex +1 307installs

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