Communitygithub.com

visual-story

Motion-Erklärfilme, interaktive Systemkarten und Pitch-Decks mit Mikro-Animationen, Übergängen und PDF-Export – alles auf einer großen Leinwand mit Kamera und Szenen.

Was ist visual-story?

Dieses Skill ermöglicht es einem KI-Agenten, komplexe Sachverhalte visuell darzustellen – sei es als Bewegtbild-Erklärfilm auf einer großen Leinwand mit Kamera und Szenen, als interaktive Karte eines Prozesses oder Systems, oder als Pitch-Deck mit Mikro-Animationen und Übergängen. Es unterstützt die Erstellung von MP4-Exporten, responsiven Versionen für Mobilgeräte sowie die Veröffentlichung auf einer Subdomain mit QR-Code. Der Workflow folgt einem strengen Batch-Prozess: Zieldefinition, Skript als Tabelle, Pilot-Szene zur Stilfindung, dann 2–3 Szenen pro Batch mit Freigabe durch den Benutzer. Das Skill ist für Claude Code und ähnliche agentenbasierte Entwicklungsumgebungen konzipiert und wird durch eine Reihe von Referenzdokumenten (z. B. taste.md, qa.md) gesteuert. Es vermeidet typische Fallstricke wie erstes großes Build ohne Zwischenfeedback, zu kleine Darstellungen oder überflüssige Dekoration – stattdessen setzt es auf klare, große visuelle Ideen und minimalen Text.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/smixs/visual-story/tree/HEAD

In Ihrer bevorzugten KI fragen

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

Dokumentation

Visual Story

Zeige komplexe Dinge als Bilder: Szene für Szene, groß, mit Bewegung, die erklärt statt dekoriert. Der Bildtext sagt, was passiert; die Leinwand zeigt es. Jeder Arbeitsschritt endet mit einem Frame, der dem Benutzer gezeigt wird, und seinem „Ja".

Was du erstellst → welches Runbook du öffnest

AufgabeRunbook
Erklärfilm: Szenen auf einer Leinwand, Kamera, Bildtexte, „Gesamtschema"-Kartereferences/motion-film.md
Interaktive Karte eines Prozesses oder Systems mit Sprüngen zwischen Knotenreferences/scheme.md
Pitch-Deck mit Mikro-Animationen, Übergängen und PDFreferences/deck.md
Gewöhnlicher Konferenzvortrag ohne Szenen oder Kameranutze einen normalen Slide-Deck-Workflow; übernimm die Lesbarkeitsregeln aus deck.md
Export eines Films oder einer Karte als MP4references/video-export.md
Telefon- und Tablet-Versionenreferences/responsive.md
Veröffentlichung, Subdomain, Passwort, QRreferences/publish.md
Sichtprüfung: Frames per URL, Kontaktbögen, Checklistereferences/qa.md
Geschmacksregeln: Farbe, Schrift, Bewegung, Dichtereferences/taste.md
Referenzarbeiten zum Kopieren eines Grundgerüstsreferences/examples.md

Öffne taste.md, examples.md und das passende Runbook vor der ersten Codezeile. Öffne qa.md vor der ersten Vorführung.

Film oder Karte? Ein Film ist eine Geschichte, die sich in der Zeit entfaltet, bei der ein Moderator den Betrachter Szene für Szene führt. Eine Karte ist ein großes Bild, das der Betrachter selbst erkundet. „Animiere unseren Prozess für ein Webinar" ist ein Film; „eine Karte des Systems zum Herumstöbern" ist eine Karte. Bei Unsicherheit stelle eine Frage.

Arbeitsreihenfolge für jede Art

  1. Ziel in den Worten des Benutzers, dann Fragen. Frage in einem Batch, empfohlene Option zuerst, und nur das, was noch unbeantwortet ist: welche Referenz („wie beim letzten Mal"), wie es gezeigt wird (Vortragender klickt / automatische Wiedergabe / Video / PDF), Stil (die Website des Produkts), Sprache, Daten (fiktiv oder Quelle des Benutzers), Abgabefrist und Bildschirm.
  2. Skript als Tabelle – Szenen oder Slides: Nummer, Titel, eine Zeile Bedeutung. Warte auf „Ja".
  3. Pilot. Eine Szene oder ein oder zwei Slides, vollständig fertig: Bild, Bewegung, Bildtexte. Frames → zeigen → auf „Ja" warten. Grund: Ein im Pilot gefundener Stil überträgt sich auf alles andere; ein in Szene zwölf gefundener Stil bedeutet, zwölf Szenen neu zu machen.
  4. Batches von 2–3 Szenen oder Slides; zeige jeden Batch und warte.
  5. Gesamtes zusammenbauen: Navigation, Gesamtschema-Karte oder Übersicht, Telefonlayouts, Veröffentlichung, QR, PDF oder Video – was auch immer bestellt wurde.

Abgabefrist unter einem Tag: ein Pilot und ein „Ja", der Rest in einem Batch; überprüfe Frames nur in den Größen, in denen es gezeigt wird (der Ausstrahlungsbildschirm, plus Telefone, wenn Zuschauer einen Link erhalten).

Bevor du „fertig" sagst

  • Frames in den Zeigegrößen aus qa.md sind aufgenommen und überprüft; Fehler in einem Batch behoben.
  • Falls Veröffentlichung bestellt wurde: die Live-Adresse bedient die neue Version (?v=NN), und zbarimg liest den QR.
  • Falls ein PDF oder Video bestellt wurde: die Datei ist geöffnet und Seite für Seite bzw. Frame für Frame überprüft.
  • Der Benutzer hat das Ergebnis gesehen und geantwortet.
  • Deine eigenen Screenshots, Browser-Sitzungen und Server-Prozesse sind bereinigt (Server per pid stoppen).

Häufige Fehler

  • Alles bauen und am Ende zeigen → der Benutzer ändert den Stil und du machst alles neu. Arbeite in Batches.
  • Dinge klein machen: zehn winzige Labels auf der Leinwand statt einer großen Idee. Bild groß, Code klein.
  • Mit Text absichern: „Mit Telefon scannen" unter einem QR, „noch im Wachstum", „du kannst…", Gestenhinweise. Was auch ohne Worte klar ist, bleibt ohne Worte.
  • Dekorieren: farbige Akzentstreifen an Kartenecken, Blinken, „einfach hübsch". Bewegung erklärt einen Übergang oder sie existiert nicht.
  • Eine Zahl ohne ein Nomen und einen Moment („8 Karten") → der Betrachter weiß nicht, worauf er schaut.
  • Überprüfung „durch Lesen des Codes" ohne einen Frame in der richtigen Größe → auf einem Telefon fällt alles auseinander.

Verwandte Skills