Communitygithub.com

natureco-official/natureco-cli

Für jede Anfrage zum Erstellen, Bearbeiten, Animieren oder Rendern eines Videos, einer Animation oder einer Bewegungsgrafik – Trailer, Erklärvideo, Untertitelclip, Titelbild, Overlay oder jede andere Komposition. HyperFrames rendert Videos aus HTML; dies ist die Einstiegsfähigkeit 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-Bereichsfähigkeiten. Daher sollte diese zuerst gelesen werden, bevor eine andere Video- oder Animationsfähigkeit verwendet wird, anstatt einen Workflow zu erraten.

Was ist natureco-cli?

HyperFrames ist ein Framework, das Videos aus HTML rendert. Eine Komposition ist eine HTML-Datei, deren DOM mit `data-*`-Attributen das Timing deklariert, deren Animationsablauf suchbar ist und deren Medienwiedergabe vom Framework gesteuert wird. Diese Einstiegsfähigkeit (`natureco-official/natureco-cli`) fungiert als zentraler Router für jede Videoanfrage. Anstatt einen Workflow zu erraten, wird die Anfrage an die richtige spezialisierte Fähigkeit weitergeleitet, wie z.B. `/product-launch-video` für Produkt-Launch-Videos, `/faceless-explainer` für gesichtslose Erklärvideos oder `/embedded-captions` für Untertitel. Die Fähigkeit deckt alle gängigen Videoanwendungsfälle ab – von Marketing und Produktpräsentationen über GitHub-PRs bis hin zu Musik- und Slideshow-Formaten. Der Fokus liegt auf dem Routing der Anfrage zur richtigen Domain-Fähigkeit, die dann den spezifischen Autoren- oder Rendering-Workflow übernimmt.

Funktioniert mit✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/natureco-official/natureco-cli/tree/HEAD/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 das Timing deklariert, deren Animationsablauf suchbar ist und deren Medienwiedergabe vom Framework gesteuert wird. Der vollständige Autorenvertrag befindet sich in /hyperframes-core; lies ihn, bevor du Kompositions-HTML schreibst.

Unten: eine Fähigkeitsübersicht (die Domain-Fähigkeiten, die bei Bedarf geladen werden) und der Intent-Router (wähle einen Workflow für jede "Mach mir ein Video"-Anfrage).

Fähigkeitsübersicht – die Domain-Fähigkeiten

Atomare Fähigkeiten, die du bei Bedarf lädst – keine vollständigen Video-Workflows. Für "Mach mir ein Video" verwende den Intent-Router unten.

Du möchtest…Fähigkeit
Eine HTML-Komposition erstellen/bearbeiten – der data-*-Vertrag, Clips, Spuren, Unterkompositionen, Variablen/hyperframes-core
Animieren – atomare Bewegung, Szenenentwürfe, Übergänge, Laufzeit-Adapter (GSAP / Lottie / Three.js / Anime.js / CSS / WAAPI / TypeGPU)/hyperframes-animation
Kreative Leitung – frame.md / design.md, Paletten, Typografie, Erzählung, Taktplanung, audio-reaktiv/hyperframes-creative
Medien – TTS-Sprachausgabe, Hintergrundmusik, Transkription, Hintergrundentfernung, Untertitel/hyperframes-media
Medienauflösung – BGM, SFX, Bilder, Icons aus dem HeyGen-Katalog finden + einfrieren in .media/ mit Manifest-Verfolgung/media-use
CLI-Entwicklungs-Schleife – init, lint, validieren, inspizieren, Vorschau, rendern, veröffentlichen, diagnostizieren/hyperframes-cli
Registry-Blöcke / Komponenten installieren (hyperframes add)/hyperframes-registry

Intent-Routing – wähle einen Workflow

Dieser Abschnitt kennt nur die übergeordneten Workflows; er lädt weder ihre internen Referenzen noch die oben genannten Domain-Fähigkeiten.

Vor dem Routing – bestätige 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 ("Mach ein Video über unser Ding" ohne URL, Produkt, Thema oder Asset), frage vor dem Einstieg in einen Workflow nach – die Entscheidung für einen Workflow IST die Routing-Entscheidung. Höchstens zwei Fragen:

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

Standard-Spezifikationen – nenne sie, frage nicht (sie ändern nie die Route): Seitenverhältnis 16:9 (verwende 9:16 nur für ein benanntes vertikales Ziel – TikTok / Reels / Shorts); Sprachausgabe / Untertitel-Sprache = die des Benutzers. Der gewählte Workflow bestätigt seine eigenen Spezifikationen im ersten Schritt.

Workflow-Spickzettel

WorkflowVerwende ihn für
/product-launch-videoVermarktung / Einführung / Werbung für ein Produkt – von seiner URL, einer Kurzbeschreibung oder einem Skript (auch wenn die Site nur genannt wird)
/website-to-videoEine allgemeine Website in ein Video verwandeln – Site-Tour, Portfolio / Landing-Page-Präsentation, Social-Clip aus den visuellen Elementen der Site
/faceless-explainerErklärung eines Themas / Konzepts aus Text – kein Produkt, keine URL; jedes Bild ist KI-erfunden
/pr-to-videoEin GitHub-PR / Code-Änderung → Changelog / Feature-Enthüllung / Fix / Refactoring-Erklärvideo
/embedded-captionsHinzufügen von Untertiteln / Untertitel zu einem vorhandenen Talking-Head-Video (Aufnahmen unberührt)
/talking-head-recutEin vorhandenes Talking-Head-Video mit designten Grafik-Overlays verpacken – Lower-Thirds, Daten-Callouts, kinetische Titel, Pull-Quotes
/motion-graphicsEine kurze, unbesprochene, designorientierte Bewegungsgrafik – Kinetischer Text, ein Stat / Diagramm-Treffer, ein Logo-Sting, ein Lower-Third-Overlay
/music-to-videoEin Musiktitel → ein takt-synchronisiertes Video – Lyric-Video, Diashow oder kinetischer Trailer; die Musik bestimmt das Tempo (optionale Benutzerbilder/-videos auf das Takt-Raster geschnitten)
/slideshowEine Präsentation / Pitch-Deck / interaktives Deck – einzelne Folien, Fragmente, Verzweigungen, Hotspots; Ausgabe ist ein navigierbares Deck, kein gerendertes Video
/general-videoAlles andere – längere oder mehrtaktige Stücke, eine statische Schleife / ein Poster, eine benutzerdefinierte Komposition
/remotion-to-hyperframesPortierung einer bestehenden Remotion (React)-Komposition zu HyperFrames (Migration, keine Erstellung)

Abgrenzung (nur dort, wo Verwechslungsgefahr besteht):

  • Bewegungsorientiert & unbesprochen (unter ~10s, die Bewegung ist die Botschaft) → /motion-graphics, unabhängig von der Eingabe.
  • Eine URL oder ein Skript – vermarktet ein bestimmtes Produkt (auch wenn nur die Site genannt wird) → /product-launch-video; eine allgemeine Nicht-Produkt-Site → /website-to-video; ein GitHub-PR-Link → /pr-to-video; erklärt ein Konzept ohne Produkt / Site → /faceless-explainer. Wirklich unklar ob Produkt-vs-Thema oder Launch-vs-allgemeine-Site → eine Frage stellen.
  • Vorhandenes Filmmaterial – einfache gesprochene Untertitel → /embedded-captions; designte Overlay-Karten → /talking-head-recut. Keines bearbeitet das Filmmaterial selbst (Neutiming / Neufärbung / Neurahmen / Neuordnung / Audio ist NLE-Bearbeitung – nicht im Rahmen).
  • Ein Musiktitel ist die Eingabe (eine Audiodatei oder ein Video, aus dem Audio extrahiert werden soll) mit keiner Sprachausgabe → /music-to-video – die Beats/Energie der Musik bestimmen das Tempo. (Besprochene Stücke bleiben beim oben passenden Workflow; /motion-graphics ist für kurze unbesprochene Bewegungen, die nicht musikgesteuert sind.)
  • Eine Präsentation / Pitch-Deck / interaktives Deck (einzelne Folien, Navigation, Präsentatormodus) → /slideshow – Ausgabe ist ein navigierbares Deck, kein gerendertes Video. Eine explizite "Diashow"-Anfrage geht direkt weiter; ein angrenzender Auslöser ("Deck / Folien / Präsentation / diese Seite konvertieren") lässt /slideshow bestätigen, dass es eine Diashow ist, bevor es erstellt wird, und wechselt bei Bedarf zum passenden Nicht-Diashow-Workflow.
  • Länge ist eine Orientierung, kein Hindernis – der Zweck wählt den Workflow; gehe nur zu /general-video, wenn das Stück deutlich länger als ~3 Min. ist oder ein statisches / Schleifen / benutzerdefiniertes Format hat.

Wenn der passende Workflow nicht installiert ist

Sobald du einen Workflow ausgewählt hast, überprüfe, ob er dir tatsächlich zur Verfügung steht. Wenn die passende Workflow-Fähigkeit nicht installiert ist, falle nicht zurück auf Raten – weise den Benutzer an, sie zuerst zu installieren:

  • Nur diesen Workflow: npx skills add heygen-com/hyperframes --skill <workflow-name> (z.B. --skill pr-to-video – einfacher Name, ohne führendes /).
  • Alle Workflows auf einmal: npx skills add heygen-com/hyperframes --all (Core + jeder Workflow, überspringt die Auswahl).

Nachdem er sie ausgeführt hat, lies die Fähigkeit des Workflows erneut und fahre fort.

Workflow-Details

/product-launch-video

  • Eingabe: Ein Produkt, das vermarktet wird – (a) eine Produkt-URL (mit Headless Chrome gecrawlt für Assets + Brand-Tokens), (b) ein Skript / eine Kurzbeschreibung, die die Site des Produkts auch ohne Link nennt (PLV löst sie auf + crawlt sie, es sei denn, der Benutzer lehnt ab) oder (c) ein Skript ohne ableitbare Site / "nicht scrapen" (No-Capture-Modus – wähle eine Stilvorlage, die Palette + Designsystem liefert). Ein bereitgestelltes Skript kann der wörtliche Voice-Over oder umstrukturiert pro Szene sein – PLV fragt nach.
  • Ausgabe: Produkt-Launch / SaaS-Promo als HyperFrames-Komposition → MP4. (Sweet Spot 30–90s).
  • Auslöser: "Launch-Video für X", "Promo für unsere Site", "Erkläre mein SaaS in einer Minute", "Verwandle mein Skript in einen 60s-Promo", "Text-Only-Launch-Video, nicht scrapen".

/website-to-video

  • Eingabe: Eine allgemeine Website / URL, die in ein Video verwandelt werden soll – wenn das Ziel ein Video der Site ist, kein Produkt-Launch. Mit Headless Chrome erfasst für echte Screenshots + Brand-Assets.
  • Ausgabe: eine Site-Tour / Portfolio / Landing-Page-Präsentation / Social-Clip, aufgebaut aus den eigenen visuellen Elementen der Site → MP4.
  • Auslöser: "Verwandle diese Website in ein Video", "Site-Tour von ", "Social-Clip von unserer Homepage", "Ich habe nur eine URL – mach etwas".

/faceless-explainer

  • Eingabe: Beliebiger Text – ein Thema, ein Artikel oder Notizen – der erklärt wird, wobei kein Produkt vermarktet und keine Site erfasst wird. (Abgezweigt von /product-launch-video; kein Headless Chrome.)
  • Ausgabe: Gesichtsloses Erklärvideo → MP4, jedes Bild KI-erfunden pro Szene (Typografie / abstrakt / Diagramm / Datenvisualisierung); wird mit dem pin-and-paper-Voreinstellung geliefert. (Sweet Spot 30–90s).
  • Auslöser: "Gesichtsloses Erklärvideo über X", "Erkläre, wie DNS als Video funktioniert", "Verwandle diesen Artikel in ein Erklärvideo", "Erklärvideo aus meinen Notizen".

/pr-to-video

  • Eingabe: Ein GitHub-Pull-Request – eine PR-URL, ein owner/repo#N-Verweis oder "dieser PR" – via gh-CLI gelesen (keine zu scrapende Site).
  • Ausgabe: Code-Änderungs-Erklärvideo (Changelog / Feature-Enthüllung / Fix / Refactoring) → MP4 – Diff-Highlights, Vorher/Nachher-, Dateibaum- + Auswirkungsszenen. ≤ (Sweet Spot 30–90s).
  • Auslöser: "Mach ein Video über diesen PR", "Verwandle PR #1187 in ein Changelog-Video", "Release-Notes-Video von github.com/org/repo/pull/123".

/embedded-captions

  • Eingabe: Ein vorhandenes Talking-Head-Video (MP4) zum Untertiteln – tatsächliches Filmmaterial, keine URL oder Kurzbeschreibung. Lokal transkribiert (Whisper, kein API-Schlüssel) und maskiert (RVM), sodass das Motiv Untertitel verdecken kann.
  • Ausgabe: dasselbe Filmmaterial unberührt, mit einer Untertitelebene – Standard (wörtliche Lower-Third-Schiene + ein eingebetteter Höhepunkt hinter dem Motiv) oder Kinematografisch (jeder Untertitel hinter dem Motiv zusammengesetzt). Jede Länge.
  • Auslöser: "Untertitel / Untertitel zu diesem Video hinzufügen", "Untertitel hinter dem Motiv", "Kinematografische Untertitel für meinen Clip".

/talking-head-recut

  • Eingabe: Ein vorhandenes Talking-Head / Interview / Podcast-Video (MP4), um es mit Bildschirmgrafiken zu verpacken – tatsächliches Filmmaterial. Lokal transkribiert (Whisper). Der Clip läuft vollständig darunter, unberührt.
  • Ausgabe: dasselbe Filmmaterial mit zeitgesteuerten Grafik-Overlay-Karten – kinetische Titel, Lower-Thirds, Daten-Callouts, Pull-Quotes, Seitenleisten, Bild-im-Bild – synchronisiert zum Transkript. Jede Länge.
  • Auslöser: "Verpacke dieses Video", "Füge Grafik-Overlays / Lower-Thirds / Daten-Callouts zu meinem Vortrag hinzu", "Verwandle dieses Interview in eine grafikverpackte Bearbeitung".

/motion-graphics

  • Eingabe: Eine kurze, designorientierte Bewegungsgrafik, bei der die Bewegung die Botschaft ist – typischerweise unter ~10s, keine Sprachausgabe. Genres: kinetische Typografie, ein Stat / Zahlen-Count-Up, ein Diagramm-Treffer, ein Logo-Sting, ein Lower-Third / Overlay oder ein suchgesteuerter Seiten- / Tweet- / Headline-Shot.
  • Ausgabe: eine kurze Bewegungsgrafik → MP4 oder ein transparentes Overlay (Alpha WebM / MOV) für ein Lower-Third / Callout.
  • Auslöser: "Ein 8s Logo-Sting", "Animiere diesen Stat", "Ein kinetischer Intro", "Verwandle diesen Tweet in eine Bewegungsgrafik", "Ein transparentes Lower-Third-Overlay".

/music-to-video

  • Eingabe: Ein Musiktitel – eine Audiodatei oder ein Video, aus dem Audio extrahiert werden soll – mit keiner Sprachausgabe und keinem Website-Capture. Optional vom Benutzer bereitgestellte Bilder / Videos zum Einweben. Der Titel wird einmal in eine deterministische Beat- / Energie-Karte (audiomap.json) analysiert, auf der das gesamte Video aufbaut.
  • Ausgabe: Eine takt-synchronisierte HyperFrames-Komposition → MP4, bei der die Musik das Tempo bestimmt. Typografie und Vorlagen sind der Boden (ein vollständiges Video benötigt null Assets); alle bereitgestellten Medien werden auf dasselbe Takt-Raster geschnitten (Beat-Cut / Ken-Burns). Das Genre – Lyric-Video, Diashow, kinetischer Promo – ergibt sich aus den per-Frame-Entscheidungen; die Pipeline verzweigt sich nie darauf.
  • Auslöser: "Mach ein Video für diesen Song", "Takt-synchronisiertes Video aus diesem Titel", "Lyric-Video", "Verwandle diese Musik in ein Video", "Musikvisualisierer / kinetischer Promo zu diesem Beat".

/slideshow

  • Eingabe: Eine Präsentation / Pitch-Deck / interaktives Deck zum Erstellen – eine Kurzbeschreibung, eine Gliederung oder eine vorhandene Seite, die in Folien umgewandelt werden soll. Keine Anfrage für ein gerendertes Video; wenn der Zweck mehrdeutig ist, bestätigt die Fähigkeit "Möchtest du dies als HyperFrames-Diashow?" vor dem Erstellen.
  • Ausgabe: Eine ausführbare HyperFrames-Komposition + eine JSON-Insel, die der SlideshowController des Players liest, um die GSAP-Zeitleiste in ein navigierbares Deck zu verwandeln – einzelne Folien, Fragment-Enthüllungen, Verzweigungssequenzen, Hotspot-Navigation, Präsentatormodus und Sprechernotizen. Das Ergebnis ist ein Deck, kein MP4.
  • Auslöser: "Mach ein Pitch-Deck / eine Präsentation / ein Slide-Deck", "Ein interaktives Deck", "Konvertiere diese Seite in Folien", "Eine Diashow mit Präsentatormodus".

/general-video

  • Eingabe: Alles, was nicht oben genannt ist – eine kreative Kurzbeschreibung, ein einzelnes Element zum Animieren, eine Bearbeitung einer Komposition, die du erstellst. Eingabe- und längenunabhängig.
  • Ausgabe: Eine HyperFrames-Komposition (jede Länge / jedes Format) über den ursprünglichen Ablauf: Designsystem → Prompt-Erweiterung → Plan → Layout-vor-Animation → Erstellung (Delegierung an die hyperframes-* Fähigkeiten) → Validierung…

Verwandte Skills