gamedev-skills/awesome-gamedev-agent-skills4 files

Router

>

Specification
Skill ID
gamedev-skills/awesome-gamedev-agent-skills/router
Publisher
gamedev-skills
Repository
awesome-gamedev-agent-skills
Installs
234
Files
4
Synced
Oct 23, 2026
How to use it

Open any RiverX project, open the Skills panel in the chat, and search for this identifier. The files are fetched from the source repository at install time.

gamedev-skills/awesome-gamedev-agent-skills/routerInstalls these files
  • SKILL.md
  • agents/openai.yaml
  • references/engine-detection.md
  • references/routing-table.md

What this skill tells the agent

Master Router — Game-Development Skill Dispatcher

The entry point for game-development work. It fingerprints the project to pick one engine, classifies the task from the request, names the minimal set of specialized skills, and tells you to read them before acting. It dispatches and composes — it does not re-teach engine APIs.

When to use

  • Use at the start of any game-development request — building or debugging a game, level, player, enemy, shader, UI, save system, multiplayer, input, audio, AI, dialogue, procedural content, or visual asset set — to decide which skill(s) to load.
  • Use when the user names an engine or genre, says "make a game", or asks "which skill should I use?".

*When not to use: once the right skill is loaded and the task is squarely inside it, work from that skill — don't re-run the router every turn. Re-route only when the task pivots* to a new engine or concern (router step 6).

Routing algorithm

  1. Detect engine and version — project fingerprint → at most one engine skill set (or "unknown"), then read the project's version source. §1.
  2. Classify task — phrasing → discipline(s) + at most one genre + workflow(s). §2.
  3. Resolve — the minimal set: engine skill(s) + discipline(s) + genre + workflow(s). §3.
  4. Read (disclosure) — open only the chosen SKILL.md bodies; references/ only on demand. §4.
  5. Compose — order: engine fundamentals → discipline concept → genre glue → workflow. §5.
  6. Fallback — engine unknown or no skill fits → ask or default to Godot; state any gap. §6.

1. Engine detection (project fingerprint)

Scan for the highest-confidence signal; choose exactly one engine. Stop at the first match.

#EnginePrimary signalSkill set root
1Godotproject.godotskills/godot/
2Unreal*.uprojectskills/unreal/
3UnityAssets/ and ProjectSettings/ProjectVersion.txtskills/unity/
4BevyCargo.toml with a bevy dependencyskills/other-engines/bevy-ecs/
5Phaserpackage.json dep phaserskills/web-engines/phaser-*
6PixiJSpackage.json dep pixi.jsskills/web-engines/pixijs-rendering/
7three.jspackage.json dep threeskills/web-engines/threejs-*
8LÖVEconf.lua / main.lua calling love.*skills/other-engines/love2d-core/
9pygame*.py with import pygameskills/other-engines/pygame-core/
10Roblox*.rbxl(x) / *.project.json (Rojo)skills/other-engines/roblox-*

For secondary signals, the Godot-C#/Unity/Bevy and multi-web disambiguation rules, monorepos, and plain-text engine mentions, read references/engine-detection.md.

After identifying the engine, read its version from project metadata or dependency locks before choosing APIs. Existing projects keep their pinned version unless migration is requested; the catalog baseline is only for new projects. The exact version sources are in the detection reference and ../docs/VERSION-SUPPORT.md.

2. Task classification (phrasing → category)

After the engine, read the request for task signals (three additive categories):

  • disciplines (cross-engine concepts): create-game-assets, game-ai, ai-behavior-trees-utility-ai, procedural-gen, dialogue-systems, save-systems, audio-design, shader-programming, physics-tuning, level-design, input-systems, game-feel, camera-systems, game-ui-ux, performance-optimization. Triggered by concept words ("sprite sheet", "art direction", "texture", "pathfinding", "save slots", "fragment shader", "screen shake", "camera follow", "HUD/menu", "optimize/low FPS").
  • genres (whole-game templates): platformer, roguelike, rpg, fps-shooter, tower-defense, card-game, visual-novel, survival-crafting, puzzle. Triggered by genre words ("make a roguelike", "deckbuilder").
  • workflows (process/shipping): game-jam, prototype-fast, steam-publish, itch-publish. Triggered by process words ("publish on Steam", "vertical slice").

File signals sharpen this: *.yarn/*.ink → dialogue-systems/visual-novel; steam_appid.txt → steam-publish; *.inputactions → unity-input-system.

3. Routing table (task → category → skill)

3a. Engine skills — read the one matching the detected engine + sub-task

  • Godot (skills/godot/): language godot-gdscript / godot-csharp; structure godot-nodes-scenes, godot-signals-groups; 2D godot-2d-movement, godot-tilemap; 3D godot-3d-essentials; physics godot-physics; UI godot-ui-control; animation godot-animation; shaders godot-shaders; data godot-resources; audio godot-audio; netcode godot-multiplayer; ship godot-export.
  • Unity (skills/unity/): scripting unity-csharp-scripting; input unity-input-system; physics unity-physics; animation unity-animation; data unity-scriptableobjects; 2D unity-tilemap-2d; AI nav unity-navmesh; ship unity-build-pipeline.
  • Unreal (skills/unreal/): visual scripting unreal-blueprints; C++ gameplay unreal-cpp-gameplay; input unreal-enhanced-input; AI unreal-behavior-trees; VFX unreal-niagara; ship unreal-packaging.
  • Web (skills/web-engines/): phaser-core, phaser-arcade-physics; pixijs-rendering; threejs-scene-setup, threejs-gltf-loading, threejs-materials-lighting.
  • Other (skills/other-engines/): bevy-ecs, pygame-core, love2d-core; Roblox foundation roblox-luau, persistence roblox-datastores, UI roblox-ui, remotes/security roblox-networking, character lifecycle roblox-characters, simulation/queries roblox-physics, and in-Studio operation roblox-studio-workflow.

3b. Disciplines — load with the engine skill (concept ↔ engine API)

Concept (says:)Discipline skillPairs with (engine API)
art direction, game assets, sprites, tilesets, textures, icons, 3D propscreate-game-assetsengine importer/rendering skill; imagegen when available
enemy AI, behavior tree, pathfinding, steeringgame-aiunity-navmesh / unreal-behavior-trees / Godot nav
BT runtime, blackboard, decorator, selector/sequence, utility AI, response curve, considerationai-behavior-trees-utility-aigame-ai (model choice) / unreal-behavior-trees (engine assets)
procedural, noise, seed, dungeon generatorprocedural-genengine tilemap/grid skill
dialogue, Yarn, Ink, conversation treedialogue-systemsengine UI skill
save/load, slots, persistencesave-systemsroblox-datastores / engine IO
adaptive music, mixer, ducking, SFXaudio-designgodot-audio / Unity AudioMixer
shader, fragment, dissolve/outlineshader-programminggodot-shaders / engine material
jitter, tunneling, fixed timestepphysics-tuninggodot-physics / unity-physics
whitebox, blockout, tile layout, pacinglevel-designgodot-tilemap / unity-tilemap-2d
rebind, gamepad, input bufferinginput-systemsunity-input-system / unreal-enhanced-input / Godot InputMap
screen shake, hit-stop, juice, squash & stretch, "make it punchy"game-feelengine animation/tween + camera-systems (shake)
camera follow, deadzone, look-ahead, orbit, first-personcamera-systemsgodot-2d-movement / godot-3d-essentials / Cinemachine
HUD, menu, UI layout, scaling, safe area, focus navgame-ui-uxgodot-ui-control / Unity UI (UGUI/UI Toolkit)
low FPS, optimize, draw calls, GC spike, pooling, profilerperformance-optimizationengine profiler + physics-tuning

For Roblox, compose cross-engine concepts with the focused engine skill: HUD/menu requests use

Use this skill in a project

Open any RiverX project, search the Skills panel for gamedev-skills/awesome-gamedev-agent-skills/router, and install it in one click.

Use this skill