~/codigoagente
Agentes de IA

awesome-gamedev-agent-skills: 77 skills para crear videojuegos con Claude Code, Codex y Cursor

Si usas un agente de IA para programar videojuegos, ya sabes cuál es su punto débil: mezcla APIs de versiones distintas de Godot, se inventa nodos de Unity que no existen y te entrega saltos que "flotan". awesome-gamedev-agent-skills intenta corregir eso con 77 skills de desarrollo de videojuegos y un router que elige las adecuadas según tu motor y lo que pides.

Lo hemos clonado, leído y probado en Claude Code con un proyecto de Phaser. En este artículo verás qué incluye, cómo instalarlo en Claude Code, Codex o Cursor, qué hizo el agente con las skills cargadas y qué no resuelven.

Qué es awesome-gamedev-agent-skills

Es una colección de *Agent Skills*: carpetas con un SKILL.md (instrucciones en Markdown) que el agente carga solo cuando tu petición encaja con su descripción. Si aún no las conoces, empieza por qué son las skills de Claude Code.

Datos del repositorio a fecha de esta prueba (commit 19d93f9, 28 de octubre de 2026):

  • 77 skills + 1 router, unas 87.000 palabras de instrucciones en total.
  • 12 motores: Godot 4.7, Unity 6.3 LTS, Unreal Engine 5.8, Ebitengine 2.10.5 (Go), Phaser 4.2, PixiJS 8.22, three.js r186, Bevy 0.20, pygame-ce 2.5.8, LÖVE 11.5, Defold 1.14.0 y Roblox.
  • Licencia: Apache-2.0, no MIT. Puedes usarlas, modificarlas y redistribuirlas, también en proyectos comerciales, pero si redistribuyes el repositorio o una versión modificada tienes que conservar LICENSE y NOTICE e indicar qué cambiaste. Usarlas en tu agente para escribir tu juego no te obliga a nada.
  • Mantenedor: Abhishek Barali y colaboradores. El NOTICE declara que todas las skills se escribieron a partir de la documentación oficial de cada motor.

Cada skill fija la versión del motor para la que está escrita y el archivo docs/VERSION-SUPPORT.md recoge la fecha de la última revisión (24 de octubre de 2026). Además, cada skill obliga al agente a leer primero la versión de tu proyecto y respetarla: si tu juego está en Godot 4.3, no debe "actualizarte" el código a la 4.7 sin pedírtelo.

Qué skills incluye

El catálogo se divide en cuatro bloques:

BloqueCuántasEjemplos
Motores49`godot-2d-movement`, `godot-tilemap`, `unity-input-system`, `unreal-blueprints`, `phaser-arcade-physics`, `threejs-gltf-loading`, `bevy-ecs`, `roblox-datastores`
Disciplinas15`game-feel`, `camera-systems`, `save-systems`, `procedural-gen`, `game-ai`, `shader-programming`, `performance-optimization`, `create-game-assets`
Géneros9`platformer`, `roguelike`, `rpg`, `fps-shooter`, `tower-defense`, `card-game`, `visual-novel`, `survival-crafting`, `puzzle`
Flujos de trabajo4`game-jam`, `prototype-fast`, `steam-publish`, `itch-publish`

Godot es el motor mejor cubierto (16 skills) y es el que el router elige por defecto si empiezas un proyecto sin decir motor. Unity tiene 8, Unreal 6, Roblox 8 y el resto entre 1 y 3. Ebitengine y Defold tienen una sola skill grande cada uno, y el propio router admite huecos: Defold no tiene skill de interfaz, tilemaps ni física propias.

Las skills de género no repiten APIs: dicen qué sistemas necesita el juego y en qué orden, y delegan el código en la skill del motor. platformer, por ejemplo, pide afinar el salto por resultado (altura en tiles y tiempo hasta el punto más alto) y calcular gravedad y velocidad a partir de ahí, en lugar de probar números a ojo.

Cómo funciona el router

El router (router/SKILL.md) hace tres cosas en cada petición:

  1. Detecta el motor por los archivos del proyecto: project.godot es Godot, *.uproject es Unreal, un package.json con phaser es Phaser, un go.mod con ebiten/v2 es Ebitengine, etc.
  2. Clasifica la tarea: un concepto (guardar partida, IA, shaders), un género (plataformas, roguelike) o un paso de publicación (Steam, itch.io).
  3. Carga solo las skills necesarias, en orden: motor, disciplina, género y flujo.

Así, "añade un doble salto a mi jugador de Godot" debería cargar godot-2d-movement y platformer, y nada más. Si tu motor es propio o no está en la lista, el router no cambia de motor: usa las skills de disciplina y género y busca las APIs en tu código.

Cómo instalar las skills

Hay tres formas. Las tres dejan los mismos SKILL.md.

Con el CLI skills (cualquier agente)

terminalsh
npx skills add gamedev-skills/awesome-gamedev-agent-skills

Detecta el agente que usas y copia el router y las 77 skills donde toca. Añade --list para ver antes qué va a instalar, -g para instalarlas en todos tus proyectos o -a <agente> para elegir uno (-a claude-code, -a cursor, -a gemini-cli). Necesita Node.js 22.20 o superior. Si quieres buscar otras skills desde el propio agente, mira find-skills.

Como plugin de Claude Code

El repositorio también es un *marketplace* de plugins:

terminalsh
claude plugin marketplace add gamedev-skills/awesome-gamedev-agent-skills
claude plugin install gamedev@awesome-gamedev-agent-skills

Si trabajas con un solo motor, instala solo el router y su paquete para no llenar el contexto con 77 descripciones:

terminalsh
claude plugin install router@awesome-gamedev-agent-skills
claude plugin install godot@awesome-gamedev-agent-skills

Los paquetes disponibles son godot, unity, unreal, ebitengine, web-engines (Phaser, PixiJS, three.js), other-engines (Bevy, pygame, LÖVE, Defold, Roblox), disciplines, genres y workflows.

Copiando las carpetas a mano

Copia la carpeta de cada skill (la que contiene el SKILL.md) en el directorio de tu agente:

AgenteCarpeta
Claude Code`.claude/skills/`
Codex, Gemini CLI, GitHub Copilot, Antigravity`.agents/skills/`
Cursor`.cursor/skills/` (también lee `.agents/skills/`)
Windsurf`.devin/skills/` (también lee `.windsurf/skills/`)
Cline`.cline/skills/`
Kiro`.kiro/skills/`

La prueba: un plataformas en Phaser con Claude Code

Creamos un proyecto vacío con phaser@4.2.1 en el package.json, copiamos el router y las 77 skills a .claude/skills/ y le pedimos a Claude Code, en modo no interactivo:

snippettext
Quiero un plataformas 2D mínimo en Phaser que se abra desde index.html
(carga node_modules/phaser/dist/phaser.js). Jugador rectángulo, suelo y
3 plataformas, salto doble con coyote time y jump buffer. Sin assets
externos. Al terminar, di qué skills cargaste y por qué.

Tardó 31 segundos y costó 0,18 USD. Según su registro de herramientas, cargó tres skills: phaser-core, phaser-arcade-physics y platformer. No llamó al router: Claude Code ya ve las descripciones de las 78 skills y eligió directamente las que encajaban. Descartó input-systems y physics-tuning por innecesarias en un proyecto tan pequeño, y lo explicó.

El resultado fueron dos archivos (index.html y un game.js de 100 líneas) que siguen lo que piden las skills: el estado se reinicia en init() y no en el constructor de la escena, las plataformas van en un staticGroup, el *collider* se registra una sola vez en create() y el suelo se comprueba con body.blocked.down. El núcleo del salto quedó así:

game.jsjavascript
const JUMP_VELOCITY = -460;
const COYOTE_TIME = 0.1;   // s tras dejar el suelo en que aún se puede saltar
const JUMP_BUFFER = 0.12;  // s que se recuerda un salto pulsado antes de aterrizar
const MAX_AIR_JUMPS = 1;   // salto extra en el aire => doble salto
const JUMP_CUT = 0.45;     // al soltar pronto, recorta la subida

// ...dentro de update():
if (this.buffer > 0) {
  if (this.coyote > 0) {
    body.setVelocityY(JUMP_VELOCITY);   // salto desde el suelo o en coyote time
    this.coyote = 0;
    this.buffer = 0;
  } else if (this.airJumps > 0 && pressed) {
    body.setVelocityY(JUMP_VELOCITY);   // doble salto, solo con pulsación nueva
    this.airJumps--;
    this.buffer = 0;
  }
}
if (released && body.velocity.y < 0) body.setVelocityY(body.velocity.y * JUMP_CUT);

Lo abrimos en Chromium con Playwright, simulamos el teclado y registramos la posición del jugador en cada fotograma. Sin errores en consola, y el doble salto funciona:

Doble salto registrado fotograma a fotograma: el jugador sube 183 px y aterriza en la primera plataforma · codigoagente

Lo que encontramos al jugarlo

El código es correcto, pero el nivel no está pensado para ese salto. Con -460 de velocidad y 1100 de gravedad, un salto simple sube unos 96 px y en la prueba no pasó de 92. La primera plataforma está 130 px por encima del suelo y las otras dos, a 100 px de la anterior. Resultado: ningún tramo se puede subir con un salto simple, todos exigen el doble salto. Además, el jugador empieza justo debajo de la primera plataforma y, si salta ahí, se golpea la cabeza.

Con un salto simple el jugador se queda bajo el borde de la plataforma y vuelve al suelo · codigoagente

Es justo lo que la skill platformer intenta evitar: dice que la altura del salto se fija en tiles y se colocan las plataformas a partir de ella. Claude cargó la skill pero escribió los números a ojo y no midió el nivel. Tampoco aplicó la gravedad asimétrica (caída más rápida que la subida) que la skill recomienda contra los saltos "flotantes". Las skills mejoran la estructura del código, pero no sustituyen jugar a lo que genera. Si le pides "comprueba que cada plataforma se alcanza con un salto simple" o "calcula gravedad y velocidad para un salto de 3 tiles", lo corrige.

Qué no hace

  • No ejecuta tu juego. Son instrucciones. Para comprobar el resultado necesitas el motor o un navegador; algunas skills incluyen scripts de apoyo (check_godot_project.py, check_ebitengine.py, un generador de proyecto de Ebitengine) que el agente puede usar si le das permiso.
  • No genera arte por sí sola. create-game-assets es un flujo de dirección de arte (brief, manifiesto de assets, una imagen de referencia aprobada antes de producir la familia completa) y usa una skill imagegen solo si tu agente la tiene.
  • No es ligera si instalas todo. Las descripciones de las 78 skills suman unos 31.000 caracteres, cerca de 8.000 tokens que el agente tiene presentes en cada sesión. Si solo usas un motor, instala su paquete.

Errores frecuentes

El CLI skills falla al instalar. Comprueba node -v: necesita Node.js 22.20 o posterior.

El agente no carga ninguna skill. Las skills se activan por su descripción. Nombra el motor o el género en la petición ("en mi juego de Godot", "un roguelike") o pídelo directamente: "usa la skill platformer".

El código usa una API de otra versión del motor. Las skills piden leer la versión de tu proyecto (project.godot, ProjectVersion.txt, package.json y su *lockfile*, Cargo.lock). Si no tienes esos archivos, dile la versión en la petición.

El router dice que no hay skill para tu caso. Es intencionado: en vez de inventarse una skill, carga la más cercana del mismo motor y lo indica. Pasa, por ejemplo, con la interfaz en Defold.

Preguntas frecuentes

¿Es gratis? Sí. Es un repositorio público con licencia Apache-2.0.

¿Funciona con Codex, Cursor o Gemini CLI? Sí. Usan el mismo formato SKILL.md; solo cambia la carpeta donde se copian.

¿Necesito el router en Claude Code? No es imprescindible: en nuestra prueba Claude eligió las skills sin él. Sirve sobre todo cuando no sabes qué skill aplica, cuando el proyecto mezcla motores o en agentes que leen menos descripciones.

¿Puedo usarlo en un juego comercial? Sí. Apache-2.0 permite uso comercial. Las obligaciones (conservar LICENSE y NOTICE) se aplican si redistribuyes las skills, no al código de tu juego.

¿Qué motor conviene para empezar? El que ya conozcas. Si no tienes preferencia, Godot es el mejor cubierto del catálogo y el que el router propone por defecto.

Conclusión

awesome-gamedev-agent-skills es la colección de skills de videojuegos más completa que hemos visto: versiones fijadas, 12 motores y géneros que se combinan con ellos sin repetir código. En la prueba con Phaser, el agente eligió bien las skills y escribió código limpio, pero no aplicó el ajuste del salto que la propia skill describe. Instala solo el paquete de tu motor, juega a lo que genere y pídele que mida el nivel. Si quieres un agente que planifique y pruebe antes de programar, combínalo con Superpowers.

// código fuente

Repositorio del artículo
El código del que habla este artículo es público: revísalo, dale una estrella o clónalo desde aquí.

Nos ayuda a crecer

codigoagente es gratis y sin muros de pago. Si este artículo te sirvió, cualquiera de estas cosas mantiene el blog en marcha.

// newsletter

Un correo a la semana con los repos que valen la pena

Los artículos nuevos de la semana, probados con código real. Sin spam; te das de baja con un clic.

Agentes de IA

guía · Guía completa de ECC para Claude Code · #8

AgentShield, el escáner de ECC, revisa CLAUDE.md, settings.json, MCP, hooks y agentes. Lo probamos con una configuración vulnerable y con el propio ECC.
  • Seguridad y revisión de código
  • Claude Code
leer artículo
Agentes de IA

guía · Guía completa de ECC para Claude Code · #7

Medimos cuánto contexto ocupa ECC con /ecc:context-budget --audit (unos 12.500 tokens en el perfil minimal) y cómo recortarlo: modelo, compactación y MCP.
  • Claude Code
  • Skills para tus agentes
leer artículo
Agentes de IA

guía · Guía completa de ECC para Claude Code · #6

Qué hacen los 28 hooks de ECC, cómo GateGuard frena la primera edición, cómo guardar y retomar sesiones y cómo funcionan los instincts del aprendizaje continuo.
  • Claude Code
  • Skills para tus agentes
leer artículo