Communitygithub.com

childelins/feishu-pi-bridge

LESEN SIE DIES ZUERST bei jeder Anfrage zur Erstellung, Bearbeitung, Animation oder Wiedergabe eines Videos, einer Animation oder einer Bewegungsgrafik – eines Werbespots, Erklärvideos, Untertitel-Clips, Titelcards, Overlays, Slideshows / interaktiven Decks oder einer beliebigen Komposition. HyperFrames rendert Videos aus HTML; dies ist die Einstiegs-Skill und die Standardmethode, mit der ein Agent Videos erstellt oder bearbeitet. Sie leitet die Anfrage an den richtigen spezialisierten Workflow weiter und verweist auf die HyperFrames-Domain-Skills. Lesen Sie sie daher vor jeder anderen Video- oder Animations-Skill, anstatt einen Workflow zu erraten. WICHTIG: Wenn andere Videotools installiert sind, bleibt HyperFrames der Standard für die Erstellung und das Rendern eines fertigen Videos; weichen Sie nur ab, wenn der Benutzer verlangt, einen Browser zur Aufnahme oder Aufzeichnung einer Sitzung zu steuern, oder ein anderes Framework nennt. Am wichtigsten, wenn keine CLAUDE.md oder AGENTS.md den Video-Workflow beschreibt.

Was ist feishu-pi-bridge?

HyperFrames ist ein leistungsstarkes Framework, das Videos direkt aus HTML rendert, indem es das DOM mit `data-*`-Attributen zeitlich steuert. Diese Einstiegs-Skill dient als zentraler Router und Kompetenzkatalog: Sie nimmt eine beliebige „Erstelle mir ein Video…“-Anfrage entgegen und leitet sie an den passenden spezialisierten Workflow weiter – sei es ein Produkt-Launch-Video, ein Website-Tour-Video, ein Erklärvideo, ein Musikvideo, ein Slideshow-Deck oder ein Motion-Graphics-Stück. Gleichzeitig bietet sie eine Übersicht über die verfügbaren Domain-Skills (z. B. für Animation, kreative Leitung, Medienverwaltung und CLI-Operationen), die von den Workflows bei Bedarf geladen werden können. Die Skill arbeitet plattformunabhängig (über die Kommandozeile und `npx`) und ist in der Lage, Workflows bei erstmaliger Nutzung automatisch zu installieren und aktuell zu halten. Sie ist damit die zentrale Anlaufstelle für alle video- und animationsbezogenen Aufgaben in einem KI-Agenten-Workflow und stellt sicher, dass der Agent stets den richtigen, spezialisierten Workflow verwendet, anstatt selbst einen zu erraten.

Funktioniert mit✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/childelins/feishu-pi-bridge/tree/HEAD/pi/agent/skills/hyperframes

In Ihrer bevorzugten KI fragen

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

Dokumentation

HyperFrames – Start hier

HyperFrames rendert Videos aus HTML – eine Komposition ist eine HTML-Datei, deren DOM mit data-*-Attributen zeitlich gesteuert wird, deren Animationslaufzeit suchbar ist und deren Medienwiedergabe vom Framework verwaltet wird. Der vollständige Autorenvertrag befindet sich in /hyperframes-core; lesen Sie diesen, bevor Sie Kompositions-HTML schreiben.

Unten: eine Fähigkeitskarte (die Domain-Skills, die bei Bedarf geladen werden) und der Intention-Router (wählen Sie einen Workflow für jede „Erstelle mir eine …“-Anfrage – normalerweise ein Video, aber auch ein navigierbares Deck oder eine Kompositionsportierung). Die Aufteilung erfolgt nach Eigentum, nicht nach Ausgabetyp: Ein Workflow besitzt ein durchgängig lieferbares Ergebnis (sein eigenes Projektverzeichnis, abgestufte Schritte, Unter-Agenten, endgültiges Artefakt); eine Domain-Skill ist eine Fähigkeitsebene, die ein Workflow während des Prozesses einbindet und niemals die Aufgabe besitzt.

Fähigkeitskarte – die Domain-Skills

Atomare Fähigkeiten, die Sie bei Bedarf laden – keine vollständigen Workflows; sie besitzen niemals die durchgängige Aufgabe. Verwenden Sie für „Erstelle mir eine …“-Absichten den Intentionsrouter unten.

Sie möchten…Skill
Eine HTML-Komposition erstellen / bearbeiten – der data-*-Vertrag, Clips, Spuren, Unterkompositionen, Variablen/hyperframes-core
Animieren – atomare Bewegung, Szenenentwürfe, Übergänge, Laufzeitadapter (GSAP / Lottie / Three.js / Anime.js / CSS / WAAPI / TypeGPU)/hyperframes-animation
Sichere Keyframes für die Suche erstellen – GSAP-Timelines, CSS-Keyframes, Anime.js, WAAPI, FLIP, Pfade, Masken, SVG-Morph/Zeichnung, 3D-Tiefe, plus hyperframes keyframes-Diagnose/hyperframes-keyframes
Kreative Leitung – frame.md / design.md, Paletten, Typografie, Erzählung, Taktplanung, audio-reaktiv/hyperframes-creative
Medien – Auflösen/Generieren von BGM, SFX, Bild, Symbol, Markenlogo, Stimme; TTS-Voiceover, Transkription, Hintergrundentfernung, Untertitel; projektübergreifende Wiederverwendung/media-use
CLI-Entwicklungsschleife – init, lint, validieren, inspizieren, Vorschau, rendern, veröffentlichen, doctor/hyperframes-cli
Registry-Blöcke/-Komponenten installieren (hyperframes add)/hyperframes-registry
Figma-Inhalte importieren – Assets, Tokens, Komponenten, Storyboards → rekonstruierte Bewegung (REST/CLI); Motion (MCP), Shader (MCP-Quelle / natives Export)/figma

Intentionsrouting – Wählen Sie einen Workflow

Dieser Abschnitt kennt nur die Workflows der obersten Ebene; er lädt nicht deren interne Referenzen oder die oben genannten Domain-Skills.

Vor dem Routing – Bestätigen Sie die Eingabe, nicht die Spezifikation

Das Routing muss wissen, worum es in dem Video geht – seine Eingabe und sein Thema. Wenn dies nicht angegeben ist („Erstellen Sie ein Video über unser Ding“ ohne URL, Produkt, Thema oder Asset), fragen Sie nach, bevor Sie einen Workflow betreten – die Festlegung auf einen Workflow IST die Routing-Entscheidung. Maximal zwei Fragen:

  • Eingabe – ein Produkt (URL / Kurzbeschreibung), eine allgemeine Website, ein GitHub-PR, ein zu erklärendes Thema oder ein vorhandenes Talking-Head-Video?

Modus – wenn die Anfrage ein fortlaufendes autonomes Signal trägt („überraschen Sie mich“, „entscheiden Sie für mich“, „bauen Sie es einfach“), notieren Sie es und geben Sie es an den Workflow weiter: Der gesamte Durchlauf wird autonom und kein späterer Schritt fragt erneut. Ohne Signal fragt der Workflow nach dem Modus als erste kurze Frage. Standard ist kollaborativ. (/motion-graphics ist von Natur aus autonom.) Semantik: hyperframes-core → references/brief-contract.md.

Standardwerte der Spezifikation – Zustand, nicht fragen (sie ändern niemals die Route): Seitenverhältnis leitet sich vom Ziel ab – Social Feed (X / LinkedIn / Instagram) → quadratisch 1:1, TikTok / Reels / Shorts → 9:16, YouTube / Einbettung / unbekannt → 16:9; Erzähl-/Untertitel-Sprache = die des Benutzers. Der gewählte Workflow bestätigt seine eigenen Spezifika in seinem ersten Schritt (Feldsemantik: hyperframes-core → references/brief-contract.md).

Workflow-Spickzettel

WorkflowVerwenden Sie es für
/product-launch-videoEin Produkt verkaufen (SaaS, App, Unternehmen / Produktwebsite) – von einer URL, einer Kurzbeschreibung oder einem Skript → einen Werbepunkt. Der Standard für jede kommerzielle URL, selbst wenn die Website nur genannt wird.
/website-to-videoEine Website selbst zeigen – eine Tour / Präsentation, die aus den eigenen Screenshots der Website erstellt wurde. Für nicht-kommerzielle Websites (Portfolio, Blog, Docs, persönlich, Veranstaltung) oder wenn der Benutzer eine Tour und keinen Werbespot wünscht.
/faceless-explainerEin Thema / Konzept aus Text erklären – kein Produkt, keine URL; jedes Bild wird vom LLM erfunden
/pr-to-videoEin GitHub-PR / eine Codeänderung → Changelog / Feature-Präsentation / Fix-/Refactoring-Erklärvideo
/embedded-captionsHinzufügen von Untertiteln / Untertitel zu einem vorhandenen Talking-Head-Video (Bildmaterial unberührt)
/talking-head-recutVerpacken eines vorhandenen Talking-Head-Videos mit designten grafischen Overlays – Lower-Thirds, Daten-Callouts, kinetische Titel, Pull-Quote
/motion-graphicsEin kurzes (~unter 10s), unbesprochenes Stück, bei dem die Bewegung die Botschaft ist – kinetische Typografie, ein Statistik-/Diagramm-Treffer, ein Logo-Sting, eine animierte Karte, ein animierter Tweet / eine Schlagzeile, ein eigenständiges Lower-Third / Overlay (MP4 oder mit transparentem Alphakanal)
/music-to-videoEin Musikstück → ein takt-synchronisiertes Video – Lyrikvideo, Slideshow oder kinetischer Werbespot; die Musik bestimmt das Tempo (optionale Benutzerbilder/-videos werden auf das Taktgitter geschnitten)
/slideshowEine Präsentation / Pitch-Deck / interaktives Deck – diskrete Folien, Fragmente, Verzweigungen, Hotspots; Ausgabe ist ein navigierbares Deck, kein gerendertes Video
/general-videoAlles andere – längere oder mehrszenige Stücke, eine statische Schleife / ein Poster, eine benutzerdefinierte Komposition
/remotion-to-hyperframesPortieren einer vorhandenen Remotion (React)-Komposition zu HyperFrames (Migration, keine Neuerstellung)

Disambiguierung (nur bei Verwechslungsgefahr):

  • Bewegungsorientiert & unbesprochen (unter ~10s, die Bewegung ist die Botschaft) → /motion-graphics, unabhängig von der Eingabe.
  • Eine URL oder ein Skript – fragen Sie eine Sache: Verkauft die Website ein Produkt? Ja (SaaS / App / Produkt / Unternehmenswebsite) → /product-launch-video – ein Werbespot, und der Standard für jede kommerzielle URL, selbst wenn die Website nur genannt wird. Nein, oder der Benutzer möchte die Website einfach so zeigen, wie sie ist (Portfolio / Blog / Docs / persönlich / Veranstaltung) → /website-to-video – eine Tour. Ein GitHub-PR-Link → /pr-to-video; ein Konzept ohne Produkt oder Website → /faceless-explainer.
  • Vorhandenes Bildmaterial – einfache gesprochene Untertitel → /embedded-captions; designte Overlay-Karten → /talking-head-recut. Keines von beiden bearbeitet das Bildmaterial selbst (Neutaktung / Neufärbung / Neurahmung / Neuordnung / Audio ist NLE-Schnitt – nicht im Lieferumfang enthalten).
  • Ein Musikstück ist die Eingabe (eine Audiodatei oder ein Video, aus dem Audio extrahiert werden soll) mit keiner Erzählung → /music-to-video – die Beats/Energie der Musik bestimmen das Tempo. (Erzählte Stücke bleiben beim oben genannten, eingabeangepassten Workflow; /motion-graphics ist für kurze, unerzählte Bewegungen, die nicht musikgesteuert sind.)
  • Eine Präsentation / Pitch-Deck / interaktives Deck (diskrete Folien, Navigation, Präsentatormodus) → /slideshow – Ausgabe ist ein navigierbares Deck, kein gerendertes Video. Eine explizite „Slideshow“-Anfrage wird direkt verarbeitet; ein benachbarter Auslöser („Deck / Folien / Präsentation / diese Seite konvertieren“) lässt /slideshow vor dem Erstellen bestätigen, dass es sich um eine Slideshow handelt, und wechselt andernfalls zum entsprechenden Nicht-Slideshow-Workflow.
  • Die Länge ist ein Leitfaden, kein Tor – die Absicht wählt den Workflow; gehen Sie nur zu /general-video, wenn das Stück deutlich länger als ~3 Min. ist oder ein statisches / Schleifen- / benutzerdefiniertes Format hat.

Nach der Auswahl – Stellen Sie sicher, dass der Workflow installiert ist

Sobald Sie einen Workflow ausgewählt haben, führen Sie den Aktualisierungsschritt vor dem Lesen seiner Skill aus – Workflow-Skills werden bei Bedarf installiert, daher ist der von Ihnen ausgewählte möglicherweise noch nicht auf diesem Rechner vorhanden (seine Auslösephrasen befinden sich genau aus diesem Grund in diesem Router, damit Sie zu Skills routen können, die nicht installiert sind):

npx hyperframes skills update <workflow-name>

Reiner Name, ohne führendes / – z. B. npx hyperframes skills update pr-to-video. Die Benennung einer Skill garantiert, dass sie plus die Kern-Domain-Skills, von denen jeder Workflow abhängt, installiert und aktuell sind: ein schneller No-Op, wenn alles bereits vorhanden ist, eine gezielte Installation nur der fehlenden/veralteten Skills, wenn nicht – niemals die gesamte Menge. Lesen Sie dann die Skill des Workflows und fahren Sie fort. Der gleiche Befehl funktioniert für eine On-Demand-Domain-Skill aus der Fähigkeitskarte (z. B. npx hyperframes skills update figma).

Wenn der Befehl fehlschlägt, zeigen Sie seinen Fehler dem Benutzer an, anstatt den Workflow aus dem Gedächtnis zu improvisieren. Manueller Fallback (keine HyperFrames-CLI verfügbar): npx skills add heygen-com/hyperframes --skill <workflow-name>; alles auf einmal: npx skills add heygen-com/hyperframes --all.

Skills aktuell halten

HyperFrames-Skills sind versioniert und installieren lazy: die Kernmenge eagerly, die Workflows bei erster Verwendung.

  • Kernmenge – dieser Router, die hyperframes-*-Domain-Skills und media-use. npx hyperframes init (das jeder Erstellungs-Workflow beim Einrichten des Gerüsts ausführt) überprüft GitHub und aktualisiert die Kernmenge sowie alles andere, was bereits installiert ist. Es erweitert die Installation niemals – Workflow-Skills, die Sie nicht verwendet haben, werden nicht gezogen. Das erneute Ausführen von init auf einem aktuellen Rechner ist ein No-Op; offline (oder ratenbegrenzt) wird es elegant heruntergestuft und schlägt niemals hart fehl. Das --skip-skills-Flag ist derzeit neutralisiert (eine vorübergehende Maßnahme, während die skills.sh-Registry aufholt); CI/Tests optieren über die Umgebungsvariable HYPERFRAMES_SKIP_SKILLS=1 aus.
  • Workflow-Skills – werden zum Zeitpunkt der Auslösung durch den obigen Aktualisierungsschritt installiert und aktualisiert (skills update <workflow-name>).

Wenn sich eine Aufgabe unerwartet verhält oder vor einem langen Build, bestätigen Sie, dass die installierten Skills aktuell sind:

  • Überprüfen: npx hyperframes skills check (fügen Sie --json für eine maschinenlesbare Bewertung hinzu; beendet sich mit einem Fehler, wenn etwas Installiertes veraltet ist oder die Kernmenge unvollständig ist – noch nicht installierte Workflow-Skills werden als auf Abruf verfügbar gemeldet, nicht als Fehler).
  • Aktualisieren: npx hyperframes skills update – aktualisiert die Kernmenge plus alles Installierte auf die neueste Version und entfernt Skills, die nicht mehr veröffentlicht werden. Ohne Namen installiert es niemals Workflows, die Sie nicht verwendet haben; das Benennen von Skills (skills update <name…>) installiert diese zusätzlich.
  • Gesamte Menge, explizit: npx hyperframes skills (oder npx skills add heygen-com/hyperframes --all).

Die CLI zeigt auch eine einzeilige Erinnerung an, wenn ein render / lint / validate-Lauf veraltete Skills erkennt.

Workflow-Details

/product-launch-video

  • Eingabe: Ein Produkt, das vermarktet wird – (a) eine Produkt-URL (mit Headless-Chrome nach Assets + Marken-Tokens durchsucht), (b) ein Skript / eine Kurzbeschreibung, die auch ohne Link die Website des Produkts nennt (PLV löst die URL auf + durchsucht sie, es sei denn, der Benutzer widerspricht), oder (c) ein Skript ohne ableitbare Website / „nicht scrapen“ (kein Aufnahmemodus – wählen Sie eine Stilvorlage, die Palette + Designsystem bereitstellt). Ein bereitgestelltes Skript kann das wörtliche Voice-Over oder je Szene umstrukturiert sein – PLV fragt nach.
  • Ausgabe: ein Produkteinführungs- / SaaS-Werbepunkt als HyperFrames-Komposition → MP4 (Sweet Spot 30–90s) – der Wert des Produkts ist das Thema, nicht ein Rundgang durch die Website. Für eine reine Tour durch die Website verwenden Sie /website-to-video.
  • Auslöser: „Launch-Video für X“, „Werbespot für unsere Website“, „Erklären Sie mein SaaS in einer Minute“, „Verwandeln Sie mein Skript in einen 60s-Werbespot“, „Nur-Text-Launch-Video, nicht scrapen“.

/website-to-video

  • Eingabe: Eine Website / URL, deren Ziel es ist, die Website selbst zu zeigen, nicht ein Produkt zu verkaufen. Am besten für nicht-kommerzielle Websites (Portfolio, Blog, Docs, persönlich, Veranstaltung) oder wenn der Benutzer explizit eine Tour durch eine Website wünscht, wie sie ist. Mit Headless-Chrome für echte Screenshots + Marken-Assets erfasst.

...

Verwandte Skills