gamedev-skills/awesome-gamedev-agent-skills

Overview

awesome‑gamedev‑agent‑skills is a curated collection of 74 Agent Skills – small, self‑contained knowledge modules that AI coding assistants (Claude Code, Cursor, Gemini CLI, GitHub Copilot, etc.) can load on demand. The repository bundles the skills and a router that automatically detects the game engine you are using (Godot, Unity, Unreal, web‑based engines, Bevy, pygame, LÖVE, Roblox) and the type of task you describe in plain language, then loads only the relevant skills. This lets an LLM focus on the exact code it needs to generate, without being bogged down by unrelated engine APIs.

---

What the repo provides

Component	What it is	How you use it
74 SKILL.md files	Each skill is a markdown file that describes an engine‑specific API (e.g., godot‑2d‑movement) or a cross‑engine discipline (e.g., procedural‑gen) together with example snippets and usage guidelines.	Agents read the markdown at runtime; you never edit them unless you contribute new skills.
Router skill	A special skill that implements the detection algorithm: (1) identify the project’s engine from files, (2) parse your natural‑language request, (3) load the matching engine skill plus any discipline/genre/workflow skills.	The router runs automatically when you issue a request to a supported agent.
CLI installer	npx skills add gamedev-skills/awesome-gamedev-agent-skills detects the agent you already use and copies the router and all skills to the correct directory. Flags let you list, install globally, or target a specific agent.	One‑liner install for any supported agent; alternative Claude‑Code plugin commands are also provided.
Documentation site	Auto‑generated web view of every skill at https://gamedev-skills.github.io/awesome-gamedev-agent-skills/.	Handy for browsing the catalog without cloning the repo.
Validator & tests	Python script scripts/validate-skills.py checks that each skill follows the standard, is version‑pinned, and passes basic regression tests.	Run locally before submitting a PR.

---

How it works (the router workflow)

1. Engine detection – The router scans project files (project.godot, *.uproject, package.json with Phaser, etc.) to pick exactly one engine.
2. Request parsing – Your plain‑English description is examined for concepts (e.g., double jump), genres (platformer, roguelike), or workflow steps (publish to itch).
3. Skill loading – The router loads:
   • the engine‑baseline skill (e.g., godot‑gdscript),
   • any discipline skills matching the concept (e.g., game‑feel),
   • genre‑specific glue (e.g., platformer). Only these files are presented to the LLM, keeping the prompt concise.
4. Code generation – The agent uses the loaded skills to emit version‑pinned code snippets, which you can copy into your project.

---

Example interaction

> add a double jump to my player

Detected Godot (project.godot). Loading godot-2d-movement for the controller
and platformer for jump feel — skipping the other 71 skills.

The agent then returns a short GDScript snippet that implements a two‑jump mechanic, exactly as shown in the README.

---

Who might benefit?

• Game developers who use AI assistants to write or extend code across many engines.
• Teams building internal tooling that wants a consistent “skill” interface for LLMs.
• Educators looking for ready‑made, engine‑specific teaching modules that an AI can surface on demand.

---

Getting started (quick steps)

# Install for the agent you already use
npx skills add gamedev-skills/awesome-gamedev-agent-skills

# Or install only the router + a single engine
npx skills add router@awesome-gamedev-agent-skills
npx skills add godot@awesome-gamedev-agent-skills   # replace with unity, unreal, etc.

After installation, simply talk to your agent:

"Make an inventory system for my Unity RPG"

The router will load unity‑scriptableobjects, rpg, and save‑systems before the LLM generates code.

---

License & maintenance

• License: Apache‑2.0 (see LICENSE).
• Maintainer: Abhishek Barali — the repo is actively maintained, with version‑pinned baselines for each engine and a validator to keep the skill set reliable.

---

TL;DR

awesome-gamedev-agent-skills is a ready‑to‑install library of 74 AI‑agent‑compatible “skills” covering major game engines, common game‑dev disciplines, popular genres, and publishing workflows. A built‑in router automatically selects the right subset based on your project and natural‑language request, letting LLM‑based coding assistants generate precise, engine‑correct code with minimal prompt bloat.