Communitygithub.com

lzcjsyr/Book2Video

Workflow de repli pour créer des compositions vidéo HyperFrames personnalisées de toute longueur ou format — vidéos longues ou multi-scènes, bandes-annonces / sizzle reels, montages, cartes-titres, boucles statiques et compositions libres. Indépendant de l'entrée et de la durée. Si un workflow spécialisé correspond clairement à l'entrée (un produit commercialisé, un site web, un sujet explicatif, une PR GitHub, des images existantes, un court motion design, ou un portage Remotion), préférez-le (voir /hyperframes) ; n'utilisez celui-ci que comme repli général quand aucun ne convient.

Qu'est-ce que Book2Video ?

Ce skill sert de workflow de repli général pour la création de compositions vidéo personnalisées avec HyperFrames, couvrant les formats qui ne correspondent pas aux workflows spécialisés (comme les vidéos produit, les explications de site web ou les PR GitHub). Il est indépendant de l'entrée et de la durée, ce qui le rend adapté aux pièces longues ou multi-scènes, aux cartes-titres, aux boucles statiques ou aux montages libres. Le skill met l'accent sur un processus structuré : d'abord, établir une identité visuelle via `hyperframes-creative` (en lisant obligatoirement `house-style.md` et `video-composition.md` pour éviter les designs génériques), puis planifier la composition, le rythme et la mise en page avant l'animation. Il force à construire l'état final de la mise en page en CSS statique avant d'ajouter du mouvement avec GSAP, garantissant que les superpositions et collisions soient détectées tôt. Le skill intègre également un moteur audio unifié pour le TTS, la BGM et les SFX, avec une dégradation automatique selon la disponibilité des credentials HeyGen, et se termine par un appel à `hyperframes-cli` pour l'export. Les instructions de marquage dur (HARD-GATE) garantissent que l'identité visuelle, l'angle conceptuel, le choix de police et les règles de densité de premier plan sont tous en place avant toute écriture de code.

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

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

media-use : Avant de sourcer de l'audio/des images, appelez /media-use pour trouver BGM/SFX/images depuis le catalogue HeyGen. Exécutez d'abord --adopt pour enregistrer les assets existants. Voir le skill /media-use.

general-video — workflow vidéo général

Confirmez la route avant de construire. Ceci est le repli pour la création de compositions personnalisées. Si l'entrée correspond clairement à un workflow spécialisé, préférez-le : produit commercialisé → /product-launch-video ; site général → /website-to-video ; sujet explicatif → /faceless-explainer ; PR GitHub → /pr-to-video ; images existantes → /embedded-captions · /talking-head-recut ; court motion design sans narration → /motion-graphics ; portage Remotion → /remotion-to-hyperframes. Hors périmètre : données en direct / au moment du rendu, montage de type NLE d'une vidéo terminée, ou production d'images qu'HyperFrames ne peut pas capturer. Pas sûr ? Lisez /hyperframes d'abord.

Construisez exactement ce qui a été demandé. Une carte-titre est une carte-titre — pas une carte-titre + trois scènes de soutien + musique d'ambiance + sous-titres. Si des scènes ou éléments supplémentaires amélioreraient réellement la pièce, proposez-les ; ne les ajoutez pas en silence. Pour les petites modifications (corriger une couleur, ajuster une durée, ajouter un élément), sautez les étapes de planification et allez directement à la construction.

Approche

Découverte — uniquement pour les demandes ouvertes

Pour les demandes vagues et exploratoires (« faites quelque chose pour notre marque », « une intro cool ») — comprenez l'intention avant de choisir les couleurs :

  • Public — qui regarde ? développeurs / dirigeants / consommateurs généraux ?
  • Plateforme — où est-ce diffusé ? social (15s) / bannière de site web / démo produit / interne ?
  • Priorité — quelle est la chose la plus importante ? qualité du mouvement / précision du contenu / fidélité à la marque / rapidité ?
  • Variations — une seule meilleure prise, ou 2-3 options significativement différentes (rythme, énergie ou structure différents — pas seulement des changements de couleur) ?

Pour les demandes spécifiques (« ajoutez une carte-titre », « corrigez le timing de la scène 3 »), sautez la découverte.

Étape 1 — Système de design → hyperframes-creative

Établissez d'abord l'identité visuelle. Si le projet a un cahier des charges design, lisez-le (priorité frame.md → design.md → DESIGN.md ; traitez-le comme la vérité de la marque — couleurs, polices et contraintes exactes).

S'il n'y a pas de cahier des charges, vous DEVEZ lire LES DEUX hyperframes-creative/references/house-style.md ET hyperframes-creative/references/video-composition.md avant de choisir une couleur ou une police. house-style.md donne l'ouverture « interpréter le prompt / générer du contenu réel », la liste des valeurs par défaut paresseuses et la recette des couches ; video-composition.md donne la densité / échelle / détail du premier plan (barres de données, marques d'enregistrement, métadonnées monospace, « 8-10 éléments, dont deux que l'utilisateur n'a pas demandés ») qui distingue le « produit » du « généré ». Lire un seul est l'erreur la plus courante — video-composition.md est celui que les agents oublient, et c'est exactement celui qui empêche une sortie plate, centrée et ressemblant à une page web. Ne vous inventez pas une palette et ne les sautez pas ; entrer dans hyperframes-creative est obligatoire ici, pas une branche facultative. À partir de là, tirez également un style/ambiance nommé → references/visual-styles.md, ou le sélecteur interactif → references/design-picker.md, si nécessaire. Le cahier des charges/style définit la marque, pas les règles de composition.

Trouvez l'angle (brief vague, pas de cahier des charges) : avant de choisir les couleurs, écrivez UNE phrase — qu'est-ce que ce nom/mot/sujet évoque, et quel monde visuel (métaphore, décor, instrument, motif) l'exprime ? Par exemple, un outil de cybersécurité → portes de coffre / lignes de scan de périmètre / gâches de serrure ; une application de méditation → marée, souffle, éclosion lumineuse lente. Lisez le sens du sujet, pas seulement ses lettres ; choisissez un angle concret plutôt qu'un restylage littéral. C'est le substitut peu coûteux de l'expansion de prompt (Étape 2) pour les pièces à scène unique, où l'expansion est correctement sautée — et c'est la différence entre un concept designé et un logo générique sur un dégradé.

Étape 2 — Expansion du prompt → hyperframes-creative

Exécutez pour chaque composition multi-scènes (sautez pour les pièces à scène unique et les modifications triviales). Ancrez la demande par rapport au cahier des charges design + le style maison dans un intermédiaire cohérent que le travail en aval lit de la même manière. Voir hyperframes-creative/references/prompt-expansion.md.

Étape 3 — Planification

Avant d'écrire du HTML, réfléchissez à un haut niveau :

  1. Quoi — l'expérience du spectateur : arc narratif, moments clés, battements émotionnels.
  2. Structure — combien de compositions, sous-composition vs inline, quelles pistes portent la vidéo / l'audio / les superpositions / les sous-titres. Pour la décision fichier-monolithique-unique vs sous-composition modulaire, voir hyperframes-core/references/composition-patterns.md § Deux Architectures (règle empirique : ≥3 coupures de scène dures, ou toute scène réutilisée → modulariser ; une courte pièce à scène unique reste un seul fichier).
  3. Rythme — nommez le motif avant de l'implémenter (par ex. rapide-rapide-LENT-SHADER-tenu) ; voir hyperframes-creative/references/beat-direction.md.
  4. Timing — quels clips déterminent la durée, où atterrissent les transitions, le rythme.
  5. Mise en page — construisez d'abord l'état final (voir ci-dessous).
  6. Animer — puis ajoutez le mouvement via hyperframes-animation.

Mise en page avant animation

Positionnez chaque élément là où il se trouve à son moment le plus visible — complètement entré, correctement placé, pas encore en sortie. Écrivez cela comme HTML + CSS statique d'abord. Pas encore de GSAP.

Pourquoi : si vous positionnez les éléments à leur état de départ animé (hors écran, mis à l'échelle à 0, opacité 0) et que vous animez vers l'endroit où vous pensez qu'ils atterrissent, vous devinez la mise en page finale — les superpositions restent invisibles jusqu'au rendu. Construisez l'état final d'abord et vous voyez et corrigez les problèmes de mise en page avant d'ajouter du mouvement.

  1. Identifiez le plan héro de chaque scène — le moment où le plus d'éléments sont simultanément visibles. C'est la mise en page que vous construisez.
  2. Écrivez du CSS statique pour ce plan. Le conteneur de contenu doit remplir la scène avec un padding, pas des décalages absolus :
.scene-content {
  display: flex;
  flex-direction: column;
  justify-content: center;
  width: 100%;
  height: 100%;
  padding: 120px 160px; /* le padding positionne le contenu ; remplit toute taille de scène */
  gap: 24px;
  box-sizing: border-box;
}

N'utilisez jamais position: absolute; top: Npx sur un conteneur de contenu — il déborde quand le contenu est plus haut que l'espace. Réservez le positionnement absolu pour les éléments décoratifs.

⚠ Le width/height: 100% ci-dessus ne fonctionne que si chaque ancêtre a une hauteur résolue. La racine <div data-composition-id> et tout wrapper entre elle et .scene-content doivent être dimensionnés (position: relative; width: 1920px; height: 1080px sur la racine — voir hyperframes-core → « La racine doit être dimensionnée »). Sautez cela et le conteneur flex s'effondre à ~0, le contenu s'empile dans le coin supérieur gauche, et le premier glyphe est coupé à x=0 — tandis que lint/inspect signalent toujours 0 problèmes. Et gardez toujours le padding (≥80px) sur .scene-content : c'est la marge de sécurité du titre. Ne le remplacez jamais par un simple gap.

  1. Ajoutez les entrées — animez DEPUIS hors écran/invisible VERS la position CSS avec gsap.from() (dans les sous-compositions, préférez gsap.fromTo() pour que l'état de départ soit explicite ; voir hyperframes-core/references/sub-compositions.md). La position CSS est la vérité de base ; l'interpolation est le chemin vers elle.
  2. Les sorties sont gérées par les transitions — selon les règles de transition de scène dans hyperframes-animation/transitions/, seule la dernière scène anime les éléments vers l'extérieur ; entre les scènes, la transition EST la sortie.

Espace partagé dans le temps : si l'élément A sort avant que l'élément B n'entre dans la même zone, les deux ont toujours besoin de positions CSS correctes pour leurs plans héro respectifs — l'ordre de la timeline les empêche de coexister, et l'étape de mise en page rattrape les chevauchements accidentels. Les lueurs/ombres superposées et la profondeur en z-stack sont des chevauchements intentionnels ; l'étape vise à détecter les collisions non intentionnelles (deux titres l'un sur l'autre, contenu débordant de l'image).

Construction — déléguez aux skills de domaine

Ceci mappe la surface complète du skill (voir la description) à ses références — non exhaustif ; quand une intention n'est pas listée, acheminez via hyperframes-creative (apparence/concept), hyperframes-animation (mouvement), hyperframes-core (contrat), hyperframes-media (audio/sous-titres). La première ligne est ADDITIVE — lisez-la ET votre ligne d'intention, pas l'une ou l'autre.

Construction…Lire en premier (dans l'ordre)
TOUJOURS — toute pièce non triviale, en plus de votre ligne d'intention ci-dessoushyperframes-creative/references/house-style.md + references/video-composition.md (également exigé à l'Étape 1 / HARD-GATE ; le détail de premier plan « produit, pas généré »)
Typographie cinétique / textes en avanthyperframes-animation/techniques.md (type cinétique) + adapters/gsap-easing-and-stagger.md + rules/kinetic-beat-slam.md
Carte-titre / tiers inférieur / superposition / PiP / texte derrière le sujethyperframes-creative/references/composition-patterns.md + (pour le cadre centré/dimensionné) hyperframes-core → « La racine doit être dimensionnée »
Révélation de logo / marquehyperframes-animation/rules/svg-path-draw.md (dessin) + rules/3d-text-depth-layers.md + rules/scale-swap-transition.md
Données / statistiques / nombreshyperframes-animation/rules/counting-dynamic-scale.md + rules/stat-bars-and-fills.md + hyperframes-creative/references/data-in-motion.md
Démo produit / application / UIhyperframes-animation/rules/3d-page-scroll.md + rules/cursor-click-ripple.md + rules/press-release-spring.md
Audio-réactif / piloté par la musiquehyperframes-creative/references/audio-reactive.md (pré-extraire les bandes ; mapper au mouvement)
Narré / voix off / musique / SFX / sous-titreshyperframes-media → le moteur audio partagé scripts/audio.mjs (un appel = TTS + BGM + SFX → audio_meta.json) ; rédaction des sous-titres + placement des assets via hyperframes-core. Voir Audio ci-dessous.
Multi-scènes / transitionshyperframes-animation/transitions/overview.md puis transitions/catalog.md (vous n'avez pas fini après l'aperçu — la recette GSAP est dans le catalogue)
Modulaires / sous-compositionshyperframes-core/references/composition-patterns.md + references/sub-compositions.md

Audio : un seul moteur (TTS · BGM · SFX)

Uniquement quand la pièce l'exige (selon « construisez exactement ce qui a été demandé » — pas de musique d'ambiance sur une carte-titre). N'écrivez pas votre propre TTS et ne fournissez pas de copie vendeur : écrivez un audio_request.json neutre et appelez le moteur partagé dans hyperframes-media. Il se dégrade automatiquement selon un interrupteur : credential HeyGen présent → TTS HeyGen + récupération musique/SFX ; absent → TTS ElevenLabs/Kokoro, génération BGM Lyria/MusicGen et bibliothèque SFX fournie. Liste complète des drapeaux + schéma de demande/méta : le commentaire d'en-tête de hyperframes-media/scripts/audio.mjs.

// audio_request.json — une ligne par segment narré ; `id` est le vôtre (relie audio_meta)
{
  "lines": [
    { "id": "s1", "text": "Votre première ligne.", "sfx": ["whoosh"] },
    { "id": "s2", "text": "Le prochain battement." },
  ],
  "bgm": { "query": "calme cinématographique soutenu" }, // omettez "mode" → auto (récupère si HeyGen, sinon génère) ; "none" pour désactiver
}
# <MEDIA_DIR> = le répertoire du skill hyperframes-media installé (au même niveau que ce skill)
node <MEDIA_DIR>/scripts/audio.mjs --request ./audio_request.json --hyperframes . --out ./audio_meta.json

Ensuite, lisez audio_meta.json : montez chaque voices[].path + (bgm.path, sfx[]) comme pistes <audio> et utilisez voices[].words pour les sous-titres, le tout selon hyperframes-core (pistes audio + rédaction des sous-titres). Si BGM a pris le chemin de génération (bgm_pending: true), exécutez hyperframes-media/scripts/wait-bgm.mjs avant le rendu final.

Liste de contrôle de sortie → hyperframes-cli

... [tronqué pour la traduction]

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 格式。

Skills associés