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 파일	각 스킬은 엔진별 API(예: `godot‑2d‑movement`)나 엔진 공통 분야(예: `procedural‑gen`)를 예제 코드 및 사용 가이드라인과 함께 설명하는 마크다운 파일입니다.	에이전트가 런타임에 마크다운을 읽습니다. 새로운 스킬을 기여하지 않는 한 수정할 필요가 없습니다.
라우터 스킬	감지 알고리즘을 구현하는 특수 스킬: (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 제출 전 로컬에서 실행하십시오.

작동 방식 (라우터 워크플로우)

엔진 감지 – 라우터가 프로젝트 파일(project.godot, *.uproject, Phaser가 포함된 package.json 등)을 스캔하여 엔진을 하나 선택합니다.
요청 파싱 – 자연어 설명에서 개념(예: double jump), 장르(platformer, roguelike) 또는 워크플로우 단계(publish to itch)를 검토합니다.
스킬 로드 – 라우터가 다음을 로드합니다:
- 엔진 기준 스킬(예: godot‑gdscript),
- 개념과 일치하는 분야 스킬(예: game‑feel),
- 장르별 글루 코드(예: platformer). 이 파일들만 LLM에 제공되어 프롬프트가 간결하게 유지됩니다.
코드 생성 – 에이전트는 로드된 스킬을 사용하여 버전이 고정된 코드 스니펫을 출력하며, 이를 프로젝트에 복사할 수 있습니다.

상호작용 예시

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

에이전트는 README에 표시된 대로 이단 점프 메커니즘을 구현하는 짧은 GDScript 스니펫을 반환합니다.

시작하기 (빠른 단계)

# 사용 중인 에이전트에 설치
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 기반 코딩 어시스턴트가 프롬프트 낭비를 최소화하면서 엔진에 맞는 정확한 코드를 생성할 수 있습니다.