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.
npx skills add thedivergentai/Game-Dev-Agentic-Skills --skill godot-physics-3d -a claude-codeWhat 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-code2Manually: put the files in place
~/.claude/skills/godot-physics-3d/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/godot-physics-3d/
1Skills CLI (Vercel)
npx skills add thedivergentai/Game-Dev-Agentic-Skills --skill godot-physics-3d -a codex2Manually: put the files in place
.agents/skills/godot-physics-3d/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add thedivergentai/Game-Dev-Agentic-Skills --skill godot-physics-3d -a cursor2Manually: put the files in place
.cursor/skills/godot-physics-3d/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install thedivergentai/Game-Dev-Agentic-Skills godot-physics-3d2Manually: put the files in place
.github/skills/godot-physics-3d/SKILL.md1Skills CLI (Vercel)
npx skills add thedivergentai/Game-Dev-Agentic-Skills --skill godot-physics-3d -a gemini-cli2Platform CLI
gemini skills install https://github.com/thedivergentai/Game-Dev-Agentic-Skills --path skills/godot-physics-3dManually: put the files in place
.devin/skills/godot-physics-3d/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add thedivergentai/Game-Dev-Agentic-Skills --skill godot-physics-3d -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
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.