Communitygithub.com

Playgama/gamedev-skills

Crea un promo, tráiler, devlog o video 'cómo lo hice' sobre un juego web, con la apariencia del propio juego, comenzando con la animación del logotipo de Playgama AI. Muestra gameplay real filmado fotograma a fotograma, los prompts reales y pasos del agente como tarjetas en pantalla, locución, música y una tarjeta final, todo en los colores, fuentes e IU del juego. Úsalo siempre que un desarrollador de juegos quiera un video sobre su juego para YouTube, Shorts, TikTok, Reels, una página de aterrizaje o un listado de Playgama, especialmente un juego creado con un agente de IA o publicado a través de Playgama MCP o el SDK de Playgama Bridge. Úsalo incluso cuando solo digan 'haz un tráiler', 'graba gameplay para un video', 'un corto sobre mi juego' o 'un video de cómo construí esto', y siempre que necesiten el logotipo de Playgama AI o su animación de introducción.

¿Qué es gamedev-skills?

Esta habilidad para agentes de IA (como Claude Code, Cursor o Codex) automatiza la creación de videos promocionales, tráilers, devlogs o videos 'cómo lo hice' para juegos web publicados en Playgama. El video resultante adopta completamente la apariencia del juego (colores, fuentes, paneles y sonidos), mostrando gameplay real filmado fotograma a fotograma, los prompts y pasos del agente de IA como tarjetas en pantalla, locución, música y una tarjeta final. Solo se añade el logotipo de Playgama (una animación de 3 segundos al inicio y una marca pequeña en la esquina) y el enlace. La habilidad proporciona scripts para filmar el juego, extraer su paleta de colores, generar locuciones (con ElevenLabs, OpenAI, Gemini o Cartesia), y ensamblar el video mediante HyperFrames. Incluye plantillas, referencias detalladas y un flujo de trabajo paso a paso con puntos de aprobación. Funciona en macOS, Linux y Windows, y es ideal para desarrolladores que crean juegos con agentes de IA, usando Playgama MCP o el SDK de Playgama Bridge, que necesitan contenido promocional rápido y con una identidad visual coherente.

Compatible con~Claude Code✓Codex CLI✓Cursor✓Gemini CLI
npx skills add https://github.com/Playgama/gamedev-skills/tree/HEAD/skills/playgama-game-video

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

Cómo hacer un video sobre un juego

Así es como hacemos videos sobre juegos para Playgama. El video se ve como el juego, no como Playgama: sus colores, fuentes, paneles y sonido. Playgama añade su logotipo (una animación de 3 segundos al inicio y una pequeña marca en la esquina) y el enlace. El resto del trabajo se divide en tres partes: la historia es real y específica, el gameplay se filma limpiamente y el primer segundo gana el siguiente.

Los archivos incluidos:

ArchivoQué es
assets/playgama-ai-logo.svg, .pngEl logotipo oficial de Playgama AI (591×133): una píldora morada con la marca Playgama, y una caja gris pegada con "AI" recortado. El PNG es 4x, transparente
assets/template/Un video HyperFrames de inicio, 1920x1080: la animación, tres espacios de gameplay, un título, una tarjeta final, pistas de música y voz. Un bloque de tema en la parte superior contiene la apariencia del juego
assets/sting-preview.mp4La animación de introducción tal como debería verse, pasando a un marcador de posición donde comienza el video del juego
assets/sting.htmlLa animación de introducción sola, en CSS puro (7 KB, sin librerías): colócala en cualquier página o herramienta de video
assets/playgama-ai-sting.htmlLa misma animación como una página de revisión con controles de reproducción, velocidad y desplazamiento, y la línea de tiempo y colores detallados. Ábrela en un navegador y coloca una captura de pantalla del juego para ver el logotipo sobre el juego, o pásala a un diseñador
scripts/film.mjs, scripts/vclock.jsFilma cualquier juego web fotograma a fotograma en un MP4 suave a cualquier tamaño
scripts/doctor.mjs, scripts/new-video.mjsVerifica la máquina y dice qué instalar; crea la carpeta del video (plantilla, gsap, puppeteer)
scripts/palette.mjsLos colores que usa un juego, muestreados de sus capturas de pantalla, para cuando su código no tiene tema
scripts/voice.mjsLa locución: toma de ElevenLabs, OpenAI, Gemini o Cartesia (o un borrador de voz gratuito), una página para elegirlos de oído y la pista de voz con la música atenuada
references/story-and-script.mdFormatos, guiones gráficos con ejemplos de líneas reales, reglas para el material en pantalla
references/game-look.mdCómo tomar la apariencia del juego: dónde encontrarla, colores, tipografía, paneles, movimiento, sonido, el tema de la plantilla
references/filming.mdCómo filmar tomas: preparación, configuración y scripts por fotograma, elección de momentos, el primer fotograma
references/voice-and-music.mdLocución (texto a voz o propia), pronunciación de "Playgama", verificación de tomas, niveles de música
references/edit-and-render.mdEnsamblaje en HyperFrames: la plantilla, tarjetas, cortes verticales, verificaciones, renderizado, revisión

Lo que necesitas

Funciona igual en macOS, Linux y Windows.

  1. node scripts/doctor.mjs verifica la máquina y dice qué instalar.
  2. node scripts/new-video.mjs <carpeta> crea la carpeta del video: la plantilla, gsap.min.js y puppeteer para filmar. Ejecuta cada comando posterior desde esa carpeta.
  • Para filmar: Node 22+ (HyperFrames lo necesita), ffmpeg y ffprobe en el PATH, y puppeteer. film.mjs lo encuentra en la carpeta desde la que se ejecuta, o junto al script. El juego debe ejecutarse desde una URL: un servidor de desarrollo o un servidor estático sobre el build.
  • Para ensamblar y renderizar: HyperFrames (npx [email protected]; su primera ejecución descarga unos 370 MB de paquetes y un navegador headless).
  • Para la voz, si no es propia: una clave para ElevenLabs, o para otro servicio con el que funcione scripts/voice.mjs, configurada una vez (references/voice-and-music.md), y Whisper u otro reconocimiento de voz para verificar las tomas.
  • Para la música: una pista instrumental que tengas permiso de usar.

El flujo de trabajo

Trabaja en este orden. Cada paso alimenta al siguiente, y los dos puntos de aprobación ahorran horas.

  1. Acordar el video. Define el formato, la duración y el objetivo antes de cualquier otra cosa (tabla abajo). Pregunta para qué es el video: jugadores, una página de tienda, otros desarrolladores, o el desafío o catálogo de Playgama.
  2. Recopilar la historia real. Reúne los prompts reales, marcas de tiempo, commits, bugs, números y capturas de pantalla (references/story-and-script.md). Si el juego se construyó con un agente de IA, su historial de chat es la fuente más rica: léelo y anota momentos y citas exactas.
  3. Tomar la apariencia del juego (references/game-look.md): sus colores, fuentes, paneles, logotipo, música y sonidos de IU, primero de sus propios archivos. Escríbelos en el bloque de tema de la plantilla.
  4. Escribir el guion, luego detenerse para aprobación. Escribe las líneas de voz y lo que aparece en pantalla, una fila cada uno. El desarrollador aprueba el texto y la apariencia antes de que se haga cualquier voz: cambiar el texto de una voz grabada significa grabarla de nuevo.
  5. Filmar el gameplay y tomar las capturas de pantalla con scripts/film.mjs al tamaño de entrega (ver "Imágenes del juego" abajo, y references/filming.md). Planea una toma por cada momento del guion, de unos segundos cada una, preparada con los controles del juego o hooks de depuración.
  6. Hacer las imágenes fijas con la apariencia del juego. Usa código real con números de línea reales, el prompt real y los pasos del agente, páginas web y las portadas.
  7. Grabar la voz y elegir la música (references/voice-and-music.md, scripts/voice.mjs). Una persona escucha las tomas de voz, porque el texto a voz falla de maneras que ninguna transcripción detecta.
  8. Ensamblar y renderizar con la plantilla (references/edit-and-render.md). Ejecuta las verificaciones, renderiza, extrae un fotograma cada pocos segundos y revisa cada uno antes de darlo por terminado.
  9. Empaquetar: un thumbnail (1280x720, el mejor fotograma del juego, con como máximo 4 palabras grandes en su propia fuente), un título y una descripción con el enlace del juego.

Elegir el formato primero

VideoFormaDuraciónComienza con
Short / Reels / TikTok9:16, 1080x192015–35 sgameplay en el primer fotograma; el logotipo solo como una pequeña marca en la esquina
Tráiler / promo16:9, 1920x108030–90 sla animación (3 s), luego el mejor gameplay
Historia "Cómo lo hice"16:93–6 mingameplay con la línea gancho, luego la animación o un título
Tutorial ("publicar con Playgama MCP")16:91–3 min por partela animación, luego el resultado primero y los pasos después

Un Short se decide en su primer segundo, cuando el espectador se queda o se desliza. Los Shorts que comienzan con gameplay a pantalla completa que se entiende de un vistazo retienen muchos más espectadores que los que comienzan con algo para leer (una tarjeta larga de comentarios, menús del juego, una caja de chat). Por lo tanto, un Short nunca comienza con la animación o con texto.

La apariencia del juego

El video se ve como el juego: cualquiera que lo haya jugado debería reconocerlo en cualquier fotograma. Toma la apariencia del juego mismo, no de Playgama (references/game-look.md):

  • Colores de su IU y código: un fondo, un panel, texto, un botón y un resalte. Cuando el código no tiene tema, muestrea sus menús y HUD con scripts/palette.mjs.
  • Tipografía: cada fuente coincide con el juego, incluida la fuente del código.
    • Los títulos van en su fuente de título o logotipo, las etiquetas y prompts en su fuente de IU o texto.
    • El código y las llamadas a herramientas van en una monoespaciada acorde con su estilo: una de píxeles para pixel art, una de máquina de escribir para un juego oscuro o retro.
    • La DM Mono de la plantilla solo mantiene sus lugares.
  • Paneles y botones: tarjetas con la forma de sus paneles, el botón de la tarjeta final como su botón principal, sus propios iconos y logotipo.
  • Movimiento y sonido: muévete como se mueve su IU (rebotante, tranquilo o en pasos de píxeles). Usa su propia música y sonidos de IU primero.
  • Tarjetas sobre imágenes, no diapositivas negras. Coloca un prompt o un paso sobre un fotograma oscurecido del juego, y un título bajo sobre el gameplay con la parte inferior oscurecida en el color de fondo del juego. Prefiere imágenes reales una al lado de la otra en lugar de tarjetas con solo nombres.

Los colores, fuentes y forma de los paneles van en un bloque de tema en la parte superior del estilo de la plantilla.

Imágenes del juego

El kit no incluye ningún metraje del juego. Cada imagen del juego se filma desde el propio juego del desarrollador, por ti, con scripts/film.mjs (references/filming.md). Esto cubre el video, el thumbnail, el fotograma detrás de una tarjeta y las páginas de revisión.

  • Clips: una toma por momento, por ejemplo node scripts/film.mjs --url http://localhost:5173 --out clips/gameplay-1.mp4 --seconds 6.
  • Capturas de pantalla: el mismo comando con --still <segundos> escribe un PNG de ese momento en su lugar. Toma una cada vez que un paso necesite una imagen del juego:
    • sus menús y HUD, para leer su apariencia (scripts/palette.mjs);
    • el fotograma detrás de una tarjeta de prompt o un título;
    • el thumbnail y la tarjeta final;
    • la animación sobre el juego, para verificar que la marca de la esquina no cubra su HUD. Coloca la captura de pantalla en assets/playgama-ai-sting.html, o pon el primer clip en la plantilla y ejecuta npx [email protected] snapshot . --at 3.5 --describe false.
  • Cortes verticales se filman a 1080x1920, con la cámara del juego reencuadrada para ello.
  • Si el juego no puede ejecutarse aquí (un build nativo, un muro de inicio de sesión, un juego solo online), pídele al desarrollador grabaciones de pantalla y capturas al tamaño de entrega, sin cursor ni notificaciones en pantalla. Nunca llenes un vacío con imágenes de otro juego, una página de tienda o los ejemplos de este kit.

Lo que Playgama añade

Su logotipo y el enlace, nada más. El morado de Playgama y la placa oscura pertenecen al logotipo y la animación, no al video.

  • El logotipo es assets/playgama-ai-logo.svg, el archivo oficial: una píldora morada #9747ff con la marca blanca, y una caja gris #d2d2d2 con "AI" recortado.
    • Úsalo tal cual: no lo recolores, estires, añadas efectos, cambies sus espacios ni lo redibujes.
    • El "AI" es un agujero, por lo que muestra lo que esté detrás del logotipo.
    • Dale un espacio claro de al menos la mitad de la altura de la píldora.
    • Como marca de esquina, tiene aproximadamente 200 px de ancho en un fotograma de 1920. Si el HUD del juego está en esa esquina, mueve la marca a otra esquina en lugar de cubrir el HUD (references/edit-and-render.md).
  • El enlace a Playgama va a la página del juego allí: en la tarjeta final y en la descripción.

La animación de introducción

El identificador de Playgama, como el logotipo de un editor antes de un tráiler: unos 3 segundos, ya preparado en assets/template/index.html. Mantiene sus propios colores y temporización en cada video; todo lo que sigue es del juego. assets/sting-preview.mp4 muestra cómo pasa a un marcador de posición. Para verlo sobre el juego del desarrollador, toma una captura de pantalla o un clip del juego (ver "Imágenes del juego").

  • Construcción: sobre ónix con un brillo morado suave, la píldora morada crece desde su centro (0.05 s, durante 0.55 s). La marca blanca playgama aparece de izquierda a derecha (0.42 s). La caja gris aparece pegada a la píldora (0.92 s), y "A" e "I" se recortan de ella (1.12 s, 1.27 s). Una banda de luz cruza la píldora (1.55 s).
  • Transición: el logotipo completo vuela a la esquina superior derecha al 19% de tamaño, a 39 px del borde superior y derecho de un fotograma de 1920×1080 (2.75 s, durante 0.62 s). Permanece allí como la marca mientras el gameplay aparece debajo (3.0 s).
  • Las partes están dibujadas de las formas del archivo oficial a 240 px de alto, por lo que la animación termina exactamente en el logotipo.
  • Cambio: mantén su temporización. Para poner una apertura en frío primero (una historia), comienza la animación más tarde: establece S en la plantilla (references/edit-and-render.md). Para un corte 9:16, elimina la construcción y comienza la marca en la esquina desde el primer fotograma.

Reglas que vinieron de errores

  • Solo material real en pantalla.
    • Muestra prompts reales, números reales, marcas de tiempo reales y código real.
    • Si un número debe ser ilustrativo, dila en pantalla ("DATOS DE EJEMPLO") todo el tiempo que se muestre.
    • Nunca inventes una cita, un comentario, un número de jugadores o una reseña. Los espectadores que verifican un número inventado dejan de confiar en el resto.
  • Los prompts en pantalla son las palabras del desarrollador.
    • Tradúcelos al idioma del video, pero no los reformules.
    • Corta uno largo con "[…]" en lugar de parafrasearlo.
    • Los pasos del agente son las llamadas a herramientas reales en su orden real, por ejemplo create_application → start_archive_upload → get_archive_status (PASSED) → publish_sandbox (un enlace público).
  • Solo tu propio arte. No muestres personajes, logotipos ni arte de otro juego, incluso si tu juego es "como" él: nombra el género en su lugar ("un juego de terror de escape"), no otro juego.
  • Playgama se dice "play-GAH-ma". Las voces en inglés dicen "play-GAY-ma" a menos que las dirijas (references/voice-and-music.md).
  • Verifica cada toma de voz contra su texto (una transcripción), y haz que una persona escuche. El texto a voz ha repetido una oración, añadido una que nadie escribió, leído sus propias instrucciones en voz alta y tragado una última sílaba, cada uno en una toma que sonaba bien por sí sola.
  • El primer fotograma de gameplay se entiende en menos de un segundo, no un menú o una pantalla de carga.
    • Un Short comienza con él. Un tráiler o una historia lo alcanza justo después de la animación o la apertura en frío.
    • Filma el mejor momento, no el comienzo de un nivel.
    • Texto en los primeros dos segundos de gameplay: como máximo cuatro palabras grandes.
  • El metraje se queda en la máquina. El comando snapshot de HyperFrames envía fotogramas a Gemini para una descripción cada vez que se establece una clave de Gemini o Google, y lee un .env en la carpeta del video. Pasa --describe false a cada snapshot, y guarda las claves de voz en el archivo de claves compartido de voice.mjs, no en la carpeta del video.

Cuando hayas terminado

El desarrollador recibe:

  • el MP4 maestro, y una vista previa más pequeña si es grande;
  • el thumbnail;
  • un archivo de texto con el título, la descripción (el enlace del juego, capítulos para videos largos, #playgama) y un comentario para fijar.

Diles dónde está cada archivo y qué sigue siendo decisión suya: la hora de publicación, una toma de voz que no han escuchado y cualquier cosa que no hayas podido verificar.

Skills relacionados