gamedev-skills/awesome-gamedev-agent-skills

74 game-dev skills for AI coding agents — Godot, Unity, Unreal, Phaser, PixiJS, three.js, Bevy, pygame, LÖVE, Roblox. Portable SKILL.md Agent Skills (the format Anthropic launched as Claude Skills), with a router that loads the right skill for your engine and task. Runs in Claude Code, Cursor, Kiro, Codex, Copilot, Gemini CLI and more.

概览

awesome‑gamedev‑agent‑skills 是一套精选的 74 个 Agent Skills(代理技能)集合——这些是小型、独立的知识模块,AI 编程助手(如 Claude Code、Cursor、Gemini CLI、GitHub Copilot 等)可以按需加载。该仓库整合了这些技能以及一个路由器,它能自动检测您正在使用的游戏引擎(Godot、Unity、Unreal、网页引擎、Bevy、pygame、LÖVE、Roblox)以及您以自然语言描述的任务类型,然后仅加载相关技能。这让 LLM 能专注于生成所需的精确代码,而不会被不相关的引擎 API 所干扰。


仓库内容

组件 说明 使用方式
74 个 SKILL.md 文件 每个技能都是一个 Markdown 文件,描述引擎专用 API(例如 godot‑2d‑movement)或跨引擎学科(例如 procedural‑gen),并附带示例片段与使用指南。 代理在运行时读取 Markdown;除非您贡献新技能,否则无需编辑。
路由器技能 一种特殊的技能,实现检测算法:(1) 从文件识别项目引擎,(2) 解析您的自然语言请求,(3) 加载匹配的引擎技能以及任何学科/类型/工作流程技能。 当您向支持的代理发出请求时,路由器会自动执行。
CLI 安装程序 npx skills add gamedev-skills/awesome-gamedev-agent-skills 会检测您现有的代理,并将路由器与所有技能复制到正确目录。标志可用于列出、全局安装或针对特定代理。 为任何支持的代理提供单行安装;也提供替代的 Claude‑Code 插件命令。
文档网站 每个技能的自动生成网页视图,位于 https://gamedev-skills.github.io/awesome-gamedev-agent-skills/。 方便在不克隆仓库的情况下浏览目录。
验证器与测试 Python 脚本 scripts/validate-skills.py 检查每个技能是否符合标准、版本锁定,并通过基本回归测试。 在提交 PR 前于本地执行。

运作方式(路由器工作流程)

  1. 引擎检测 – 路由器扫描项目文件(project.godot、*.uproject、包含 Phaser 的 package.json 等)以精确选择一个引擎。
  2. 请求解析 – 检查您的自然语言描述中的概念(例如 double jump)、类型(platformer, roguelike)或工作流程步骤(publish to itch)。
  3. 技能加载 – 路由器加载:
    • 引擎基准技能(例如 godot‑gdscript),
    • 符合概念的任何学科技能(例如 game‑feel),
    • 类型专用胶水代码(例如 platformer)。 仅这些文件会呈现给 LLM,保持提示词简洁。
  4. 代码生成 – 代理使用加载的技能输出版本锁定的代码片段,您可以将其复制到项目中。

交互示例

> 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.

代理随后会返回一个简短的 GDScript 片段,实现二段跳机制,正如 README 中所示。


谁适合使用?

  • 游戏开发者:使用 AI 助手在多个引擎中编写或扩展代码。
  • 团队:建立内部工具,希望为 LLM 提供一致的“技能”接口。
  • 教育工作者:寻找现成的、引擎专用的教学模块,AI 可按需呈现。

入门(快速步骤)

# 为您现有的代理安装
npx skills add gamedev-skills/awesome-gamedev-agent-skills

# 或仅安装路由器 + 单一引擎
npx skills add router@awesome-gamedev-agent-skills
npx skills add godot@awesome-gamedev-agent-skills   # 替换为 unity, unreal 等

安装后,只需与您的代理对话:

"Make an inventory system for my Unity RPG"

路由器将在 LLM 生成代码前加载 unity‑scriptableobjects、rpg 与 save‑systems。


授权与维护

  • 授权:Apache‑2.0 (参见 LICENSE)。
  • 维护者:Abhishek Barali — 该仓库持续维护中,每个引擎皆有版本锁定的基准,并配有验证器以确保技能集的可靠性。

总结

awesome-gamedev-agent-skills 是一套可立即安装的库,包含 74 个与 AI 代理兼容的“技能”,涵盖主要游戏引擎、常见游戏开发学科、热门类型与发布工作流程。内置路由器会根据您的项目与自然语言请求自动选择正确的子集,让基于 LLM 的编程助手能以最少的提示词冗余生成精确且符合引擎规范的代码。

相关

  • 项目
  • 项目
  • 项目
  • 项目