Agent Skills para videojuegos: Claude Code, Codex y Cursor

Instala gamedev-skills/awesome-gamedev-agent-skills desde la raíz de tu proyecto de juego con npx skills add gamedev-skills/awesome-gamedev-agent-skills, incluye router y selecciona tu agente de programación. Después, invoca el router explícitamente y verifica un cambio pequeño en Godot o Unity antes de pedir una funcionalidad más amplia. Instalar el catálogo completo no introduce todas las instrucciones en el contexto: los agentes descubren primero los metadatos y leen las instrucciones seleccionadas cuando las necesitan.

A fecha de 2026-10-26, el repositorio actual contiene 76 habilidades especializadas más un router independiente, es decir, 77 definiciones de habilidades en total. La descripción de la sección About del repositorio todavía indica 74; consulta los archivos actuales y la vista previa del instalador para comprobar qué vas a recibir. El paquete se distribuye con licencia Apache-2.0.

Esta configuración resulta útil si ya trabajas con un agente de programación y quieres instrucciones reutilizables para tu motor. El paquete aporta orientación para el código y los flujos de trabajo; sigues necesitando el editor del juego, un proyecto y una cuenta del agente o una configuración de API que funcione.

Instala el paquete en tu proyecto

Empieza con una instalación dentro del proyecto para poder revisar los archivos añadidos junto con los del juego. A fecha de 2026-10-26, la versión publicada de la CLI skills es 1.7.4 y requiere Node.js 22.20.0 o posterior, según sus metadatos en npm. También necesitas Git para obtener el repositorio.

Abre Bash en la raíz del proyecto y consulta el catálogo:

node --version
git --version
npx skills add gamedev-skills/awesome-gamedev-agent-skills --list

Busca router, godot-2d-movement, platformer y unity-scriptableobjects. La opción --list muestra las habilidades disponibles sin instalarlas. Lee el router y las habilidades que vayas a utilizar antes de confirmar la instalación.

Ejecuta el comando de instalación documentado del paquete:

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

Para seguir esta guía, incluye el router y el catálogo completo en las opciones interactivas, selecciona el agente que utilizas y elige el ámbito Project. Añade -g únicamente si quieres instalar las habilidades para tu usuario y utilizarlas en varios proyectos.

Si quieres seleccionar explícitamente todo el catálogo para Codex, puedes usar esta alternativa:

npx skills add gamedev-skills/awesome-gamedev-agent-skills --skill '*' -a codex

Sustituye codex por claude-code o cursor para esos clientes. Conserva las comillas de '*' para que Bash no expanda el comodín. La referencia de la CLI distingue entre --skill '*', que selecciona todas las habilidades, y --all, que además selecciona todos los agentes.

Comprueba el resultado:

npx skills list

Confirma que aparecen router y las habilidades necesarias para la prueba del motor que hayas elegido. El instalador obtiene archivos públicos de habilidades; la autenticación del modelo sigue configurándose en tu cliente de programación, y ejecutar el agente sigue consumiendo su cuota habitual de uso del modelo o generando cargos de API.

¿Dónde cargan los archivos Claude Code, Codex y Cursor?

Comprueba el destino real de la instalación, porque los directorios admitidos por un agente no siempre coinciden con el que elige la CLI. Para instalaciones dentro del proyecto con skills 1.7.4, las rutas relevantes son estas:

Agente	Valor después de -a	Destino de instalación en el proyecto	Invocación explícita del router en el chat
Claude Code	claude-code	.claude/skills/	/router
Codex CLI o extensión para IDE	codex	.agents/skills/	Selecciona router mediante /skills o menciona $router
Cursor Agent	cursor	.agents/skills/	Escribe / y selecciona router

Estas invocaciones se introducen en el chat del agente, no en Bash. Cursor también admite .cursor/skills/ para la instalación manual, así que la página breve de instalación del paquete sigue siendo útil como referencia de compatibilidad; que .cursor/skills/ esté vacío no significa que la instalación mediante la CLI haya fallado.

La asignación de directorios del instalador sitúa actualmente tanto Codex como Cursor en .agents/skills/. Si hay un único directorio de destino, recibe copias de los archivos. Cuando seleccionas clientes con directorios de destino distintos, el instalador puede compartir una copia central en .agents/skills/ mediante enlaces simbólicos o crear copias independientes. Lee el resumen de instalación en lugar de dar por hecho que siempre se crean enlaces.

Cada habilidad instalada debe tener la estructura <skills-directory>/<skill-name>/SKILL.md. Por ejemplo, la habilidad de movimiento de Codex se encuentra en .agents/skills/godot-2d-movement/SKILL.md; su equivalente en Claude Code está en .claude/skills/godot-2d-movement/SKILL.md. Conserva los directorios references/, scripts/ y assets/ incluidos en cada habilidad, cuando existan, tal como indican las instrucciones de instalación manual.

¿Cómo evita el router cargar todas las habilidades?

El router selecciona las instrucciones según el motor y la tarea; el agente proporciona el mecanismo de carga bajo demanda. La introducción a la especificación Agent Skills describe el descubrimiento mediante nombres y descripciones, la activación mediante la lectura del contenido de una habilidad y la ejecución con recursos adicionales cuando hacen falta.

Las instrucciones del router aplican este mecanismo al desarrollo de videojuegos:

1. Identificar un único motor a partir del proyecto y consultar su versión.
2. Seleccionar el conjunto mínimo de habilidades relevantes para el motor, la disciplina, el género y el flujo de trabajo.
3. Leer esas instrucciones y abrir las referencias incluidas solo cuando la tarea las necesite.

En Godot, el principal archivo identificador es project.godot. En Unity, es la combinación de Assets/ y ProjectSettings/ProjectVersion.txt. Una petición relacionada con el movimiento puede seleccionar godot-2d-movement y platformer; una petición posterior sobre guardado debería seleccionar las instrucciones de persistencia pertinentes, sin cargar catálogos de otros motores.

El router también es un archivo SKILL.md con instrucciones que sigue el modelo. No es un ejecutable independiente que imponga un número máximo de lecturas. Instalar únicamente el router tampoco proporciona las instrucciones especializadas a las que remite: esas habilidades deben estar instaladas y ser detectables por el agente.

Los metadatos también ocupan contexto, y las instrucciones cargadas, los resultados de las herramientas y los reintentos también cuentan para el consumo del modelo. Si tu colección actual genera avisos sobre el presupuesto disponible para descubrir habilidades, utiliza --skill para instalar una selección más pequeña que incluya el router y las especialidades que necesitas. El número de habilidades, por sí solo, no permite atribuir al paquete un porcentaje medido de ahorro de tokens.

Verifica una tarea pequeña en el motor

Comprueba tanto la carga de instrucciones como el comportamiento obtenido en el motor. Inicia una sesión nueva del agente dentro del proyecto, selecciona explícitamente el router según la tabla anterior y utiliza uno de los siguientes prompts.

Si tu cliente muestra la actividad de las herramientas, comprueba la activación real de las habilidades o la lectura de sus archivos. Una frase que afirme que se ha cargado una habilidad aporta menos evidencia que una lectura correcta de su SKILL.md instalado.

Godot: añade un salto adicional en el aire

Utiliza una escena existente de Godot 4 que se pueda ejecutar y que tenga un jugador CharacterBody2D, una forma de colisión y un suelo. El router indica godot-2d-movement junto con platformer para esta petición; la habilidad de movimiento aporta las instrucciones específicas del motor para el controlador.

Use the installed router skill for this Godot project. Inspect project.godot
and the actual editor version before editing, and preserve that version.

Report the resolved paths of the router and selected SKILL.md files you
actually read. Resolve skill names through the installed skill locations.

Add one extra mid-air jump to the existing CharacterBody2D player.
Keep the change in the player controller and preserve the current controls.
A fresh jump press on the ground starts the first jump. One more fresh
press in the air starts the second. A third press before landing does
nothing. Holding the button must not repeatedly jump. Landing restores
both jumps.

List the changed files and give the exact scene and controls for checking
the result. Separate checks you ran from checks I must perform in Godot.

Ejecuta la escena indicada. Dos pulsaciones independientes deberían producir dos saltos; una tercera pulsación en el aire no debería iniciar otro salto, y al aterrizar deberían recuperarse ambos saltos. Mantén también el botón pulsado durante un salto para comprobar que no se activa repetidamente y revisa si aparecen errores nuevos de script o de ejecución.

La habilidad de movimiento del paquete toma Godot 4.7 como referencia, pero las instrucciones de detección del motor indican que se debe conservar la versión de un proyecto existente. Instalar el paquete no justifica migrar el proyecto ni sustituir sus API por las de otra versión.

Unity: separa los datos compartidos de las cantidades en ejecución

Utiliza una escena de prueba que puedas descartar dentro de un proyecto Unity existente. Esta comprobación utiliza unity-scriptableobjects; unity-csharp-scripting también es pertinente para el pequeño componente que consume los datos. Permite verificar las instrucciones sobre datos compartidos sin pedir un sistema completo de inventario.

Use the installed router skill for this Unity project. Read
ProjectSettings/ProjectVersion.txt and preserve the editor and package
versions. Report the resolved SKILL.md paths you actually read.

Create an ItemDefinition ScriptableObject with itemId, displayName,
and maxStack, using CreateAssetMenu. Use one example asset with
itemId "potion", displayName "Potion", and maxStack 10. Treat the asset
as read-only configuration during play.

Create two distinct runtime slot instances referencing that same asset.
Start their quantities at 2 and 5. Add one small probe component that
decrements only the first slot, then reports quantities 1 and 5,
confirms both slots reference the same asset, and checks that the
definition fields are unchanged. Start each probe run with fresh slots.

Keep the output to the data model and probe component. Give exact
asset-creation, component-attachment, Inspector-assignment, and Play-mode
steps. Distinguish checks you executed from checks I must perform.

Crea el recurso de ejemplo desde la entrada generada en el menú Assets, añade el componente de comprobación a un GameObject vacío, asigna el recurso en el Inspector y entra en modo Play. El resultado observable debería mostrar que las cantidades independientes pasan de 2 y 5 a 1 y 5, mientras ambas ranuras conservan la referencia a la misma definición. Al salir del modo Play, el recurso debe seguir conteniendo potion, Potion y 10.

La documentación de ScriptableObject de Unity explica que varios consumidores pueden compartir un recurso mediante referencias. El recurso no es inmutable por naturaleza: este ejemplo mantiene deliberadamente las cantidades variables en objetos independientes creados durante la ejecución. Si ambas cantidades cambian a la vez, comprueba si la implementación comparte por error el objeto de la ranura además de la definición.

¿Qué hacer si no se encuentra el router o la habilidad seleccionada?

Comprueba por separado la instalación, el descubrimiento de habilidades y la resolución de rutas. Elige el siguiente paso según el síntoma:

Síntoma	Comprobación y siguiente paso
La vista previa falla antes de mostrar las habilidades	Lee el error real; comprueba la versión activa de Node.js, la disponibilidad de Git y el acceso a npm/GitHub. Corrige el requisito que falla y vuelve a ejecutar --list.
La lista de habilidades instaladas incluye las del motor, pero no router	Repite la instalación e incluye router. Copiar manualmente solo el contenido de skills/ del repositorio deja fuera el directorio independiente router/.
Los archivos existen, pero el agente no ofrece las habilidades	Confirma que la sesión está abierta en el proyecto correcto y que cada carpeta contiene SKILL.md. Revisa las rutas documentadas del cliente y reinicia la sesión si el descubrimiento no se ha actualizado.
El agente no puede abrir una ruta que empieza por skills/godot/ o skills/unity/	Localiza la habilidad por su nombre en el directorio donde está instalada y confirma una lectura correcta del archivo antes de editar.
El agente selecciona el motor equivocado	Abre el subdirectorio correcto del juego o indica explícitamente el motor y el proyecto deseados; comprueba los archivos identificadores y la versión que comunica el agente.

Conviene prestar atención a la resolución de rutas: el router describe los archivos de origen como skills/<category>/<name>/SKILL.md, mientras que el instalador de la CLI coloca cada directorio de habilidad directamente bajo su nombre. Un agente que siga literalmente la ruta relativa del repositorio puede no encontrar una habilidad instalada. Esta diferencia entre estructuras es un posible problema que comprobar, no una prueba de que todos los clientes fallen.

Por tanto, en una instalación para Codex o Cursor, la habilidad de Godot seleccionada puede encontrarse en .agents/skills/godot-2d-movement/SKILL.md, con sus propias referencias al lado. Utiliza esa ruta detectada en lugar de crear dentro del juego un segundo árbol de directorios que reproduzca el repositorio.

Revisa las habilidades de terceros antes de reutilizarlas

Revisa estos archivos como instrucciones que pueden influir en las modificaciones del agente y en los comandos que ejecuta. Antes del primer uso, lee el router, las habilidades seleccionadas, las referencias necesarias y los scripts o comandos externos que indiquen al agente que debe ejecutar. Comprueba que la instalación de dependencias, los destinos de descarga, las subidas de datos y las operaciones destructivas correspondan a la tarea que realmente has solicitado.

La vista previa con --list no instala el paquete de habilidades, pero npx sí ejecuta el instalador. Mantén las aprobaciones habituales para ejecutar comandos y revisa en el resumen de instalación qué habilidades existentes se sobrescribirían.

Revisa también los metadatos iniciales, o frontmatter, al incorporar actualizaciones. Por ejemplo, la documentación de allowed-tools de Claude Code explica que este campo puede autorizar de antemano el uso de herramientas; no es un mecanismo de aislamiento. Revisa las instrucciones modificadas y los comandos incluidos aunque el frontmatter sea mínimo.

Procura que el primer cambio sea lo bastante pequeño como para revisarlo en un diff. Después de actualizar una habilidad, repite la comprobación correspondiente en el motor antes de confiar en ella para una funcionalidad más amplia.