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

godot-2d-physics — Claude Code skill: what it does, how to install

Guides coding agents through Godot 2D physics architecture. Prevents common pitfalls across collision layers, raycasts, and custom space queries.

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

What godot-2d-physics does

This skill provides strict guardrails for Godot 2D physics implementation. It stops the agent from scaling CollisionShape2D nodes directly and prevents mixing up collision_layer with collision_mask. Bodies must stay inside _physics_process().

The skill routes tasks to specialized GDScript files instead of generic code. It points the agent to physics_server_swarm.gd for thousands of projectiles, shapecast_aoe.gd for combat volumes, and raycast_vision_stack.gd for vision cones. Polling get_overlapping_bodies() every frame is replaced with signal caching.

Mind the low-level cleanup. Any RID created through PhysicsServer2D requires manual deletion, or memory will leak permanently. Continuous collision detection should also stay disabled on slow props to prevent unnecessary CPU load.

What it helps with

  • configure collision layer and mask matrices
  • handle high-density swarms using PhysicsServer2D
  • query manual raycasts mid-frame with force_raycast_update
  • eliminate physics jitter on high-refresh displays

Example prompts for the agent

  • Configure separate collision layers and masks for enemies and walls in Godot
  • Implement line-of-sight raycasting using PhysicsDirectSpaceState2D
  • Move bullet swarm logic from Area2D to PhysicsServer2D

How to install godot-2d-physics

1Skills CLI (Vercel)

npx skills add thedivergentai/Game-Dev-Agentic-Skills --skill godot-2d-physics -a claude-code

2Manually: put the files in place

~/.claude/skills/godot-2d-physics/SKILL.md

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

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

Questions about godot-2d-physics

How to install godot-2d-physics in Claude Code?

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

What does godot-2d-physics do?

It supplies strict anti-patterns and GDScript workflows for Godot 2D physics, preventing common transform scaling bugs and timing mistakes.

Why does the skill restrict continuous collision detection?

Continuous collision detection creates notable CPU overhead. It should stay off on slow bodies and only protect high-speed projectiles from tunneling.

Similar skills

Everything for Game dev and 3D: Unity, Unreal, Godot, Blender →
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 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-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-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 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-save-load-systems Save and load blueprints for Godot covering JSON and binary serialization, version migration, and rolling backups. Keeps game state handling consistent. CX Codex +1 595installs godot-testing-patterns Provides testing decision trees and GdUnit4 templates for Godot. Guides developers through unit tests, headless CI runs, frame stepping, and network mocks. CX Codex +1 585installs godot-3d-world-building A skill for building 3D levels in Godot: GridMap with MeshLibrary, CSG greyboxing, occlusion and chunk streaming. Useful once a prototype has to become a playable scene. CX Codex +1 536installs godot-composition Tells your agent to build Godot entities from components instead of inheritance chains, with ready-made GDScript files for health, hitboxes and movement. CX Codex +1 519installs 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-project-foundations Guides Godot 4 project architecture with feature-oriented directory layouts, naming standards, and clean Git ignore rules. CX Codex +1 499installs

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