Communitygithub.com

lzcjsyr/Book2Video

Der universelle Fallback-Workflow zur Erstellung benutzerdefinierter HyperFrames-Videokompositionen beliebiger Länge oder Formate – längere oder mehrteilige Szenen, Marken-/Sizzle-Reels, Montagen, Titelcards, statische Loops und freie Kompositionen. Eingabe- und längenunabhängig. Falls ein spezialisierter Workflow eindeutig passt (vermarktetes Produkt, Website, Themen-Erklärvideo, GitHub-PR, vorhandenes Material, kurze Bewegungsgrafik oder Remotion-Port), diesen bevorzugen (siehe /hyperframes); diesen nur als allgemeinen Fallback verwenden, wenn keiner passt.

Was ist Book2Video?

Dieser Skill `lzcjsyr/Book2Video` stellt den generischen Fallback-Workflow für die HyperFrames-Videoproduktion dar. Er wird eingesetzt, wenn kein spezialisierter Workflow (wie z.B. für Produkt-Launch-Videos, Website-Erklärvideos oder GitHub-PR-Videos) auf die Eingabe zutrifft. Der Workflow ist Eingabe- und Längen-unabhängig und eignet sich für eine Vielzahl von Formaten, darunter längere narrative Stücke, Sizzle-Reels, Montagen, Titelcards und statische Loops. Der Skill zielt auf Entwickler und KI-Agenten-Nutzer ab, die auf HyperFrames aufbauen, und ist in mehrere Domänen unterteilt: `hyperframes-creative` für Design und Konzept, `hyperframes-animation` für Motion Design, `hyperframes-core` für den technischen Vertrag und `hyperframes-media` für Audio und Untertitel. Der Workflow beginnt mit der Etablierung eines Designsystems, gefolgt von der Konzeptentwicklung und einer Phasenplanung vor der eigentlichen Implementierung. Ein hartes Gate stellt sicher, dass vor dem Schreiben von HTML alle vier kritischen Elemente (visuelle Identität, Konzeptwinkel, Schriftwahl, Vordergrund-Dichte-Plan) vorliegen. Der Bau folgt einer strengen 'Layout vor Animation'-Methode, bei der zuerst der Endzustand als statisches HTML/CSS definiert wird, bevor Bewegungen hinzugefügt werden. Der Skill ist plattformunabhängig, da er auf HyperFrames als Ausführungsplattform setzt. Er integriert sich nahtlos in die anderen HyperFrames-Skills (CLI, Core, Creative, Animation, Media) und nutzt eine gemeinsame Audio-Engine, die Text-to-Speech, Hintergrundmusik und Soundeffekte über HeyGen oder fallback auf ElevenLabs/Lyria generiert. Die Ausgabe erfolgt über die HyperFrames-CLI.

Funktioniert mit~Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/lzcjsyr/Book2Video/tree/HEAD/skills/step4/general-video

In Ihrer bevorzugten KI fragen

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

Dokumentation

Mediennutzung: Vor dem Laden von Audio/Bildern /media-use aufrufen, um BGM/SFX/Bilder aus dem HeyGen-Katalog zu beziehen. Führe --adopt aus, um vorhandene Assets zu registrieren. Siehe Skill /media-use.

general-video – Allgemeiner Video-Workflow

Bestätige den Weg, bevor du baust. Dies ist der Fallback für die Erstellung benutzerdefinierter Kompositionen. Wenn die Eingabe eindeutig in einen spezialisierten Workflow passt, verwende diesen: Vermarktetes Produkt → /product-launch-video; allgemeine Website → /website-to-video; Themen-Erklärvideo → /faceless-explainer; GitHub-PR → /pr-to-video; vorhandenes Material → /embedded-captions · /talking-head-recut; kurze, unkommentierte Bewegungsgrafik → /motion-graphics; Remotion-Port → /remotion-to-hyperframes. Nicht im Scope: Live-Daten zur Renderzeit, NLE-artige Bearbeitung eines fertigen Videos, oder Produktion von Material, das HyperFrames nicht aufnehmen kann. Unsicher? Lies zuerst /hyperframes.

Baue genau das, was verlangt wurde. Eine Titelcard ist eine Titelcard – nicht eine Titelcard + drei unterstützende Szenen + Ambient-Musik + Untertitel. Wenn zusätzliche Szenen oder Elemente das Stück tatsächlich verbessern würden, schlage sie vor; füge sie nicht stillschweigend hinzu. Für kleine Änderungen (eine Farbe korrigieren, eine Dauer anpassen, ein Element hinzufügen) überspringe die Planungsschritte und gehe direkt zum Bau.

Vorgehen

Discovery – nur für offene Anfragen

Bei vagen, explorativen Anfragen ("Mach etwas für unsere Marke", "Ein cooler Intro") – verstehe die Absicht, bevor du Farben wählst:

  • Zielgruppe – Wer schaut zu? Entwickler / Führungskräfte / allgemeine Verbraucher?
  • Plattform – Wo wird es abgespielt? Social (15s) / Website-Hero / Produktdemo / intern?
  • Priorität – Was ist am wichtigsten? Bewegungsqualität / Inhaltsgenauigkeit / Markentreue / Geschwindigkeit?
  • Varianten – Ein bester Versuch oder 2-3 sinnvoll unterschiedliche Optionen (unterschiedliches Tempo, Energie oder Struktur – nicht nur Farbänderungen)?

Bei spezifischen Anfragen ("Füge eine Titelcard hinzu", "Korrigiere das Timing in Szene 3") überspringe die Discovery.

Schritt 1 – Designsystem → hyperframes-creative

Etabliere zuerst die visuelle Identität. Wenn das Projekt eine Design-Spezifikation hat, lese sie (Priorität frame.md → design.md → DESIGN.md; behandle sie als Markenwahrheit – exakte Farben, Schriftarten, Einschränkungen).

Wenn keine Spezifikation existiert, MUSST du SOWOHL hyperframes-creative/references/house-style.md ALS AUCH hyperframes-creative/references/video-composition.md lesen, bevor du eine Farbe oder Schriftart wählst. house-style.md gibt den Aufmacher "Interpretiere den Prompt / generiere echten Inhalt", die Lazy-Default-Liste und das Schichtenrezept; video-composition.md gibt die Video-Medium-Dichte / den Maßstab / die Vordergrund-Detaillierung (Datenbalken, Registriermarken, Monospace-Metadaten, "8-10 Elemente, zwei, die der Benutzer nicht verlangt hat"), die "produziert" von "generiert" unterscheidet. Nur eines zu lesen ist der häufigste Fehler – video-composition.md wird von Agenten am meisten übersprungen, und genau das verhindert flache, zentrierte, webseitenartige Ausgaben. Erfinde keine eigene Palette und überspringe diese; der Schritt in hyperframes-creative ist hier obligatorisch, kein optionaler Zweig. Von dort aus ziehe bei Bedarf auch einen benannten Stil/Stimmung → references/visual-styles.md, oder den interaktiven Picker → references/design-picker.md. Die Spezifikation/der Stil definiert die Marke, nicht die Kompositionsregeln.

Finde den Blickwinkel (vage Vorgabe, keine Spezifikation): Bevor du Farben wählst, schreibe EINEN Satz – was ruft dieser Name/dieses Wort/Thema hervor, und welche visuelle Welt (Metapher, Setting, Instrument, Motiv) drückt es aus? Z.B. ein Cybersicherheitstool → Tresortüren / Perimeterscanlinien / Schlossfallen; eine Meditations-App → Gezeiten, Atem, sanfte Lichtblüte. Lies die Bedeutung des Themas, nicht nur seine Buchstaben; wähle einen konkreten Blickwinkel über eine wörtliche Neugestaltung. Dies ist der günstige Ersatz für die Prompt-Erweiterung (Schritt 2) bei Einszenenstücken, bei denen die Erweiterung korrekterweise übersprungen wird – und es ist der Unterschied zwischen einem durchdachten Konzept und einem generischen Logo auf einem Farbverlauf.

Schritt 2 – Prompt-Erweiterung → hyperframes-creative

Führe dies für jede mehrszenige Komposition aus (überspringe für einszenige Stücke und triviale Bearbeitungen). Bette die Anfrage gegen die Design-Spezifikation + den Hausstil in ein konsistentes Zwischenformat ein, das nachgelagerte Arbeiten auf die gleiche Weise lesen. Siehe hyperframes-creative/references/prompt-expansion.md.

Schritt 3 – Plan

Denke auf hoher Ebene nach, bevor du HTML schreibst:

  1. Was – das Zuschauererlebnis: narrativer Bogen, Schlüsselmomente, emotionale Schläge.
  2. Struktur – wie viele Kompositionen, Unterkomposition vs. Inline, welche Spuren tragen Video / Audio / Overlays / Untertitel. Für die Entscheidung monolithische Einzeldatei vs. modulare Unterkomposition siehe hyperframes-core/references/composition-patterns.md § Zwei Architekturen (Faustregel: ≥3 harte Szenenschnitte oder eine wiederverwendete Szene → modularisieren; ein kurzes einszeniges Stück bleibt eine Datei).
  3. Rhythmus – benenne das Muster, bevor du es implementierst (z.B. schnell-schnell-LANGSAM-SHADER-halten); siehe hyperframes-creative/references/beat-direction.md.
  4. Timing – welche Clips treiben die Dauer, wo landen Übergänge, das Tempo.
  5. Layout – baue zuerst den Endzustand (siehe unten).
  6. Animieren – füge dann Bewegung über hyperframes-animation hinzu.

Layout vor Animation

Positioniere jedes Element dort, wo es in seinem sichtbarsten Moment sitzt – vollständig eingetreten, korrekt platziert, noch nicht austretend. Schreibe dies zuerst als statisches HTML + CSS. Noch kein GSAP.

Warum: Wenn du Elemente in ihrem animierten Startzustand positionierst (außerhalb des Bildschirms, auf 0 skaliert, Deckkraft 0) und dorthin tweenst, wo du denkst, dass sie landen, errätst du das endgültige Layout – Überlappungen bleiben bis zum Rendern unsichtbar. Baue zuerst den Endzustand, und du siehst und behebst Layoutprobleme, bevor du Bewegung hinzufügst.

  1. Identifiziere den Heldenframe für jede Szene – den Moment, in dem die meisten Elemente gleichzeitig sichtbar sind. Das ist das Layout, das du baust.
  2. Schreibe statisches CSS für diesen Frame. Der Inhaltscontainer muss die Szene mit Abstand füllen, nicht mit absoluten Offsets:
.scene-content {
  display: flex;
  flex-direction: column;
  justify-content: center;
  width: 100%;
  height: 100%;
  padding: 120px 160px; /* Abstand positioniert den Inhalt; füllt jede Szenengröße */
  gap: 24px;
  box-sizing: border-box;
}

Verwende niemals position: absolute; top: Npx auf einem Inhaltscontainer – er läuft über, wenn der Inhalt höher als der Platz ist. Reserviere absolute Positionierung für Dekorationen.

⚠ Das width/height: 100% oben funktioniert nur, wenn jeder Vorfahre eine aufgelöste Höhe hat. Der Root <div data-composition-id> und jeder Wrapper zwischen ihm und .scene-content müssen dimensioniert sein (position: relative; width: 1920px; height: 1080px auf dem Root – siehe hyperframes-core → "Root muss dimensioniert sein"). Überspringe dies, und der Flex-Container kollabiert auf ~0, Inhalt stapelt sich in der linken oberen Ecke, und das erste Zeichen wird bei x=0 abgeschnitten – während lint/inspect weiterhin 0 Probleme melden. Und behalte immer den padding (≥80px) auf .scene-content: Es ist der titelsichere Rand. Ersetze ihn niemals durch bloßes gap.

  1. Füge Auftritte hinzu – animiere VON außerhalb des Bildschirms/unsichtbar ZUR CSS-Position mit gsap.from() (in Unterkompositionen bevorzuge gsap.fromTo(), damit der Startzustand explizit ist; siehe hyperframes-core/references/sub-compositions.md). Die CSS-Position ist die Grundwahrheit; der Tween ist die Reise dorthin.
  2. Ausgänge werden durch Übergänge behandelt – gemäß den Szenenübergangsregeln in hyperframes-animation/transitions/ animiert nur die letzte Szene Elemente aus; zwischen den Szenen IST der Übergang der Ausgang.

Geteilter Raum über die Zeit: Wenn Element A austritt, bevor Element B im selben Bereich eintritt, benötigen beide dennoch korrekte CSS-Positionen für ihre jeweiligen Heldenframes – die Timeline-Reihenfolge verhindert ihr gleichzeitiges Vorhandensein, und der Layout-Schritt fängt versehentliche Überlappungen auf. Geschichtete Glühen/Schatten und Z-Stack-Tiefe sind beabsichtigte Überlappungen; der Schritt dient zum Auffangen unbeabsichtigter Kollisionen (zwei Überschriften übereinander, Inhalt, der aus dem Rahmen läuft).

Bau – Delegiere an die Domänen-Skills

Dies bildet die gesamte Oberfläche des Skills (siehe description) auf seine Referenzen ab – nicht abschließend; wenn eine Absicht nicht aufgeführt ist, leite sie durch hyperframes-creative (Look/Konzept), hyperframes-animation (Bewegung), hyperframes-core (Vertrag), hyperframes-media (Audio/Untertitel). Die erste Zeile ist ADDITIV – lies sie UND deine Absichtszeile, nicht das eine oder das andere.

Bauen…Lies zuerst (in Reihenfolge)
IMMER – jedes nicht-triviale Stück, zusätzlich zu deiner Absichtszeile untenhyperframes-creative/references/house-style.md + references/video-composition.md (auch in Schritt 1 / HARDES-TOR abgesichert; die "produziert, nicht generiert"-Vordergrund-Detaillierung)
Kinetische Typografie / Textlastighyperframes-animation/techniques.md (kinetischer Typ) + adapters/gsap-easing-and-stagger.md + rules/kinetic-beat-slam.md
Titelcard / Einblendung / Overlay / PiP / Text-hinter-Subjekthyperframes-creative/references/composition-patterns.md + (für den zentrierten/skalierten Rahmen) hyperframes-core → "Root muss dimensioniert sein"
Logo / Marken-Enthüllunghyperframes-animation/rules/svg-path-draw.md (einzeichnen) + rules/3d-text-depth-layers.md + rules/scale-swap-transition.md
Daten / Statistiken / Zahlenhyperframes-animation/rules/counting-dynamic-scale.md + rules/stat-bars-and-fills.md + hyperframes-creative/references/data-in-motion.md
Produkt / App / UI-Demohyperframes-animation/rules/3d-page-scroll.md + rules/cursor-click-ripple.md + rules/press-release-spring.md
Audio-reaktiv / Musikgetriebenhyperframes-creative/references/audio-reactive.md (Bänder vorher extrahieren; auf Bewegung abbilden)
Erzählerkommentar / Voiceover / Musik / SFX / Untertitelhyperframes-media → die gemeinsame Audio-Engine scripts/audio.mjs (ein Aufruf = TTS + BGM + SFX → audio_meta.json); Untertitel-Authoring + Asset-Platzierung über hyperframes-core. Siehe Audio unten.
Mehrszenig / Übergängehyperframes-animation/transitions/overview.md dann transitions/catalog.md (du bist nach dem Überblick nicht fertig – das GSAP-Rezept ist im Katalog)
Modular / Unterkompositionenhyperframes-core/references/composition-patterns.md + references/sub-compositions.md

Audio: eine Engine (TTS · BGM · SFX)

Nur wenn das Stück es erfordert (gemäß "baue genau das, was verlangt wurde" – keine Ambient-Musik auf einer Titelcard). Baue kein eigenes TTS oder beziehe eine Kopie von einem Anbieter: Schreibe ein neutrales audio_request.json und rufe die gemeinsame Engine in hyperframes-media auf. Sie degradiert automatisch bei einem Schalter – HeyGen-Anmeldedaten vorhanden → HeyGen TTS + Musik/SFX Abruf; nicht vorhanden → ElevenLabs/Kokoro TTS, Lyria/MusicGen BGM Generierung und die gebündelte SFX-Bibliothek. Vollständige Flag-Liste + Anforderungs-/Meta-Schema: der Kopfkommentar von hyperframes-media/scripts/audio.mjs.

// audio_request.json – eine Zeile pro erzähltem Segment; `id` ist deine (verknüpft audio_meta zurück)
{
  "lines": [
    { "id": "s1", "text": "Your opening line.", "sfx": ["whoosh"] },
    { "id": "s2", "text": "The next beat." },
  ],
  "bgm": { "query": "calm cinematic underscore" }, // "mode" weglassen → auto (abrufen, wenn HeyGen, sonst generieren); "none" zum Deaktivieren
}
# <MEDIA_DIR> = das installierte hyperframes-media-Skill-Verzeichnis (Geschwister dieses Skills)
node <MEDIA_DIR>/scripts/audio.mjs --request ./audio_request.json --hyperframes . --out ./audio_meta.json

Dann lese audio_meta.json: Binde jeden voices[].path + (bgm.path, sfx[]) als <audio>-Spuren ein und verwende voices[].words für Untertitel, alles gemäß hyperframes-core (Audiospuren + Untertitel-Authoring). Wenn BGM den Generierungspfad genommen hat (bgm_pending: true), führe vor dem endgültigen Rendern hyperframes-media/scripts/wait-bgm.mjs aus.

Ausgabe-Checkliste → hyperframes-cli

  • …

[truncated for translation]

Individual skills in this repo

This repo contains 6 individual skills — each has its own dedicated page.

lzcjsyr/Book2Video

将 PDF、EPUB、DOCX 等书籍或长文档一次性转成约 4 分钟的中文读书带货短视频口播稿,以情绪共鸣、观看留存和购买欲为核心,直接输出 Book2Video 后续流程可读取的 raw JSON。用户提到读书带货、图书推广、卖书口播、商品卡、走心书单视频、情绪型读书文案或要求生成可直接进入视频流水线的带货稿时使用。

lzcjsyr/Book2Video

将长书、长文档转成中文视频号读书解说稿;先抽取文本并建立可恢复覆盖台账,覆盖自检通过后再按入口定义的正文长度生成初稿、多轮修订和最终 raw JSON。

lzcjsyr/Book2Video

将长书、长文档、PDF、EPUB、读书资料、思想经典、社科著作、商业书或研究型长文转成更有传播感的中文视频号/抖音读书口播稿,并输出项目可用的 raw JSON。只要用户提到“读书解说”“拆书稿”“视频号口播”“把这本书做成短视频”“长文档转视频脚本”“生成标题/封面/金句/raw JSON”,都应使用此 skill。

lzcjsyr/Book2Video

Cody的公众号长文写作skill。当用户需要撰写公众号文章、写稿子、续写文章、根据素材产出长文时使用。触发词包括但不限于:写文章、写稿子、帮我写、续写、扩写、公众号文章、长文、出稿、按我的风格写。即使用户只是说"帮我把这个写成文章"或"用我的风格写一下",只要上下文涉及内容创作和公众号输出,都应该触发。也适用于用户丢过来一个PDF、brief、新闻链接、语音转文字或任何素材说"帮我写篇文章"的场景。不要用于短内容(小红书帖子、推特、朋友圈)或纯标题摘要生成。

lzcjsyr/Book2Video

将中短篇专业报告、公司财报、券商研报、招股书、宏观经济分析及含有较多表格和数据的PDF文档,转化为高品质、数据精准的中文视频号/抖音口播解说稿。只要用户提到“研报”、“财报”、“商业分析报告”或需要“解读数据”、“把报告/PDF做成短视频”,务必使用此 Skill。

lzcjsyr/Book2Video

简化版的文稿生成技能。能够直接读取图书/文档,提取核心论点,生成高品质、口语化的视频号/抖音读书解说文稿并输出标准 JSON 格式。

Verwandte Skills