godot-raycasting-queries — Claude Code skill: setup guide
godot-raycasting-queries is a Claude Code skill with Godot physics query blueprints for RayCast, ShapeCast, and DirectSpaceState. It helps implement hit detection, mouse picking, and AI vision cones.
LGPL-3.0 328 installs ★ 983 updated 2026-10-16
npx skills add thedivergentai/Game-Dev-Agentic-Skills --skill godot-raycasting-queries -a claude-codeWhat godot-raycasting-queries does
This skill provides structured GDScript blueprints for 2D and 3D physics queries. It guides the agent on bypassing node overhead with direct intersect_ray calls, handling screen-to-world clicks, and calculating laser reflections.
Included scripts handle footing checks via ShapeCast, AI field-of-view scanners, and piercing projectile chains. Physics queries run strictly within _physics_process because querying direct_space_state during normal frames triggers thread safety issues while Godot locks the simulation. The recipes enforce caster RID exclusion to stop rays from hitting the originating body.
What it helps with
- implement 3D mouse picking from viewport coordinates
- prevent self-collision by filtering out caster RIDs
- detect uneven ground contact using ShapeCast volumes
- build piercing projectiles that record multiple hits along a line
Example prompts for the agent
- Set up screen-to-world raycasting for clicking 3D objects with PhysicsRayQueryParameters3D.
- Implement character ground detection using ShapeCast3D instead of thin rays.
- Create an AI visibility cone using raycasts while excluding the agent RID.
How to install godot-raycasting-queries
1Skills CLI (Vercel)
npx skills add thedivergentai/Game-Dev-Agentic-Skills --skill godot-raycasting-queries -a claude-code2Manually: put the files in place
~/.claude/skills/godot-raycasting-queries/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/godot-raycasting-queries/
1Skills CLI (Vercel)
npx skills add thedivergentai/Game-Dev-Agentic-Skills --skill godot-raycasting-queries -a codex2Manually: put the files in place
.agents/skills/godot-raycasting-queries/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add thedivergentai/Game-Dev-Agentic-Skills --skill godot-raycasting-queries -a cursor2Manually: put the files in place
.cursor/skills/godot-raycasting-queries/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install thedivergentai/Game-Dev-Agentic-Skills skills/godot-raycasting-queries2Manually: put the files in place
.github/skills/godot-raycasting-queries/SKILL.md1Skills CLI (Vercel)
npx skills add thedivergentai/Game-Dev-Agentic-Skills --skill godot-raycasting-queries -a gemini-cli2Platform CLI
gemini skills install https://github.com/thedivergentai/Game-Dev-Agentic-Skills --path skills/godot-raycasting-queriesManually: put the files in place
.devin/skills/godot-raycasting-queries/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add thedivergentai/Game-Dev-Agentic-Skills --skill godot-raycasting-queries -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-raycasting-queries
How to install godot-raycasting-queries in Claude Code?
Run npx skills add thedivergentai/Game-Dev-Agentic-Skills --skill godot-raycasting-queries -a claude-code.
What does godot-raycasting-queries do?
It equips the agent with GDScript blueprints for raycasting, volume queries, and server-side physics lookups in Godot projects.
Why must direct_space_state stay inside _physics_process?
Godot can lock the physics world or run it on another thread, making direct queries inside _process unsafe.