Godot Genre Roguelike

This is a comprehensive roguelike architecture blueprint that covers the full stack from procedural dungeon generation to meta-progression systems. It bundles eleven modular scripts including Walker algorithm dungeon carving, AStarGrid2D pathfinding wrappers, shuffle bag loot tables, and fog of war masking. The anti-patterns section is notably thorough, covering threading pitfalls like main thread SceneTree access, save scumming prevention, and the critical distinction between run state and meta state. If you're building a traditional roguelike or roguelite in Godot, this gives you the scaffolding and guardrails to avoid the genre's common technical traps. The code snippets lean heavily on performance optimizations like WorkerThreadPool for generation and RenderingServer for GPU-based fog of war.

skills.sh installs: 285
GitHub stars: 464
last updated: Aug 21, 2026

View on GitHub

Install

$ npx -y skills add thedivergentai/gd-agentic-skills --skill godot-genre-roguelike --agent claude-code

Installs into .claude/skills of the current project.

Files

NEVER Do (Expert Anti-Patterns)

Generation & RNG

NEVER make runs dependent on pure RNG; strictly provide mitigation (rerolls, shops, pity timers) to ensure every run is winnable.
NEVER use unseeded RNG for world generation; strictly initialize isolated RandomNumberGenerator with a predictable seed for daily runs/debugging.
NEVER rely on @GlobalScope.randi() for critical logic; strictly use local RNG instances to prevent global state pollution.
NEVER use Array.pick_random() for critical content drops; strictly use a Shuffle Bag to prevent statistically unfair streaks.
NEVER generate massive dungeons on the main thread; strictly use WorkerThreadPool.add_task() or add_group_task() to distribute generation across cores and prevent frame freezes.
NEVER interact with the SceneTree from a background thread; strictly generate dungeon data in a thread-safe Array/PackedByteArray before parsing on the main thread.

SKILL.md on GitHub

Details

Repository: github.com/thedivergentai/gd-agentic-skills
Categories: AI & Agent Building, Game Development
First seen: Jun 3, 2026