godot-game-loop-collection — Claude Code skill: install
The godot-game-loop-collection skill structures Godot collectible systems with pickup logic, hunt progress, a nearest-item compass, and saved IDs. Use it for scavenger hunts.
LGPL-3.0 345 installs ★ 983 updated 2026-10-16
npx skills add thedivergentai/Game-Dev-Agentic-Skills --skill godot-game-loop-collection -a claude-codeWhat godot-game-loop-collection does
The skill defines a Godot collection loop around stable item_id values and a collection_id for each hunt. collectible_item.gd handles one-shot Area pickups, collection_manager.gd owns the collected-ID set, and collection_compass.gd searches the remaining IDs to guide the player.
Progress can be serialized with get_collected_ids() and restored with restore_collected_ids(). Fixed marker-based hunts can use Marker3D points with hidden_item_spawner.gd; collection_loop_patterns.gd covers advanced loop cases. Missing or duplicated IDs break saves and completion percentage.
The skill is available for Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, and OpenCode. The core scripts cover fixed-ID hunts, while the spawner and advanced patterns are optional pieces.
What it helps with
- collect items through Area pickups
- keep hunt progress after a level reload
- point a compass at the nearest remaining item
- calculate collection completion
- spawn hidden items from Marker3D points
Example prompts for the agent
- Build a Godot scavenger hunt with
collectible_item.gdandcollection_manager.gd. - Persist collected IDs with
get_collected_ids()and restore them withrestore_collected_ids(). - Add a compass that targets an item returned by
get_remaining_ids().
How to install godot-game-loop-collection
1Skills CLI (Vercel)
npx skills add thedivergentai/Game-Dev-Agentic-Skills --skill godot-game-loop-collection -a claude-code2Manually: put the files in place
~/.claude/skills/godot-game-loop-collection/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/godot-game-loop-collection/
1Skills CLI (Vercel)
npx skills add thedivergentai/Game-Dev-Agentic-Skills --skill godot-game-loop-collection -a codex2Manually: put the files in place
.agents/skills/godot-game-loop-collection/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add thedivergentai/Game-Dev-Agentic-Skills --skill godot-game-loop-collection -a cursor2Manually: put the files in place
.cursor/skills/godot-game-loop-collection/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install thedivergentai/Game-Dev-Agentic-Skills skills/godot-game-loop-collection2Manually: put the files in place
.github/skills/godot-game-loop-collection/SKILL.md1Skills CLI (Vercel)
npx skills add thedivergentai/Game-Dev-Agentic-Skills --skill godot-game-loop-collection -a gemini-cli2Platform CLI
gemini skills install https://github.com/thedivergentai/Game-Dev-Agentic-Skills --path skills/godot-game-loop-collectionManually: put the files in place
.devin/skills/godot-game-loop-collection/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add thedivergentai/Game-Dev-Agentic-Skills --skill godot-game-loop-collection -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-collection
How do I install godot-game-loop-collection in Claude Code?
Run npx skills add thedivergentai/Game-Dev-Agentic-Skills --skill godot-game-loop-collection -a claude-code, then open ~/.claude/skills/godot-game-loop-collection/SKILL.md.
What does godot-game-loop-collection do?
It lays out collectible pickups, hunt state, nearest-item guidance, saved progress, and optional hidden-item spawning for Godot.
Why should saves use item_id instead of NodePath?
Scene moves can change node paths. Stable item_id values keep collection progress tied to the intended item.