Communitygithub.com

Playgama/gamedev-skills

Crie um vídeo promocional, trailer, devlog ou "como eu fiz" sobre um jogo web, com a aparência do próprio jogo, abrindo com a animação do logotipo da Playgama AI. Mostra gameplay real filmado quadro a quadro, os prompts reais e passos do agente como cards na tela, narração, música e um card final, tudo nas cores, fontes e UI do jogo.

O que é gamedev-skills?

Esta skill é projetada para desenvolvedores de jogos que desejam produzir vídeos de alta qualidade sobre seus jogos web, como trailers, devlogs, vídeos "como eu fiz" e conteúdos para redes sociais (YouTube Shorts, TikTok, Reels), páginas de destino ou listagens na Playgama. Ela é ideal para jogos criados com agentes de IA ou publicados via Playgama MCP ou Playgama Bridge SDK. O recurso principal é a capacidade de gerar vídeos que se parecem e soam como o próprio jogo, em vez de vídeos genéricos da plataforma. A skill usa o logotipo oficial da Playgama AI (animação de introdução de 3 segundos e um pequeno bug no canto) e o link para o jogo. Todo o trabalho é dividido em três áreas principais: a história é verdadeira e específica, o gameplay é filmado de forma limpa e o primeiro segundo do vídeo deve prender a atenção. A skill fornece scripts e templates para filmar o jogo quadro a quadro (usando Puppeteer e ffmpeg), extrair cores e fontes do jogo automaticamente, gerar narração (com suporte a ElevenLabs, OpenAI, Gemini, Cartesia ou voz gratuita), e montar e renderizar o vídeo no HyperFrames. Ela funciona no macOS, Linux e Windows, e inclui verificações de ambiente e instalação de dependências. A documentação detalhada c desde a coleta da história real (prompts, commits, bugs) até a exportação final, com regras claras para evitar erros comuns, como usar apenas material real na tela e verificar cada take de narração.

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

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

Fazendo um vídeo sobre um jogo

É assim que fazemos vídeos sobre jogos para a Playgama. O vídeo se parece com o jogo, não com a Playgama: suas cores, fontes, painéis e som. A Playgama adiciona seu logotipo (uma animação de 3 segundos no início e um pequeno bug no canto) e o link. O resto do trabalho está em três lugares: a história é verdadeira e específica, o gameplay é filmado de forma limpa, e o primeiro segundo conquista o próximo.

Os arquivos incluídos:

ArquivoO que é
assets/playgama-ai-logo.svg, .pngO logotipo oficial da Playgama AI (591×133): uma pílula roxa com a marca Playgama, e uma caixa cinza colada a ela com "AI" recortado. O PNG é 4x, transparente
assets/template/Um vídeo HyperFrames inicial, 1920x1080: a animação, três espaços para gameplay, um título, um card final, faixas de música e voz. Um bloco de tema no topo contém a aparência do jogo
assets/sting-preview.mp4A animação de introdução como deve ficar, entregando a um placeholder onde o vídeo do jogo começa
assets/sting.htmlA animação de introdução sozinha, em CSS puro (7 KB, sem bibliotecas): coloque em qualquer página ou ferramenta de vídeo
assets/playgama-ai-sting.htmlA mesma animação como uma página de revisão com controles de reprodução, velocidade e scrub, e a linha do tempo e cores explicadas. Abra em um navegador e arraste uma captura de tela do jogo para ver o logotipo sobre o jogo, ou entregue a um designer
scripts/film.mjs, scripts/vclock.jsFilme qualquer jogo web quadro a quadro em um MP4 suave em qualquer tamanho
scripts/doctor.mjs, scripts/new-video.mjsVerifique a máquina e diga o que instalar; crie a pasta do vídeo (template, gsap, puppeteer)
scripts/palette.mjsAs cores que um jogo usa, amostradas de suas capturas de tela, para quando seu código não tem tema
scripts/voice.mjsA narração: obtém de ElevenLabs, OpenAI, Gemini ou Cartesia (ou uma voz de rascunho gratuita), uma página para escolhê-las de ouvido, e a faixa de voz com a música abaixada sob ela
references/story-and-script.mdFormatos, folhas de batida com exemplos de linhas reais, regras para material na tela
references/game-look.mdComo capturar a aparência do jogo: onde encontrar, cores, tipografia, painéis, movimento, som, o tema do template
references/filming.mdComo filmar takes: preparação, configuração e scripts por quadro, escolha de momentos, o primeiro quadro
references/voice-and-music.mdNarração (texto para fala ou sua própria), pronúncia de "Playgama", verificação de takes, níveis de música
references/edit-and-render.mdMontagem no HyperFrames: o template, cards, cortes verticais, verificações, renderização, revisão

O que você precisa

Funciona da mesma forma no macOS, Linux e Windows.

  1. node scripts/doctor.mjs verifica a máquina e diz o que instalar.
  2. node scripts/new-video.mjs <pasta> cria a pasta do vídeo: o template, gsap.min.js e puppeteer para filmar. Execute todos os comandos posteriores a partir dessa pasta.
  • Para filmar: Node 22+ (HyperFrames precisa), ffmpeg e ffprobe no PATH, e puppeteer. film.mjs encontra-o na pasta de onde é executado ou ao lado do script. O jogo deve ser executado a partir de uma URL: um servidor de desenvolvimento, ou um servidor estático sobre o build.
  • Para montar e renderizar: HyperFrames (npx [email protected]; sua primeira execução baixa cerca de 370 MB de pacotes e um navegador headless).
  • Para a voz, se não for a sua: uma chave para ElevenLabs, ou para outro serviço com o qual scripts/voice.mjs funcione, definida uma vez (references/voice-and-music.md), e Whisper ou outro speech-to-text para verificar os takes.
  • Para música: uma faixa instrumental que você tem permissão para usar.

O fluxo de trabalho

Trabalhe nesta ordem. Cada etapa alimenta a próxima, e os dois pontos de aprovação economizam horas.

  1. Combine sobre o vídeo. Defina o formato, duração e objetivo antes de qualquer outra coisa (tabela abaixo). Pergunte para que é o vídeo: jogadores, uma página de loja, outros desenvolvedores, ou o desafio ou catálogo da Playgama.
  2. Colete a história verdadeira. Reúna os prompts reais, timestamps, commits, bugs, números e capturas de tela (references/story-and-script.md). Se o jogo foi construído com um agente de IA, seu histórico de chat é a fonte mais rica: leia-o e anote horários e citações exatas.
  3. Capture a aparência do jogo (references/game-look.md): suas cores, fontes, painéis, logotipo, música e sons de UI, a partir de seus próprios arquivos primeiro. Escreva-os no bloco de tema do template.
  4. Escreva o roteiro e pare para aprovação. Escreva as falas da narração e o que está na tela, uma linha cada. O desenvolvedor aprova o texto e a aparência antes de qualquer voz ser criada: reformular uma voz gravada significa gravá-la novamente.
  5. Filme o gameplay e tire as capturas de tela com scripts/film.mjs no tamanho de entrega (veja "Imagens do jogo" abaixo e references/filming.md). Planeje um take por batida do roteiro, alguns segundos cada, encenado com os próprios controles do jogo ou hooks de depuração.
  6. Crie os stills com a aparência do jogo. Use código real com números de linha reais, o prompt real e os passos do agente, páginas web e as capas.
  7. Grave a voz e escolha a música (references/voice-and-music.md, scripts/voice.mjs). Um humano ouve os takes de voz, porque a conversão de texto para fala falha de maneiras que nenhuma transcrição capta.
  8. Monte e renderize com o template (references/edit-and-render.md). Execute as verificações, renderize, extraia um quadro a cada poucos segundos e olhe para cada um antes de considerar pronto.
  9. Empacote: uma miniatura (1280x720, o melhor quadro do jogo, no máximo 4 palavras enormes em sua própria fonte), um título e uma descrição com o link do jogo.

Escolha o formato primeiro

VídeoFormaDuraçãoAbre com
Short / Reels / TikTok9:16, 1080x192015–35 sgameplay no primeiro quadro; o logotipo apenas como um pequeno bug no canto
Trailer / promo16:9, 1920x108030–90 sa animação (3 s), depois o melhor gameplay
História "Como eu fiz"16:93–6 mingameplay com a linha de gancho, depois a animação ou um título
Tutorial ("publique com Playgama MCP")16:91–3 min por partea animação, depois o resultado primeiro e os passos depois

Um Short é decidido em seu primeiro segundo, quando o espectador fica ou desliza para longe. Shorts que abrem com gameplay em tela cheia que se lê rapidamente retêm muito mais espectadores do que aqueles que abrem com algo para ler (um longo card de comentário, menus de jogo, uma caixa de chat). Portanto, um Short nunca abre com a animação ou com texto.

A aparência do jogo

O vídeo se parece com o jogo: qualquer um que já jogou deve reconhecê-lo em qualquer quadro. Capture a aparência do jogo em si, não da Playgama (references/game-look.md):

  • Cores de sua UI e código: um fundo, um painel, texto, um botão e um destaque. Quando o código não tem tema, amostre seus menus e HUD com scripts/palette.mjs.
  • Tipografia: toda fonte combina com o jogo, incluindo a fonte do código.
    • Títulos vão em sua fonte de título ou logotipo, rótulos e prompts em sua fonte de UI ou texto.
    • Código e chamadas de ferramentas vão em uma monoespaçada no espírito do jogo: uma pixel para pixel art, uma de máquina de escrever para um jogo sombrio ou retrô.
    • A DM Mono do template apenas mantém seus lugares.
  • Painéis e botões: cards com a forma de seus painéis, o botão do card final como seu botão principal, seus próprios ícones e logotipo.
  • Movimento e som: mova-se como sua UI se move (elástico, calmo ou em passos de pixel). Use sua própria música e sons de UI primeiro.
  • Cards sobre imagens, não slides pretos. Coloque um prompt ou um passo sobre um quadro escurecido do jogo, e um título baixo sobre o gameplay com a parte inferior escurecida na cor de fundo do jogo. Prefira imagens reais lado a lado a cards apenas com nomes neles.

As cores, fontes e forma do painel vão em um bloco de tema no topo do estilo do template.

Imagens do jogo

O kit não vem com nenhuma filmagem de jogo. Cada imagem do jogo é filmada a partir do próprio jogo do desenvolvedor, por você, com scripts/film.mjs (references/filming.md). Isso cobre o vídeo, a miniatura, o quadro atrás de um card e as páginas de revisão.

  • Clipes: um take por batida, por exemplo node scripts/film.mjs --url http://localhost:5173 --out clips/gameplay-1.mp4 --seconds 6.
  • Capturas de tela: o mesmo comando com --still <segundos> escreve um PNG daquele momento. Tire uma sempre que um passo precisar de uma imagem do jogo:
    • seus menus e HUD, para ler sua aparência (scripts/palette.mjs);
    • o quadro atrás de um card de prompt ou um título;
    • a miniatura e o card final;
    • a animação sobre o jogo, para verificar se o bug do canto não sobrepõe o HUD. Arraste a captura de tela em assets/playgama-ai-sting.html, ou coloque o primeiro clipe no template e execute npx [email protected] snapshot . --at 3.5 --describe false.
  • Cortes verticais são filmados em 1080x1920, com a câmera do jogo reenquadrada para isso.
  • Se o jogo não puder ser executado aqui (um build nativo, uma tela de login, um jogo online), peça ao desenvolvedor gravações de tela e capturas de tela no tamanho de entrega, sem cursor ou notificações na tela. Nunca preencha uma lacuna com imagens de outro jogo, uma página de loja ou exemplos deste kit.

O que a Playgama adiciona

Seu logotipo e o link, nada mais. O roxo e a placa escura da Playgama pertencem ao logotipo e à animação, não ao vídeo.

  • O logotipo é assets/playgama-ai-logo.svg, o arquivo oficial: uma pílula roxa #9747ff com a marca branca, e uma caixa cinza #d2d2d2 com "AI" recortado.
    • Use-o como está: não recolorir, esticar, adicionar efeitos, alterar seus espaços ou redesenhá-lo.
    • O "AI" é um buraco, então mostra o que está atrás do logotipo.
    • Dê a ele espaço livre de pelo menos metade da altura da pílula.
    • Como um bug de canto, tem cerca de 200 px de largura em um quadro de 1920. Se o HUD do próprio jogo estiver nesse canto, mova o bug para outro canto em vez de cobrir o HUD (references/edit-and-render.md).
  • O link para a Playgama vai para a própria página do jogo lá: no card final e na descrição.

A animação de introdução

Identidade da Playgama, como o logotipo de uma editora antes de um trailer: cerca de 3 segundos, pré-pronto em assets/template/index.html. Mantém suas próprias cores e timing em cada vídeo; tudo depois disso é do jogo. assets/sting-preview.mp4 mostra a transição para um placeholder. Para vê-la sobre o jogo do desenvolvedor, tire uma captura de tela ou um clipe do jogo (veja "Imagens do jogo").

  • Construção: sobre ônix com um brilho roxo suave, a pílula roxa cresce a partir de seu centro (0,05 s, ao longo de 0,55 s). A marca branca "playgama" aparece da esquerda para a direita (0,42 s). A caixa cinza surge rente à pílula (0,92 s), e "A" e "I" são recortados dela (1,12 s, 1,27 s). Uma faixa de luz cruza a pílula (1,55 s).
  • Transição: todo o logotipo voa para o canto superior direito em 19% do tamanho, a 39 px do topo e da direita de um quadro 1920×1080 (2,75 s, ao longo de 0,62 s). Permanece lá como o bug enquanto o gameplay aparece por baixo (3,0 s).
  • As partes são desenhadas a partir das formas do próprio arquivo oficial com 240 px de altura, para que a animação termine exatamente no logotipo.
  • Alteração: mantenha seu timing. Para colocar uma abertura fria primeiro (uma história), inicie a animação mais tarde: defina S no template (references/edit-and-render.md). Para um corte 9:16, descarte a construção e inicie o bug no canto desde o primeiro quadro.

Regras que vieram de erros

  • Apenas material real na tela.
    • Mostre prompts reais, números reais, timestamps reais e código real.
    • Se um número tiver que ser ilustrativo, diga na tela ("DADOS DE EXEMPLO") durante todo o tempo em que aparecer.
    • Nunca invente uma citação, um comentário, uma contagem de jogadores ou uma avaliação. Espectadores que verificam um número inventado param de confiar no resto.
  • Prompts na tela são as palavras do desenvolvedor.
    • Traduza-os para o idioma do vídeo, mas não os reformule.
    • Corte um longo com "[...]" em vez de parafraseá-lo.
    • Passos do agente são as chamadas de ferramentas reais em sua ordem real, por exemplo create_application → start_archive_upload → get_archive_status (APROVADO) → publish_sandbox (um link público).
  • Apenas sua própria arte. Não mostre personagens, logotipo ou arte de outro jogo, mesmo que seu jogo seja "como" ele: nomeie o gênero em vez disso ("um jogo de terror de fuga"), não outro jogo.
  • Playgama é dito "play-GAH-ma". Vozes em inglês dizem "play-GAY-ma" a menos que você as oriente (references/voice-and-music.md).
  • Verifique cada take de voz em relação ao seu texto (uma transcrição), e peça a uma pessoa para ouvir. A conversão de texto para fala já repetiu uma frase, adicionou uma que ninguém escreveu, leu suas próprias instruções em voz alta e engoliu uma última sílaba, cada uma em um take que soava bem por si só.
  • O primeiro quadro do gameplay é lido em menos de um segundo, não um menu ou tela de carregamento.
    • Um Short abre com ele. Um trailer ou uma história chega a ele logo após a animação ou a abertura fria.
    • Filme o melhor momento, não o início de uma fase.
    • Texto nos primeiros dois segundos do gameplay: no máximo quatro palavras enormes.
  • A filmagem permanece na máquina. O snapshot do HyperFrames envia quadros para o Gemini para uma descrição sempre que uma chave Gemini ou Google está definida, e ele lê um .env na pasta do vídeo. Passe --describe false para cada snapshot, e mantenha as chaves de voz no arquivo de chave compartilhado de voice.mjs, não na pasta do vídeo.

Quando terminar

O desenvolvedor recebe:

  • o MP4 mestre, e uma prévia menor se for grande;
  • a miniatura;
  • um arquivo de texto com o título, a descrição (o link do jogo, capítulos para vídeos longos, #playgama) e um comentário para fixar.

Diga a eles onde cada arquivo está e o que ainda é decisão deles: horário de postagem, um take de voz que eles ainda não ouviram, e qualquer coisa que você não pôde verificar.

Habilidades Relacionadas