Communitygithub.com

demoscene-intro

Crie uma intro demoscene size-coded (64k, ou 4k/8k/16k/32k) como um único arquivo HTML com gráficos WebGL em tempo real, trilha sonora WebAudio sintetizada e coreografia de câmera e legendas.

O que é demoscene-intro?

Este skill capacita um agente de IA a criar uma produção audiovisual no estilo demoscene (demo, intro, competição) como um único arquivo HTML autossuficiente, respeitando um orçamento de bytes definido pelo usuário (padrão 64 KB, mas suporta 4k, 8k, 16k, 32k). O agente traduz a direção de arte fornecida pelo usuário (por exemplo, 'um voo lento por uma catedral inundada com uma trilha ambiente') em uma peça completa: gráficos 3D em tempo real via WebGL2, música sintetizada via WebAudio, legendas sincronizadas, transições e tela inicial. O skill enfatiza a originalidade, evitando clichês de gênero, e fornece especificações técnicas precisas (como expor a música para renderização offline), armadilhas comuns (como áudio que cresce infinitamente ou revelações que vazam visualmente) e scripts de verificação para orçamento, áudio e colisão de câmera. É adequado para qualquer plataforma de agente que suporte execução de código e abertura de arquivos no navegador (Claude Code, Cursor, Codex, etc.). A saída é um único arquivo HTML que o usuário pode abrir e assistir imediatamente.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/LukaszDygon/demoscene/tree/HEAD/skill/demoscene-intro

Perguntar na sua IA favorita

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

Documentação

Intro Demoscene

Você está criando uma obra de arte que, por acaso, é minúscula. O briefing do usuário é a direção de arte. Seu trabalho é realizá-la com tanto ofício e invenção quanto couber no orçamento: o briefing é o piso, não o teto.

A especificação

  • Um único arquivo HTML, sem requisições externas, dentro do orçamento de bytes (padrão 65.536). Respeite o que o usuário disser: 4k, 8k, 16k, 32k. O código da trilha sonora tem seu próprio suborçamento (padrão 16.384, ou aproximadamente um quarto do total para categorias menores). Informe o tamanho bruto e descompactado. Um empacotador autoextraível só é aceitável se as regras da festa do usuário permitirem; se você usar um, avise.
  • Gráficos em tempo real (WebGL2) e uma trilha sonora sintetizada (WebAudio), ambos gerados por código. Texto usa fontes do sistema com uma pilha de fallback para macOS, Windows e Linux, porque embutir uma fonte estoura o orçamento.
  • Inicia em cerca de um segundo após o clique. Sintetize ao vivo com um pequeno lookahead. Navegadores bloqueiam áudio sem um gesto, então faça a tela inicial parte da peça, em vez de um genérico "clique para começar". O relógio de áudio conduz os visuais.
  • Sincronize tudo com a música em compassos e batidas. Escreva o storyboard em compassos primeiro: cena, câmera, legendas, seção musical.

Faça ser seu, não genérico

A falha mais comum é uma peça rígida e segura: uma tela de título de template, sombreamento plano em tudo, uma câmera sobre trilhos, legendas que apenas rotulam a cena. Escolha a técnica por briefing:

  • SDFs raymarched e luz volumétrica para subaquático, nuvens, formas orgânicas
  • Malhas para arquitetura e personagens
  • Um único shader de fragmento para 4k–16k
  • Truques de canvas 2D, partículas e buffers de feedback onde servirem ao visual

Gaste bytes onde o olho vai:

  • luz: névoa, feixes de luz, brilho, reflexos
  • textura e ruído
  • movimento secundário: coisas flutuando, respirando, reagindo à batida
  • um ou dois momentos marcantes por peça que o espectador lembre

Cuidado com a primeira resposta do gênero: a progressão, o tempo, a paleta sonora ou o efeito pós mais familiar para o estilo, como Am–F–C–G para synthwave, ou tremulação de fita, scanlines e bloom em tudo. Derive tempo, tom, harmonia, timbres e pós-processamento do clima e assunto deste briefing, e faça pelo menos uma escolha que um ouvinte não preveria a partir do rótulo do gênero. Pegue convenções apenas da estrutura de pastas de outras intros, nunca da sua aparência ou som.

Trate a tela de título, as transições e a tela final como parte da arte. Se o briefing for enxuto, invente no seu espírito e diga ao usuário o que você adicionou.

Contratos (para as ferramentas de verificação funcionarem)

  • Mantenha a música em seu próprio script cujo código também possa renderizar offline: exponha SONG.render() → Promise<AudioBuffer> executando o mesmo escalonador em um OfflineAudioContext. É assim que você mede uma mixagem que não pode ouvir. Veja references/audio.md.
  • Opcional, para voos de câmera através de geometria: defina window.__probe = {dur, cam: t => [x,y,z], boxes: [[x0,y0,z0,x1,y1,z1], …]} para a verificação de folga.

Verifique seu trabalho

python3 <skill>/scripts/budget.py dist/x.html --total 65536 --music src/music.js --music-max 16384
node <skill>/scripts/check.mjs e2e dist/x.html         # clique → tempo do primeiro som, exceções
node <skill>/scripts/check.mjs audio src/music.js      # renderização offline: pico, NaN, RMS a cada 4 compassos
node <skill>/scripts/check.mjs clearance dist/x.html   # se __probe estiver definido

Não tire capturas de tela: o usuário julga a peça assistindo-a em movimento com som, e essa é a revisão visual. Capture problemas visuais raciocinando sobre o código: exposição e matemática de cores, o que está na tela em cada momento da linha do tempo e se uma revelação é visível muito cedo. Para áudio, busque um pico de 0,5–0,95, sem NaNs, e níveis de seção que sigam o arranjo.

Entregue

Abra a intro no navegador do usuário para que ele possa assisti-la com som (open dist/x.html). Diga a ele o tamanho em relação ao orçamento, a linha do tempo, o que você inventou além do briefing e o que não pôde verificar. Você não ouviu a música; apenas a mediu.

Armadilhas que custam horas antes

  • Grafos de áudio que só crescem. Escalonar uma música inteira de uma vez mantém milhares de nós mortos ativos. Escalone compasso por compasso e desconecte nós finalizados (references/audio.md).
  • Buffers a 44,1 kHz fixos falham em contextos ao vivo de 48 kHz. Use ctx.sampleRate.
  • Revelações vazam. Objetos heróis grandes aparecem através de paredes e telhados abertos muito antes do seu momento. Feche-os no tempo ou esconda-os atrás de algo.
  • Rostos só são lidos de frente, mantidos por alguns segundos.
  • Legendas precisam de uma sombra escura ou brilho para permanecerem legíveis sobre cenas claras.
  • -x**2 é um erro de sintaxe JS; escreva -(x**2).

Habilidades Relacionadas