godot-game-loop-time-trial — Claude Code skill: setup and patterns
godot-game-loop-time-trial is a Claude Code skill for Godot 4 racing trials, with ordered checkpoint validation, lap timing, and ghost playback.
LGPL-3.0 294 installs ★ 983 updated 2026-10-16
npx skills add thedivergentai/Game-Dev-Agentic-Skills --skill godot-game-loop-time-trial -a claude-codeWhat godot-game-loop-time-trial does
This skill supplies battle-tested structures for Godot 4 time trials and speedrun mechanics. Central to the setup is a sequence-validating TimeTrialManager that registers checkpoint overlaps within physics processing. It stops shortcut cheating by demanding that triggers fire in strict numerical order.
Ghost telemetry captures positions alongside Quaternion rotations at a fixed tick rate. The replayer mixes linear position interpolation with Quaternion.slerp for smooth visual steering. Euler interpolation is deliberately avoided to prevent gimbal lock artifacts during playback.
What it helps with
- block track shortcuts by enforcing strict checkpoint sequences
- record and replay ghost runs smoothly via Quaternion slerp
- measure lap times with microsecond precision instead of coarse ticks
- store movement trajectories in PackedVector3Array to reduce garbage collection
Example prompts for the agent
- Set up TimeTrialManager with checkpoint validation for my racing track in Godot 4
- Implement ghost recording and playback using ghost_recorder.gd and Quaternion slerp
- Format raw microsecond lap records into display strings for a leaderboard
How to install godot-game-loop-time-trial
1Skills CLI (Vercel)
npx skills add thedivergentai/Game-Dev-Agentic-Skills --skill godot-game-loop-time-trial -a claude-code2Manually: put the files in place
~/.claude/skills/godot-game-loop-time-trial/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/godot-game-loop-time-trial/
1Skills CLI (Vercel)
npx skills add thedivergentai/Game-Dev-Agentic-Skills --skill godot-game-loop-time-trial -a codex2Manually: put the files in place
.agents/skills/godot-game-loop-time-trial/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add thedivergentai/Game-Dev-Agentic-Skills --skill godot-game-loop-time-trial -a cursor2Manually: put the files in place
.cursor/skills/godot-game-loop-time-trial/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install thedivergentai/Game-Dev-Agentic-Skills skills/godot-game-loop-time-trial2Manually: put the files in place
.github/skills/godot-game-loop-time-trial/SKILL.md1Skills CLI (Vercel)
npx skills add thedivergentai/Game-Dev-Agentic-Skills --skill godot-game-loop-time-trial -a gemini-cli2Platform CLI
gemini skills install https://github.com/thedivergentai/Game-Dev-Agentic-Skills --path skills/godot-game-loop-time-trialManually: put the files in place
.devin/skills/godot-game-loop-time-trial/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add thedivergentai/Game-Dev-Agentic-Skills --skill godot-game-loop-time-trial -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-game-loop-time-trial
How to install godot-game-loop-time-trial in Claude Code?
Run npx skills add thedivergentai/Game-Dev-Agentic-Skills --skill godot-game-loop-time-trial -a claude-code. The file will be placed in ~/.claude/skills/godot-game-loop-time-trial/SKILL.md.
What does godot-game-loop-time-trial do?
It provides Godot 4 GDScript templates for checkpoint managers, microsecond lap timing, and transform recording for ghost runners.
Why does the skill require physics ticks instead of _process for checkpoints?
Visual frame lag in _process can skip trigger boundaries during fast movement. Checking overlaps inside _physics_process guarantees consistent collision evaluation at fixed intervals.