Communitygithub.com

Demoscene-Intro

Erstelle eine größenlimitierte Demoscene-Intro (64k, 4k/8k/16k/32k Budget) als eigenständige HTML-Datei mit Echtzeit-WebGL-Grafiken, einem synthetisierten WebAudio-Soundtrack und choreografierten Kamerafahrten und Untertiteln.

Was ist Demoscene-Intro?

Dieses Skill ermöglicht es einem KI-Agenten, auf Benutzeranfragen nach einer Demoscene-Intro, einem Musikvideo oder einer audiovisuellen Echtzeitproduktion im Browser zu antworten, indem es eine vollständige, eigenständige HTML-Datei generiert – normalerweise unter 64 KB (oder einem benutzerdefinierten Budget wie 4k, 8k, 16k oder 32k). Das Skill spezifiziert die technischen Anforderungen: WebGL2 für Grafiken, WebAudio für einen vollständig synthetischen Soundtrack und eine präzise Synchronisation von Musik, Kamera und Untertiteln. Es enthält auch Verträge für Testwerkzeuge (wie Budget- und Audioprüfung) und warnt vor häufigen Fallstricken, wie etwa unbegrenzt wachsenden Audio-Graphen oder visuellen Undichtigkeiten, die die Illusion der Szene stören. Der Benutzer liefert die künstlerische Richtung; das Skill kümmert sich um die Spezifikation, die Fallstricke und die Überprüfungswerkzeuge, sodass der Fokus auf der kreativen Umsetzung liegt.

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

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

Was macht Demoscene-Intro?

Du schaffst ein Kunstwerk, das zufällig winzig ist. Die Vorgaben des Benutzers sind die künstlerische Richtung. Deine Aufgabe ist es, diese mit so viel handwerklichem Können und Erfindungsreichtum umzusetzen, wie das Budget erlaubt: Die Vorgaben sind der Boden, nicht die Decke.

Die Spezifikation

  • Eine HTML-Datei, keine externen Anfragen, innerhalb des Byte-Budgets (Standard 65.536). Respektiere, was der Benutzer sagt: 4k, 8k, 16k, 32k. Der Soundtrack-Code erhält ein eigenes Teilbudget (Standard 16.384, oder etwa ein Viertel des Gesamtbudgets für kleinere Kategorien). Melde die rohe, unkomprimierte Größe. Ein selbstextrahierender Packer ist nur in Ordnung, wenn die Partyrregeln des Benutzers dies erlauben, und wenn du einen verwendest, sag es.
  • Echtzeit-Grafiken (WebGL2) und ein synthetisierter Soundtrack (WebAudio), beide durch Code generiert. Text verwendet Betriebssystem-Schriftarten mit einer Fallback-Liste für macOS, Windows und Linux, da das Einbetten einer Schriftart das Budget sprengt.
  • Startet innerhalb von etwa einer Sekunde nach dem Klick. Synthetisiere live mit einem kurzen Vorausschau. Browser blockieren Audio ohne eine Benutzerinteraktion, daher mache den Startbildschirm zu einem Teil des Stücks, anstatt einen generischen „Klick zum Starten“ zu verwenden. Der Audio-Clock treibt die visuellen Elemente.
  • Synchronisiere alles mit der Musik in Takten und Beats. Schreibe das Storyboard zuerst in Takten: Szene, Kamera, Untertitel, Musikabschnitt.

Mach es zu deinem, nicht generisch

Der häufigste Fehler ist ein steifes, sicheres Stück: eine schablonenhafte Titelkarte, überall flache Schattierung, eine Kamera auf Schienen, Untertitel, die nur die Szene beschriften. Wähle die Technik pro Vorgabe:

  • Raymarched SDFs und volumetrisches Licht für Unterwasser, Wolken, organische Formen
  • Meshes für Architektur und Charaktere
  • Ein einzelner Fragment-Shader für 4k–16k
  • 2D-Canvas-Tricks, Partikel und Feedback-Puffer, wo sie den Look unterstützen

Gib Bytes aus, wo das Auge hinschaut:

  • Licht: Nebel, Lichtstrahlen, Glühen, Reflexionen
  • Textur und Rauschen
  • Sekundäre Bewegung: Dinge, die treiben, atmen, auf den Takt reagieren
  • Ein oder zwei charakteristische Momente pro Stück, an die sich der Betrachter erinnert

Hüte dich vor der ersten Antwort des Genres: der vertrautesten Progression, Temp, Klangpalette oder Nachbearbeitung für den Stil, wie Am–F–C–G für Synthwave, oder Bandwackeln, Scanlines und Bloom auf allem. Leite Tempo, Tonart, Harmonie, Klangfarben und Nachbearbeitung aus der Stimmung und dem Thema dieser Vorgabe ab und triff mindestens eine Entscheidung, die ein Zuhörer nicht aus dem Genre-Etikett vorhersagen könnte. Übernimm Konventionen nur aus der Ordnerstruktur anderer Intros, niemals deren Look oder Sound.

Behandle den Titelbildschirm, die Übergänge und die Endkarte als Teil der Kunst. Wenn die Vorgabe dünn ist, erfinde in ihrem Geist und sag dem Benutzer, was du hinzugefügt hast.

Verträge (damit die Überprüfungswerkzeuge funktionieren)

  • Halte die Musik in einem eigenen Skript, dessen Code auch offline rendern kann: mache SONG.render() verfügbar → Promise<AudioBuffer>, indem du denselben Scheduler auf einem OfflineAudioContext ausführst. So misst du einen Mix, den du nicht hören kannst. Siehe references/audio.md.
  • Optional, für Kamerafahrten durch Geometrie: definiere window.__probe = {dur, cam: t => [x,y,z], boxes: [[x0,y0,z0,x1,y1,z1], …]} für die Freiraum-Prüfung.

Überprüfe deine Arbeit

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         # Klick → erste Soundzeit, Ausnahmen
node <skill>/scripts/check.mjs audio src/music.js      # Offline-Render: Spitzenwert, NaN, RMS pro 4 Takten
node <skill>/scripts/check.mjs clearance dist/x.html   # wenn __probe definiert ist

Mache keine Screenshots: Der Benutzer beurteilt das Stück, indem er es in Bewegung mit Ton sieht, und das ist die visuelle Überprüfung. Erkenne visuelle Probleme, indem du über den Code nachdenkst: Belichtungs- und Farbmathematik, was zu jedem Zeitpunkt der Timeline auf dem Bildschirm ist und ob eine Enthüllung zu früh sichtbar ist. Für Audio strebe einen Spitzenwert von 0,5–0,95 an, keine NaNs und Abschnittspegel, die dem Arrangement folgen.

Liefere

Öffne die Intro im Browser des Benutzers, damit er sie mit Ton sehen kann (open dist/x.html). Sag ihm die Größe im Vergleich zum Budget, die Timeline, was du über die Vorgabe hinaus erfunden hast und was du nicht überprüfen konntest. Du hast die Musik nicht gehört; du hast sie nur gemessen.

Fallstricke, die vorher Stunden kosten

  • Nur wachsende Audio-Graphen. Das Planen eines ganzen Songs im Voraus hält Tausende von toten Knoten am Leben. Plane Takt für Takt und trenne fertige Knoten (references/audio.md).
  • Buffer mit festen 44,1 kHz werfen bei 48 kHz Live-Kontexten Fehler. Verwende ctx.sampleRate.
  • Enthüllungen lecken. Große Heldenobjekte zeigen sich über Wänden und durch offene Dächer, lange vor ihrem Moment. Blende sie zeitlich aus oder verstecke sie hinter etwas.
  • Gesichter sind nur frontal lesbar, halte sie für ein paar Sekunden.
  • Untertitel benötigen einen dunklen Schatten oder Glühen, um über hellen Szenen lesbar zu bleiben.
  • -x**2 ist ein JS-Syntaxfehler; schreibe -(x**2).

Verwandte Skills