Communitygithub.com

Anim erstellen

Erstelle ein „Anim“ – ein einzelnes YAML-Modul, das Liedtexte und Beats im Browser animiert (Canvas2D, SVG, DOM oder three.js) – basierend auf einer kurzen Beschreibung.

Was ist Anim erstellen?

Dieses Skill ermöglicht es einem KI-Agenten, aus einer kurzen Design-Beschreibung ein komplettes, eigenständiges Animationsmodul („Anim“) zu erstellen. Ein Anim ist eine einzelne YAML-Datei, die JavaScript, CSS und HTML/SVG in einem standardisierten Format bündelt. Es wird von einem Host-Player ausgeführt, der eine globale API (`G`) bereitstellt, um Liedtexte, Silben, Wörter, Zeilen, Abschnitte und Beats abzurufen. Der Skill legt strenge Regeln fest: Jeder Frame muss eine reine Funktion der Wiedergabezeit sein (keine Zufalls- oder Zustandsabhängigkeiten), das DOM muss aus der Rendering-Logik herausgehalten werden, und Farben werden über CSS definiert, nicht hartcodiert. Unterstützt werden die Backends Canvas2D, SVG, DOM und three.js. Der Skill enthält einen detaillierten Workflow mit Repo-Tools (Scaffolding, Validierung, Preview) sowie einen reduzierten Workflow für reine Chat-Modelle ohne Shell-Zugriff. Besonderes Augenmerk liegt auf Lesbarkeit, Barrierefreiheit (z. B. Begrenzung von Blinkfrequenzen) und korrekter Handhabung von Suchen, Pausieren, Größenänderungen und Themenwechseln.

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

In Ihrer bevorzugten KI fragen

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

Dokumentation

Ein Anim erstellen

Ein Anim ist eine Datei, <kebab-name>@<major>.<minor>.yaml, mit genau vier Schlüsseln: t (das Literal c), j (ein ES-Modul), s (CSS), h (HTML/SVG). Ein Host-Player führt es mit einer globalen G-API aus, die die Silben, Wörter, Zeilen, Abschnitte und Beats des Lieds bereitstellt. Ihre Aufgabe: Verwandeln Sie eine Beschreibung in eine solche Datei, die unter Suchen/Pausieren/Größenänderung/Thema korrekt, lesbar und schön ist. Pfade unten sind relativ zu diesem skill/-Verzeichnis.

Die wichtigsten Regeln

  1. Ein Frame ist eine reine Funktion der Wiedergabezeit. render(t) muss das gleiche Bild zeichnen, egal ob die Wiedergabe t erreicht hat oder der Benutzer dorthin gesprungen ist. Kein Math.random, Date.now, akkumulierte Integration oder ein „Was war im letzten Frame“-Zustand, den ein Sprung überspringen würde. Leiten Sie alles aus den Lieddaten, dem Seed und t ab.
  2. Zwei Hälften. Eine exportierte, DOM-freie reine Hälfte (buildPlan, frameAt, Hilfsfunktionen; unit-testbar) oberhalb eines Banner-Kommentars, dann eine dünne Browser-Hälfte (export default function (G, shadowRoot, config)), die nur verdrahtet und zeichnet. Siehe guides/architecture.md.
  3. Registrieren in default, Lieddaten in INIT lesen. G.on / G.off / G.onFrame nur innerhalb von default. G.map / forEach / lookup / iterator / relayout erst, nachdem INIT ausgelöst wurde (ein INIT-Handler oder spätere Callbacks wie render), niemals in default selbst. Abonnieren Sie G.on(G.TYPE.TICK, render) für die Wiedergabe; G.onFrame({ render, reset }) deckt SEEK/PLAY/PAUSE/RESIZE und UNINIT ab.
  4. Aufräumen mit G.dispose / G.listen. Ein von default zurückgegebener Wert wird ignoriert. Geben Sie WebGL (forceContextLoss), Listener, Timer, Kamera frei.
  5. Farben leben in CSS, nicht in c.v. Helle Werte auf :host, dunkle Überschreibungen in [data-bs-theme=dark] { }; Canvas liest sie mit der g-lib cssColors zurück. Beide Themen müssen bewusst gestaltet sein.
  6. Nie selbst implementieren, was g-lib bereits bietet (clamp, lerp, Easing, deterministischer RNG, Canvas-Fitting, Federn, Textlayout, Pools …). Importieren Sie über den exakten Tag-Pin; prüfen Sie pitfalls/dont-hand-roll.md und spec/g-lib.md, bevor Sie eigene Helfer schreiben.
  7. Lesbarkeit vor Effekt. Die aktive Silbe ist in Hell und Dunkel, auf dem Telefon und Laptop, für lange Zeilen, CJK, RTL und Myanmar lesbar. Große Blitze bleiben unter 3 Hz (guides/accessibility.md).
  8. Wenig typisierte Optionen. c und cSchema sind einfache Literale; jede Option bewirkt etwas Sichtbares.

Arbeitsablauf (mit den Repo-Tools)

  1. Brief. Schreiben Sie den Design-Brief aus guides/design-brief.md: ein starkes, physikalisches Bild; der Mechanismus; welche Ereignisse was antreiben (die Sync-Map); Struktur (Strophe/Refrain/Beat); Lesbarkeitsplan; Optionen; Fallstricke. Wählen Sie das Backend mit seiner Auswahltabelle. Lehnen Sie Ideen ab, die nicht lesbar bleiben können.
  2. Gerüst. npm run new -- <name> --backend canvas2d|svg|dom|three (oder kopieren Sie templates/<backend>.yaml von Hand und ersetzen Sie __NAME__).
  3. Einmal lesen: spec/module-format.md, pitfalls/general.md, den Abschnitt Ihres Backends in pitfalls/backends.md, pitfalls/dont-hand-roll.md. Öffnen Sie alles andere nur über die Routing-Tabelle unten.
  4. Implementieren Sie zuerst die reine Hälfte (Zeit zu Zustand), dann die dünne Browser-Hälfte.
  5. Validieren. npm run validate -- anims/<file>.yaml. Beheben Sie jeden Fehler; begründen Sie jede Warnung im Docblock oder beheben Sie sie.
  6. Prüfen. npm run check -- anims/<file>.yaml lädt 13 randständige Lieder kopflos, bewertet die Konformitätstabelle und schreibt PNGs nach out/<name>/. Öffnen Sie die PNGs (Telefon/Laptop, hell/dunkel). Eine grüne Tabelle über einem hässlichen oder unleserlichen Frame ist ein Fehlschlag. Ein WARN in einer Zeile zur Sprung-Reinheit bedeutet, dass das Bild von der Historie abhängt: Beheben Sie es oder begründen Sie es im Docblock (eine bewusste Simulation).
  7. Vorschau (optional). npm run preview -- anims/<file>.yaml zum Abspielen, Spulen, Thema wechseln und Optionen anpassen.
  8. Überprüfen Sie gegen guides/quality-rubric.md (20 Fragen), liefern Sie dann die eine YAML-Datei und einen kurzen Bericht (Dateiname, finale Prüftabelle, Entscheidungen, die der Brief offen ließ, was Sie bewusst nicht getan haben). Liefern Sie out/ oder das Testgestell nicht aus.

Arbeitsablauf ohne Tools (Chat-Modelle, keine Shell)

Überspringen Sie die Schritte 2, 5-7. Beginnen Sie mit dem passenden Template-Text, schreiben Sie den Design-Brief in Ihrer Überlegung, gehen Sie dann pitfalls/general.md, den Backend-Abschnitt und die 20-Fragen-Rubrik Zeile für Zeile gegen Ihren eigenen Code durch, bevor Sie antworten. Geben Sie nur die YAML-Datei in einem umschlossenen Block aus, und erwähnen Sie, welche Rubrikpunkte Sie ohne Ausführung nicht überprüfen konnten (Sprung-Reinheit, Themenwechsel, Größenänderung).

Routing-Tabelle: Ein Dokument nur öffnen, wenn sein Auslöser zutrifft

Wenn Sie im Begriff sind …Lesen Sie …
zu entscheiden, was gebaut wird; ein Backend zu wählenguides/design-brief.md
die Datei zu strukturieren; Phasen zu benennen; den Docblock zu schreibenguides/architecture.md
einen G.*-Aufruf, ein Ereignis-Option oder eine ID-Bereich zu verwendenspec/events.md, spec/event-shapes.md, spec/g.d.ts
Optionen, Farben, Theming hinzuzufügenspec/config.md
Zeit-Dienstprogramme, Textmessung, Canvas-Helfer, Lebenszyklus zu verwendenspec/utilities.md
Zeilen in Anzeigezeilen zu teilen, Text umzubrechenspec/relayout.md, guides/patterns-text.md
Aktionen an Silben/Zeilen/Beats auszulösen; Vorerzeugung; Pause; Federnguides/patterns-timing.md
Text anzupassen, hervorzuheben oder zu gestalten; nicht-lateinische Schriftenguides/patterns-text.md
Rendering-Code zu schreiben (DOM, SVG, Canvas, three, Simulation, Ebenen)guides/patterns-render.md, pitfalls/backends.md
Kamera, Gelände, Schwärme, Packen, prozedurale 3Dguides/techniques.md, pitfalls/techniques.md
ein Foto oder eine Kamera zu verwendenspec/image-input.md
ein Spiel zu bauen (autoPlay false, Punktzahl, Zustände)guides/games.md
einen g-lib-Helfer zu verwendenspec/g-lib.md
unsicher bezüglich Blitzen, Bewegung, Kontrast zu seinguides/accessibility.md
fertig zu werdenguides/quality-rubric.md

Minimale Form (dies nicht ausliefern; mit einer Vorlage beginnen)

"t": |-
  c
"j": |
  import { hash01 } from 'https://cdn.jsdelivr.net/gh/prjctg/[email protected]/index.js';
  /* [email protected]: <eine Zeile>
   * 1. <nummerierte Design-Aussage: der Mechanismus und die verlockende falsche Antwort, die er ablehnt> */
  export function frameAt(plan, t) { /* rein */ }
  /* Browser-Hälfte. Alles oberhalb dieser Zeile ist absichtlich DOM-frei. */
  export default function (G, shadowRoot, config) {
    const cfg = G.cfg(config, { channel: G.cfg.int(0) });
    let ready = false;
    const render = (t) => { if (!ready) return; /* frameAt(plan, t) zeichnen */ };
    G.on(G.TYPE.INIT, () => { ready = true; /* G.map(...) ist hier gültig */ });
    G.on(G.TYPE.TICK, render);
    G.onFrame({ render, reset() { ready = false; } });
  }
  export const c = { v: { fadeMs: 150 }, m: [{ s: 'fadeMs', t: 'fadeMs' }] };
  export const cSchema = [{ i: 'fadeMs', n: 'Verblassen (ms)', t: 'int', mn: 0, mx: 2000 }];
"s": |
  :host { display: block; --ink: var(--inkColor, #111); }
  [data-bs-theme=dark] { --ink: var(--inkColor, #eee); }
"h": |
  <canvas id="c"></canvas>

j, s, h enthalten Rohtext (niemals in Backticks oder Anführungszeichen). t verwendet |-. Der Dateiname trägt die Version; bearbeiten Sie niemals eine veröffentlichte Version an Ort und Stelle.

Verwandte Skills