Communitygithub.com

datassthou64-source/blue-motion-kit

Die beiden Grundgesetze für jede HyperFrames-Bewegungsgrafik: (1) Bild zuerst, Text zweitens, und (2) jede genannte Entität im Voiceover erhält ein echtes, recherchiertes Asset auf dem Bildschirm. Anwendbar beim Erstellen oder Überarbeiten von Bewegungsgrafiken, Storyboards oder Beats auf Basis eines Voiceovers, wenn der Sprecher ein Unternehmen, Produkt, Tool, eine Website oder ein GitHub-Repo nennt, bei der Entscheidung, was auf dem Bildschirm erscheint, wenn ein Beat in Richtung Textkarten oder Aufzählungen abdriftet, oder beim Recherchieren von Logos, Produkt-UI oder Website-Aufnahmen. Gilt in jedem HyperFrames-Workflow.

Was ist blue-motion-kit?

Diese Skill-Anleitung definiert die zwei Grundgesetze für alle Bewegungsgrafiken in HyperFrames. Gesetz 1 besagt: Bild zuerst, Text zweitens – der visuelle Mechanismus muss die Bedeutung tragen; Text ist nur ein unterstützendes Etikett, das benennt, was der Betrachter bereits sieht. Gesetz 2 fordert, dass jede im Voiceover genannte Entität (Unternehmen, Produkt, Tool, Website, GitHub-Repo) ein echtes, recherchiertes Asset auf dem Bildschirm erhält, nicht nur den Namen als Text. Die Anleitung enthält detaillierte Anweisungen zur Recherche von Logos, Screenshots und anderen Assets mittels Tools wie fetch-logo.py und npx hyperframes capture, einschließlich einer Wertigkeitshierarchie und Vorgehen zur Vermeidung von Fehlern. Sie ist für alle HyperFrames-Workflows verbindlich und stellt sicher, dass jede Bewegungsgrafik visuell aussagekräftig und mit authentischen Quellen belegt ist. Die Skill wird durch SKILL.md implementiert und ist plattformunabhängig innerhalb der HyperFrames-Umgebung nutzbar.

Funktioniert mit✓Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/datassthou64-source/blue-motion-kit/tree/HEAD/.claude/skills/motion-visual-sourcing

In Ihrer bevorzugten KI fragen

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

Dokumentation

Bild zuerst. Text zweitens. Jeder Name erhält ein echtes Asset.

Zwei Gesetze. Sie gelten für jeden Beat und jeden Workflow.


Gesetz 1 — Bild zuerst, Text zweitens

Menschen lesen nicht. Sie überfliegen. Eine Bewegungsgrafik ist ein Bild, das sich bewegt, keine Folie mit Animation. Der Mechanismus trägt die Bedeutung; Wörter beschriften ihn nur.

Der Test, angewandt auf jeden Beat, bevor du ihn baust:

Lösche jedes Wort aus dem Bild. Kommt die Idee trotzdem an? Wenn nein, erfüllt die Visualisierung ihre Aufgabe noch nicht – repariere die Visualisierung, füge keine Wörter hinzu.

Text ist ein unterstützendes Element. Er benennt, was der Betrachter bereits sieht. Er trägt nie eine Aussage, die das Bild nicht bereits macht.

Tun

  • Zeige den Mechanismus in Bewegung: Route, Transformation, Füllung, Zählung, Sortierung, Konvergenz, Verzweigung.
  • Verwende echte Logos, echte Produkt-UI, echte Bildschirme als Belege.
  • Ein kurzes Etikett pro Hauptobjekt – 1–3 Wörter.
  • Eine Hauptzahl, nur wenn das Voiceover sie nennt.

Nicht tun

  • Das Voiceover auf den Bildschirm kleben. Untertitel maximal zwei Zeilen, niemals Absätze.
  • Eine Aufzählungsliste, eine Tagesordnungskarte oder eine Wand aus Textkarten bauen. Eine Liste ist ein Sternbild oder ein konvergierender Knotenpunkt, keine gestapelten Aufzählungspunkte.
  • Eine Textkarte verwenden, weil die Idee schwer zu visualisieren war. Das ist der Moment, härter an der Visualisierung zu arbeiten, nicht aufzugeben und zu tippen.
  • Zulassen, dass ein Etikett etwas aussagt, das der Mechanismus nicht zeigt.

Aufmerksamkeitsverhältnis: Budgetiere etwa 80 % deines Baueinsatzes für das bewegte Objekt und 20 % für den Text. Wenn du es andersherum ausgegeben hast, ist der Beat falsch.


Gesetz 2 — Jede genannte Entität erhält ein echtes, recherchiertes Asset

Wenn das Voiceover irgendetwas, das online existiert nennt – ein Unternehmen, ein Produkt, ein Tool, eine Website, ein GitHub-Repo, ein Modell, ein Framework – geh und hol das echte Objekt und bring es auf den Bildschirm.

Genannte Entitäten sind Beweise. Ein Zuschauer, der „Clay“ hört und das tatsächliche Clay-Marke sieht, glaubt dir. Ein Zuschauer, der „Clay“ hört und das Wort „Clay“ in Inter sieht, tut es nicht.

Zeichne niemals eine generische Box, erfinde ein Markenzeichen, approximiere ein Logo aus dem Gedächtnis oder lasse den Namen als Klartext stehen, wenn ein echtes Asset existiert.

Was zu recherchieren ist, in der Reihenfolge des Werts

Genannte EntitätHol dies
Ein Unternehmen oder ToolSein echtes farbiges Logo-Marke
Ein Produkt mit einer UIEinen echten Bildschirm dieser UI sowie das Logo
Eine WebsiteEine Aufnahme der tatsächlichen Site – npx hyperframes capture <url>
Ein GitHub-RepoDas Avatar/Marke des Repos sowie die README oder Repo-Oberfläche
Ein Modell / FrameworkDas Markenzeichen des Anbieters (Anthropic, OpenAI, …)
Eine PersonNur mit einem bereitgestellten Asset. Nicht das Foto von jemandem scrapen.

Wie zu recherchieren ist

Zuerst die eingefrorene Bibliothek prüfen. Verifizierte Marken befinden sich in library/assets/logos/ (Herkunftsnachweis in der dazugehörigen SOURCES.md. Nie erneut abrufen, was bereits eingefroren und geprüft ist).

Logos – verwende den Resolver, suche nicht von Hand:

cat > logos.txt <<'EOF'
clay      clay.com
anthropic wikipedia:Anthropic
linkedin  commons:LinkedIn icon
acme      https://acme.com/press/logo.svg
EOF
python3 KIT/.claude/skills/blue-motion/scripts/fetch-logo.py --manifest logos.txt <project>/assets/logos

Leiter: explizite URL → Wikipedia → Wikimedia Commons → das eigene App-Symbol der Site → simple-icons → Favicon. Bevorzuge die ersten vier; simple-icons ist monochrom und die meisten Hausstile wollen Vollfarbe.

Sites und Produktoberflächen – nimm die echte Seite auf:

npx hyperframes capture https://<site> --json --max-screenshots 12

Screenshots landen lokal als geschichtete Szenen mit heruntergeladenen Assets. Behandle einen Exit-Code ungleich Null, ok:false oder eine BLOCKED.md als harten Stopp – erschließe niemals das Design einer Marke aus einer Teilaufnahme.

Vor dem Bauen immer verifizieren

  • Öffne jedes zurückkommende Asset. Ein falsches Logo ist schlimmer als kein Logo.
  • Der Abrufer warnt unter 6 KB, und eine Commons-Suche kann einen Beinahe-Treffer zurückgeben (falsches Unternehmen, altes Markenzeichen, Fan-Art). Sieh es dir an.
  • Bevorzuge das aktuelle Markenzeichen. Unternehmen ändern ihr Branding; Wikipedia hinkt hinterher.
  • Zeichne die Herkunft auf. fetch-logo.py hängt automatisch an assets/logos/SOURCES.md an – behalte es bei.

Bleib lokal und legal

  • Kopiere jedes Asset in das eigene assets/-Verzeichnis des Clips. Kein CDN, kein Netzwerk zur Renderzeit, niemals.
  • Marken Dritter werden nominativ verwendet – um auf das besprochene Objekt zu verweisen. Gestalte kein Logo um, imitiere keine Unterstützung oder verwende ein Markenzeichen als eigenes Branding.
  • Wenn kein echtes Asset gefunden oder verifiziert werden kann, sag dies und verwende stattdessen die objektklassenbasierte Visualisierung. Erfinde kein Markenzeichen, um die Lücke zu füllen.

Wo dies im Workflow greift

  1. Auswahl der Quelle – für jedes Fenster notieren, welche Entitäten die Zeile nennt. Diese Liste ist das Abruf-Manifest. Ein Fenster, das eine Entität ohne geplantes Asset nennt, ist eine unvollständige Auswahl.
  2. Storyboard – jedes Bild gibt seine visuelle These und die benötigten echten Assets an. Wenn die These eines Bildes nur als Satz auf dem Bildschirm ausdrückbar ist, überdenke das Bild.
  3. Bau – Assets kommen in das assets/-Verzeichnis, lokal referenziert, visuell verifiziert.
  4. Überprüfung – kneife die Augen zusammen und betrachte die Momentaufnahme. Wenn du nur durch Lesen erkennen kannst, was der Beat bedeutet, ist Gesetz 1 gebrochen. Wenn eine genannte Marke als Klartext erscheint, ist Gesetz 2 gebrochen.

Hausstil gewinnt trotzdem

Diese Gesetze regeln, was auf den Bildschirm kommt. Wie es aussieht, ist in library/design.md: Quelle das echte Asset, dann inszeniere es im Hausstil (auf einer Platte, unter der Tiefpool-Vignette, in einer Glaskarte).

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

Verwandte Skills