Skip to main content
skill CX Codex

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

Supplies proven patterns for Godot 3D physics across Jolt and native backends. Solves ragdoll transitions, joint setups, stair stepping, and projectile tunneling.

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

What godot-physics-3d does

The skill prevents common Godot physics mistakes when working with Jolt or standard solvers. It blocks scaling collision shapes directly, moving bodies inside _process(), and modifying RigidBody3D transforms outside the solver. Instead, it instructs the agent to use impulses, apply torques, or utilize CharacterBody3D for platformer movement.

It references specific scripts for stair logic, vehicle tuning, soft bodies, and Joint3D breakage. Direct server allocation via PhysicsServer3D requires explicit free_rid() calls, because Godot will not garbage-collect these handles on its own.

What it helps with

  • handle stair stepping smoothly using ShapeCast3D volumes
  • transition character animations into PhysicalBone3D ragdolls
  • eliminate projectile tunneling through walls with CCD sub-stepping
  • structure 3D collision layers and masks to cut redundant checks

Example prompts for the agent

  • Implement stair step smoothing for my CharacterBody3D using ShapeCast3D.
  • Set up a PhysicalBone3D ragdoll transition with an impulse on impact.
  • Configure high-speed projectile collision handling to avoid tunneling through thin walls.

How to install godot-physics-3d

1Skills CLI (Vercel)

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

2Manually: put the files in place

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

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

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

Questions about godot-physics-3d

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

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

What does the godot-physics-3d skill do?

It provides strict rules and script blueprints for 3D physics in Godot, guiding the agent to pick the right body types and avoid simulation jitter.

Why does the skill reject single RayCast3D nodes for stairs?

A single ray is too thin and frequently misses step edges. The skill enforces using ShapeCast3D with a cylinder or sphere shape for reliable ground checks.

Similar skills

Everything for Game dev and 3D: Unity, Unreal, Godot, Blender →

From the same set61

godot-animation-player Guides AnimationPlayer patterns in Godot, covering track types, RESET track setups, root motion physics synchronization, and method call modes. CX Codex +1 427installs godot-3d-materials This skill guides Godot PBR material setup and points to scripts for textures, transparency, and visual effects. Use it while building 3D surfaces or tuning material workflows. CX Codex +1 424installs godot-navigation-pathfinding Teaches your AI assistant to handle path planning, crowd movement, and runtime navmesh generation in Godot. Prevents stuttering and silent bugs in RTS or stealth projects. CX Codex +1 421installs godot-inventory-system An agent skill that walks through building a Godot inventory: slots, stacks, weight limits, equipment and drag-drop. CX Codex +1 425installs godot-platform-mobile A skill that steers your coding agent through Godot's mobile side: touch input, screen cutouts, throttling and Android permissions. CX Codex +1 421installs godot-export-builds A skill that walks your agent through Godot exports: templates, headless builds, Android signing, macOS notarization and CI. Useful before a release. CX Codex +1 422installs godot-ability-system A skill that gives your coding agent patterns for Godot ability systems: cooldowns, combos, skill trees, charges and status effects. CX Codex +1 418installs godot-animation-tree-mastery Guides AI coding agents through Godot AnimationTree setups, StateMachine graphs, and blend spaces. Useful when building character movement and combat layers. CX Codex +1 412installs

Project sponsors

Companies that keep this analytics open
Gold sponsor

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