Communitygithub.com

demoscene-intro

Construye una intro de demoscene con código de tamaño reducido (64k, o presupuestos de 4k/8k/16k/32k) como un único archivo HTML autónomo con gráficos WebGL en tiempo real, una banda sonora sintetizada con WebAudio dentro de su propio presupuesto de bytes, y una coreografía de cámara y subtítulos. Úsalo siempre que el usuario pida una demo, intro, producción demoscene, intro de 64k/4k, entrada para demoparty, pieza audiovisual con límite de tamaño, secuencia 3D sincronizada con música o video musical procedural en el navegador, incluso si solo describe escenas y ambiente ("un vuelo lento a través de una catedral inundada con una banda sonora ambiental, en menos de 64KB"). El usuario proporciona la dirección artística; esta skill proporciona las especificaciones, los errores comunes y las herramientas de verificación.

¿Qué es demoscene-intro?

Esta skill te permite crear una pieza de demoscene (una demo o intro) autónoma como un solo archivo HTML, con gráficos WebGL2 en tiempo real y una banda sonora sintetizada mediante WebAudio, todo dentro de un límite de tamaño ajustable (4k, 8k, 16k, 32k o 64k por defecto). Es ideal para desarrolladores que desean producir contenido audiovisual con limitaciones de tamaño, como entradas para demoparties o experimentos artísticos en el navegador. La skill especifica la estructura técnica (un solo archivo HTML, sin solicitudes externas), la sincronización con la música en compases y tiempos, y consejos para evitar errores comunes como gráficos de audio que crecen sin control o revelaciones prematuras de objetos. Incluye herramientas de verificación (scripts de presupuesto, pruebas de audio y limpieza) para asegurar que el resultado cumpla con las restricciones de tamaño y funcione correctamente. El énfasis está en la creatividad dentro de las limitaciones: se anima a personalizar iluminación, partículas, texturas y momentos únicos en lugar de recurrir a plantillas genéricas, y a derivar tempo, tonalidad y paleta sonora del estado de ánimo descrito por el usuario.

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

Preguntar en tu IA favorita

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

Documentación

Intro de demoscene

Estás creando una obra de arte que, por casualidad, es diminuta. El resumen del usuario es la dirección artística. Tu trabajo es realizarlo con tanta artesanía e invención como permita el presupuesto: el resumen es el piso, no el techo.

La especificación

  • Un único archivo HTML, sin solicitudes externas, dentro del presupuesto de bytes (por defecto 65 536). Respeta lo que diga el usuario: 4k, 8k, 16k, 32k. El código de la banda sonora tiene su propio subpresupuesto (por defecto 16 384, o aproximadamente un cuarto del total para categorías más pequeñas). Informa el tamaño sin comprimir. Un empaquetador autoextraíble solo está bien si las reglas de la fiesta del usuario lo permiten, y si usas uno, dímelo.
  • Gráficos en tiempo real (WebGL2) y una banda sonora sintetizada (WebAudio), ambos generados por código. El texto utiliza fuentes del sistema con una pila de respaldo para macOS, Windows y Linux, porque incrustar una fuente se sale del presupuesto.
  • Comienza aproximadamente un segundo después del clic. Sintetiza en vivo con un pequeño anticipo. Los navegadores bloquean el audio sin un gesto, así que haz que la pantalla de inicio sea parte de la pieza en lugar de un genérico "haz clic para empezar". El reloj de audio controla los gráficos.
  • Sincroniza todo con la música en compases y tiempos. Escribe el guion gráfico primero en compases: escena, cámara, subtítulos, sección musical.

Hazlo tuyo, no genérico

El fallo más común es una pieza rígida y segura: una tarjeta de título de plantilla, sombreado plano por todas partes, una cámara sobre raíles, subtítulos que solo etiquetan la escena. Elige la técnica según el resumen:

  • SDF trazados por raymarching y luz volumétrica para agua submarina, nubes, formas orgánicas
  • Mallas para arquitectura y personajes
  • Un único sombreador de fragmentos para 4k–16k
  • Trucos con canvas 2D, partículas y búferes de realimentación donde sirvan al estilo

Gasta bytes donde va la vista:

  • luz: niebla, rayos de luz, resplandor, reflejos
  • textura y ruido
  • movimiento secundario: cosas que se desplazan, respiran, reaccionan al ritmo
  • uno o dos momentos emblemáticos por pieza que el espectador recuerde

Cuidado con la primera respuesta del género: la progresión, el tempo, la paleta sonora o el efecto posterior más familiares para el estilo, como Am–F–C–G para el synthwave, o wobble de cinta, líneas de exploración y brillo en todo. Deriva el tempo, la tonalidad, la armonía, los timbres y el postprocesado del estado de ánimo y el tema de este resumen, y haz al menos una elección que un oyente no predeciría a partir de la etiqueta del género. Toma convenciones solo de la estructura de carpetas de otras intros, nunca de su apariencia o sonido.

Trata la pantalla de título, las transiciones y la tarjeta final como parte del arte. Si el resumen es escaso, inventa en su espíritu y dile al usuario lo que has añadido.

Contratos (para que funcionen las herramientas de verificación)

  • Mantén la música en su propio script cuyo código también pueda renderizarse sin conexión: expón SONG.render() → Promise<AudioBuffer> ejecutando el mismo planificador en un OfflineAudioContext. Así es como mides una mezcla que no puedes oír. Consulta references/audio.md.
  • Opcional, para vuelos de cámara a través de geometría: define window.__probe = {dur, cam: t => [x,y,z], boxes: [[x0,y0,z0,x1,y1,z1], …]} para la comprobación de espacio.

Verifica tu trabajo

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         # clic → tiempo del primer sonido, excepciones
node <skill>/scripts/check.mjs audio src/music.js      # renderizado sin conexión: pico, NaN, RMS cada 4 compases
node <skill>/scripts/check.mjs clearance dist/x.html   # si __probe está definido

No tomes capturas de pantalla: el usuario juzga la pieza viéndola en movimiento con sonido, y esa es la revisión visual. Detecta problemas visuales razonando sobre el código: exposición y matemáticas de color, qué hay en pantalla en cada momento de la línea de tiempo, y si una revelación es visible demasiado pronto. Para el audio, apunta a un pico de 0.5–0.95, sin NaN, y niveles de sección que sigan el arreglo.

Entrega

Abre la intro en el navegador del usuario para que pueda verla con sonido (open dist/x.html). Diles el tamaño contra el presupuesto, la línea de tiempo, lo que inventaste más allá del resumen, y lo que no pudiste verificar. No has oído la música; solo la has medido.

Errores comunes que cuestan horas

  • Gráficos de audio que solo crecen. Programar una canción completa de antemano mantiene vivos miles de nodos muertos. Programa compás por compás y desconecta los nodos terminados (references/audio.md).
  • Búferes a 44.1 kHz fijos fallan en contextos en vivo a 48 kHz. Usa ctx.sampleRate.
  • Las revelaciones se filtran. Los grandes objetos héroe aparecen sobre muros y a través de techos abiertos mucho antes de su momento. Actívalos por tiempo o escóndelos detrás de algo.
  • Las caras solo se leen de frente, mantenidas durante un par de segundos.
  • Los subtítulos necesitan una sombra oscura o un resplandor para mantenerse legibles sobre escenas brillantes.
  • -x**2 es un error de sintaxis en JS; escribe -(x**2).

Skills relacionados