godot-genre-metroidvania — Claude Code skill: install
godot-genre-metroidvania — a Godot skill for ability-gated exploration, connected rooms, saved world state, streamed transitions, and grid-based map discovery.
LGPL-3.0 353 installs ★ 983 updated 2026-10-16
npx skills add thedivergentai/Game-Dev-Agentic-Skills --skill godot-genre-metroidvania -a claude-codeWhat godot-genre-metroidvania does
This skill lays out a Metroidvania structure built around locked routes, ability upgrades, connected rooms, shortcuts, and return trips. It also covers persistent collectibles, defeated bosses, room progress, and a grid-based minimap that reveals visited areas.
Its scripts cover global game state, progression gates, ability resources, background room streaming, deferred scene changes, and minimap fog. Movement-related pieces include jump buffering, an ability state machine, and wall detection. Global flags belong in an Autoload Singleton; grid coordinates use Vector2i, while room loading relies on ResourceLoader.load_threaded_request() and call_deferred().
The blueprint targets Godot exploration platformers and action-adventure games. If world flags stay inside room scripts, ability progress and opened objects will not have a proper global owner when the player returns.
What it helps with
- design areas gated by traversal abilities
- preserve room state after the player leaves
- stream connected rooms in the background
- reveal a minimap from visited grid cells
- give movement abilities both combat and traversal roles
Example prompts for the agent
- Design a Godot Metroidvania with ability locks, shortcuts, and escape routes from one-way areas.
- Review how opened chests and defeated bosses should persist when the player changes rooms.
- Build the minimap fog system with
Vector2iand global world state.
How to install godot-genre-metroidvania
1Skills CLI (Vercel)
npx skills add thedivergentai/Game-Dev-Agentic-Skills --skill godot-genre-metroidvania -a claude-code2Manually: put the files in place
~/.claude/skills/godot-genre-metroidvania/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/godot-genre-metroidvania/
1Skills CLI (Vercel)
npx skills add thedivergentai/Game-Dev-Agentic-Skills --skill godot-genre-metroidvania -a codex2Manually: put the files in place
.agents/skills/godot-genre-metroidvania/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add thedivergentai/Game-Dev-Agentic-Skills --skill godot-genre-metroidvania -a cursor2Manually: put the files in place
.cursor/skills/godot-genre-metroidvania/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install thedivergentai/Game-Dev-Agentic-Skills skills/godot-genre-metroidvania2Manually: put the files in place
.github/skills/godot-genre-metroidvania/SKILL.md1Skills CLI (Vercel)
npx skills add thedivergentai/Game-Dev-Agentic-Skills --skill godot-genre-metroidvania -a gemini-cli2Platform CLI
gemini skills install https://github.com/thedivergentai/Game-Dev-Agentic-Skills --path skills/godot-genre-metroidvaniaManually: put the files in place
.devin/skills/godot-genre-metroidvania/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add thedivergentai/Game-Dev-Agentic-Skills --skill godot-genre-metroidvania -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-metroidvania
How do I install godot-genre-metroidvania in Claude Code?
Run npx skills add thedivergentai/Game-Dev-Agentic-Skills --skill godot-genre-metroidvania -a claude-code. The skill is placed at ~/.claude/skills/godot-genre-metroidvania/SKILL.md.
What does godot-genre-metroidvania do?
It guides a Godot project toward ability-gated exploration, persistent room progress, connected-room transitions, and grid-based minimap fog.
Where should global ability and world state live?
Use an Autoload Singleton. Room scripts should not own global progression flags.