godot-genre-rhythm — Godot skill: audio-synced rhythm systems
godot-genre-rhythm is a skill with components for rhythm games: audio sync, note highways, and a judgment system. It supports game mechanics with combos and tempo changes.
LGPL-3.0 309 installs ★ 983 updated 2026-10-16
npx skills add thedivergentai/Game-Dev-Agentic-Skills --skill godot-genre-rhythm -a claude-codeWhat godot-genre-rhythm does
Rhythm games live or die on tight sync between music and player input. This skill packages production-grade components: rhythm_conductor.gd feeds the authoritative song time (playback position + audio buffer drift − hardware latency via AudioServer.get_time_since_last_mix()), input_judge_logic.gd compares button presses against target times in milliseconds rather than pixels, note_object_pool.gd recycles note objects instead of instantiating per beat (critical on dense charts). Includes judgment logic, combo tracking, and a tempo-map handler for dynamic BPM changes.
You'll need comfort with Godot's audio API and timing primitives. Hardware latency spans 30–100 ms depending on gear and Bluetooth; the skill includes latency_calibrator.gd for per-player calibration. Moving thousands of note sprites on CPU is too slow—use GPU-accelerated UV scrolling; the skill sketches the pattern but you'll adapt it to your visual style. Internally leans on object pooling and ResourceLoader.load_threaded_request() to avoid frame stalls when loading charts.
What it helps with
- Keep music and button presses locked in sync without perceivable lag
- Judge a tap into the correct timing window (Perfect vs. Great vs. Good)
- Scroll a note highway smoothly toward the judgment zone
- Layer score multipliers on top of combo chains and handle misses
- Absorb Bluetooth and audio-interface delays so gameplay feels fair
Example prompts for the agent
- Build a two-lane rhythm game using godot-genre-rhythm: BPM 120, four-part chart, full judgment system
- Wire the music conductor and input judge from godot-genre-rhythm into a scene and load a beatmap from JSON
- Set up latency calibration with latency_calibrator.gd and apply the offset to the conductor
How to install godot-genre-rhythm
1Skills CLI (Vercel)
npx skills add thedivergentai/Game-Dev-Agentic-Skills --skill godot-genre-rhythm -a claude-code2Manually: put the files in place
~/.claude/skills/godot-genre-rhythm/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/godot-genre-rhythm/
1Skills CLI (Vercel)
npx skills add thedivergentai/Game-Dev-Agentic-Skills --skill godot-genre-rhythm -a codex2Manually: put the files in place
.agents/skills/godot-genre-rhythm/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add thedivergentai/Game-Dev-Agentic-Skills --skill godot-genre-rhythm -a cursor2Manually: put the files in place
.cursor/skills/godot-genre-rhythm/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install thedivergentai/Game-Dev-Agentic-Skills skills/godot-genre-rhythm2Manually: put the files in place
.github/skills/godot-genre-rhythm/SKILL.md1Skills CLI (Vercel)
npx skills add thedivergentai/Game-Dev-Agentic-Skills --skill godot-genre-rhythm -a gemini-cli2Platform CLI
gemini skills install https://github.com/thedivergentai/Game-Dev-Agentic-Skills --path skills/godot-genre-rhythmManually: put the files in place
.devin/skills/godot-genre-rhythm/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add thedivergentai/Game-Dev-Agentic-Skills --skill godot-genre-rhythm -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-genre-rhythm
How do I install godot-genre-rhythm?
Run npx skills add thedivergentai/Game-Dev-Agentic-Skills --skill godot-genre-rhythm -a claude-code, then open ~/.claude/skills/godot-genre-rhythm/SKILL.md. For other platforms, swap the platform flag: -a codex for Codex, -a cursor for Cursor, -a gemini-cli for Gemini CLI.
What does godot-genre-rhythm provide?
A library of production scripts for rhythm games: a conductor that locks to audio playback with latency correction, an input judge that scores taps into timing windows, object pooling for notes, combo and score tracking, and a hardware delay calibrator for players.
How tight is the sync?
The conductor reads AudioStreamPlayer.get_playback_position() + AudioServer.get_time_since_last_mix() − AudioServer.get_output_latency() instead of Time.get_ticks_msec(), holding sync to 1–2 ms. Player hardware latency (30–100 ms) is absorbed via per-player calibration in latency_calibrator.gd.