fix-3d-physics-collisions — Claude Code skill: 3D physics repair
fix-3d-physics-collisions — a skill for Claude Code that diagnoses and repairs Unity 3D physics, including failed collision events and trigger issues. It runs when resolving OnCollisionEnter or OnTriggerEnter errors.
no license 673 installs ★ 1,306 updated 2026-10-23
npx skills add Unity-Technologies/skills --skill fix-3d-physics-collisions -a claude-codeWhat fix-3d-physics-collisions does
The skill diagnoses PhysX collision, trigger, and raycast problems by analyzing project settings and using the unity-cli for state verification. It references official Unity manual documentation based on the version found in ProjectSettings/ProjectVersion.txt. Always create a restore point before running corrections, as the skill performs targeted edits.
It avoids leaving verification code or logs in the user scripts and requires Unity 6000.3 or newer to function properly.
What it helps with
- resolve objects passing through colliders
- fix failed
OnTriggerEnterevent execution - configure
MeshColliderproperties correctly - debug inaccurate Raycast misses
Example prompts for the agent
- Fix the
OnCollisionEnternot firing inPlayerController.cs - Why are raycasts missing the
MeshColliderobjects?
How to install fix-3d-physics-collisions
1Skills CLI (Vercel)
npx skills add Unity-Technologies/skills --skill fix-3d-physics-collisions -a claude-code2Manually: put the files in place
~/.claude/skills/fix-3d-physics-collisions/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/fix-3d-physics-collisions/
1Skills CLI (Vercel)
npx skills add Unity-Technologies/skills --skill fix-3d-physics-collisions -a codex2Manually: put the files in place
.agents/skills/fix-3d-physics-collisions/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add Unity-Technologies/skills --skill fix-3d-physics-collisions -a cursor2Manually: put the files in place
.cursor/skills/fix-3d-physics-collisions/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install Unity-Technologies/skills skills/fix-3d-physics-collisions2Manually: put the files in place
.github/skills/fix-3d-physics-collisions/SKILL.md1Skills CLI (Vercel)
npx skills add Unity-Technologies/skills --skill fix-3d-physics-collisions -a gemini-cli2Platform CLI
gemini skills install https://github.com/Unity-Technologies/skills --path skills/fix-3d-physics-collisionsManually: put the files in place
.devin/skills/fix-3d-physics-collisions/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add Unity-Technologies/skills --skill fix-3d-physics-collisions -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 fix-3d-physics-collisions
How to install fix-3d-physics-collisions in Claude Code?
Run npx skills add Unity-Technologies/skills --skill fix-3d-physics-collisions -a claude-code, then use the config file at ~/.claude/skills/fix-3d-physics-collisions/SKILL.md.
What does fix-3d-physics-collisions do?
It diagnoses and fixes 3D PhysX issues like trigger failures, layer-based collision bugs, and raycast misses in Unity projects.
What is required for fix-3d-physics-collisions?
It requires Unity 6000.3 or higher and the unity-cli tool to be available in your environment.