Communitygithub.com

lhaovo/short-video-skills

Traduit un storyboard finalisé en deux listes directement exécutables : une liste d'actifs (quelles images préparer, leurs prompts) et une liste de génération (durée, mode, références et prompts pour chaque segment vidéo). Couvre la visualisation, la numérotation des actifs, la segmentation, la rédaction de prompts Seedance, la stratégie de la première image, la cohérence et le diagnostic des échecs.

Qu'est-ce que short-video-skills ?

Ce skill agit comme un traducteur entre un storyboard textuel et des listes de production exécutables pour la génération vidéo. Il prend en entrée un storyboard structuré (numéro de plan, durée, description, narration, texte à l'écran, fonction) et produit deux fichiers : une liste d'actifs (images, personnages, décors avec leurs prompts visuels) et une liste de génération (segments vidéo avec durée, mode, références et prompts vidéo complets). Le skill suit un processus en huit étapes : lecture et validation du storyboard, visualisation (détaillant le sujet, l'état, l'action, l'environnement, la lumière, le plan, l'angle et le mouvement de la caméra), extraction des actifs, segmentation, détermination de la première image, rédaction des prompts, génération des listes et auto-vérification. Il est conçu pour être utilisé avec les plateformes Seedance et autres modèles de génération vidéo compatibles, et repose sur un système de règles strictes (actifs avant prompts, un seul moment continu par prompt, utilisation de 'anchor phrases', priorité aux sources réelles pour les produits, syntaxe différenciée pour prompts vidéo et image). Le skill ne réécrit pas le contenu, ne juge pas sa qualité et ne génère pas directement des images ou vidéos ; il fournit des instructions précises et exécutables pour les étapes de production ultérieures.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/lhaovo/short-video-skills/tree/HEAD/short-video-prompt

Demander à votre IA préférée

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

Documentation

Plateforme de Prompts Vidéo

Un storyboard destiné à l'humain et une liste de génération opérationnelle sont séparés par une couche de traduction. Ce skill effectue cette traduction.

Il produit deux fichiers : la liste d'actifs (quelles images préparer) et la liste de génération (comment générer chaque segment).

Il ne choisit pas un nouveau sujet, ne modifie pas la structure du scénario et ne juge pas la qualité du contenu — cela relève des étapes en amont. Il ne génère pas non plus directement des images ou des vidéos ; il se contente de fournir des instructions directement exécutables.


I. Cinq Règles Fondamentales

Énoncées en premier, car chacune correspond à un type d'échec courant.

  1. Les actifs d'abord. Pas de numérotation, pas de prompts. Le même produit qui devient un autre dans le segment 3 est presque toujours dû à une absence d'actif défini.
  2. Un prompt vidéo décrit un seul moment continu. Si la scène change, on segmente ; ne laissez pas le modèle effectuer la transition lui-même.
  3. Utilisez les "anchor phrases" (phrases d'ancrage) pour désigner les sujets. Changer de synonyme équivaut à changer de personne.
  4. Déterminez d'abord la source du produit, puis rédigez le prompt. Si des images réelles ou des assets officiels existent, ils sont prioritaires ; sinon, la génération IA est possible, mais il faut verrouiller la géométrie, l'impression et le logo. Pour les plans contenant des paramètres ou des allégations d'efficacité, seules des images réelles ou des assets officiels peuvent être utilisés.
  5. Les prompts vidéo s'écrivent en positif ; les prompts d'image utilisent la section négative. Ces deux syntaxes ne sont pas interchangeables, voir references/prompt-syntax.md section 8.

II. Entrée

Obligatoire

ÉlémentProvenanceSi manquant
StoryboardSection 4 du plan de production, tableau court à six colonnes et détails plan par planPas de numéro de plan, durée numérique ou champ de transition clé, refusé, pas de supposition
Nom et spécifications du produitSection 1 du plan de productionSi non fourni, demander ; si impossible, marquer "À confirmer"
Modèle cibleSpécifié par l'utilisateur, par défaut SeedanceLe défaut suffit, pas besoin de demander

Le tableau court a six colonnes : Numéro de plan / Durée (s) / Ce que montre ce plan / Narration / Texte à l'écran / Fonction du plan. Les détails complètent par plan : perception du public, dépendances préalables, faits visibles clés, intention de durée.

Optionnel

  • Format d'image (défaut 9:16), résolution vidéo (défaut 480p, cohérente avec la génération)
  • Limites de durée par segment (défaut 5–10 secondes)
  • Audio activé ou non (doit être activé. La narration est lue par le modèle ; la désactiver supprime le son ; ne la désactiver que pour un plan vide confirmé)

Deux Points d'Entrée

Point d'entréeTraitement
Entrée standardLecture de la section 4 du plan, champs complets, passage direct à l'étape 3
Entrée relâchéeUn seul fichier markdown externe, d'abord le parser, afficher à l'utilisateur pour vérification, marquer les champs manquants

L'analyse relâchée doit indiquer explicitement "Ceci est une analyse dégradée, veuillez vérifier". Une erreur silencieuse est plus problématique qu'une erreur signalée.


III. Huit Étapes

1 Lire le tableau → 2 Visualiser → 3 Extraire les actifs → 4 Segmenter → 5 Première image → 6 Composer les prompts → 7 Sortir les listes → 8 Auto-vérification

Étape 1 · Lire le tableau

Faire correspondre le tableau court et les détails plan par plan par numéro de plan, et mémoriser les informations sur le produit. Cette étape est un simple diagnostic, pas une création. Si le skill de planification est installé, exécuter son script scripts/check_plan.py --plan <chemin du plan> ; en installation autonome, vérifier plan par plan selon la liste des champs d'entrée. Si un ancien tableau à cinq colonnes manque le champ de transition, le rétrograder pour le compléter.

Trois vérifications :

  • Numéros de plans consécutifs, durée positive
  • Durée de chaque plan : 2–6 secondes (marquer les dépassements)
  • Le storyboard a "Ce que montre ce plan", pas seulement la narration

Étape 2 · Visualisation

C'est la seule étape créative de tout le skill, et la plus souvent sautée.

Le storyboard fournit une description de contenu ("Expliquer pourquoi l'extérieur est chaud et l'intérieur froid"), le prompt a besoin d'une image. Chaque segment doit compléter les champs suivants :

ÉlémentQuestionExemple
SujetQu'y a-t-il dans l'imageUne boîte à lunch en céramique blanche, couvercle ouvert
ÉtatQuel est l'état actuel du sujetCouvercle ouvert, boîte posée sur la table
ActionQui fait quoi, une seule actionUne cuillère pique au centre
EnvironnementOù, qu'est-ce qui est autourBureau, micro-ondes en arrière-plan
LumièreD'où vient la lumière, température de couleurLumière blanche chaude du dessus, lumière latérale gauche de la fenêtre
PlanQuelle est l'échelle de l'imageGros plan
Position/CadreOù est la caméra par rapport au sujetHauteur de la table, 30 degrés avant côté
Mouvement de caméraComment ça bouge (choisir un seul)Plan fixe, zoom lent

Aucun champ ne doit être omis. Chaque segment doit écrire explicitement le sujet, l'état, l'action, l'environnement, la lumière, le plan, la position/cadre et le mouvement de caméra ; si clairement inapplicable, expliquer la raison. Si un champ manque, le combler d'abord ; si impossible, poser une question à l'utilisateur — ne pas l'omettre en l'écrivant dans le prompt, sinon le modèle inventera.

Les "faits visibles clés" et les "dépendances préalables" du storyboard doivent être indiqués dans la liste de génération : s'il s'agit d'un état visible de la première image ou d'une action se produisant dans le segment vidéo. Les actions procédurales ne peuvent pas exiger qu'une seule première image montre simultanément le début, le milieu et la fin.

Étape 3 · Extraire les actifs

Selon references/assets.md, faire quatre choses : numéroter, séparer, déterminer la source, sortir le tableau global.

  • Préfixes de numérotation : PR Produit / SC Scène / CH Personnage / SP Accessoire
  • Critère d'inclusion dans la liste : cité par deux segments ou plus, ou nécessite une identité cohérente
  • Trois niveaux de source : Images réelles / Assets officiels (si disponibles), Génération IA (si non, verrouiller la géométrie et l'impression), À compléter

Étape 4 · Segmentation

Prendre l'intersection de trois contraintes :

  1. Durée du segment ≥ nombre de mots de la narration ÷ 4 mots/s (le modèle lit environ 4–5 mots/s en chinois, on prend le plus bas)
  2. Segment unique : 5–10 secondes (limite du modèle voir prompt-syntax.md)
  3. Une action par segment

La règle 1 utilise 4 plutôt que 6.5 pour une raison : le modèle n'accélère pas sa lecture ; il saute directement la deuxième moitié de la phrase. Un segment coupé avec une vitesse optimiste produira des phrases manquantes, ce qui est bien plus problématique que de faire un segment supplémentaire.

Limite de 36 mots par segment pour la narration. Si dépassé, diviser le segment, ne pas comprimer le texte.

Pour les plans très longs, utiliser Extension + Image de transition : décrire clairement l'état de l'image de fin du segment précédent, pas écrire "Faire suite au segment précédent".

Étape 5 · Première image

Tous les segments n'ont pas besoin d'une première image. Juger selon la sensibilité :

Doit avoir une première imagePeut être généré directement texte-à-vidéo
Gros plan produit, action de manipulation, apparition d'un logo ou de textePlans vides, d'ambiance, de transition, effets de lumière pure

Les images de première image sont écrites avec des prompts d'image (voir assets.md section 4, sept modules), avec le principe "produit réel en base + scène générée par IA".

Étape 6 · Composition des prompts

Écrire selon les six blocs de references/prompt-syntax.md :

[Style/Format] → [Références d'assets] → [Sujet verrouillé] → [Chronologie] → [Narration/Son] → [Contraintes de qualité]

Quatre éléments obligatoires : un seul mouvement de caméra, liste Motion:, texe de la narration (tel quel, sans modification), No subtitles.

Le cinquième bloc contient désormais la narration elle-même — il n'y a plus d'étape de doublage séparée, le texte est confié au modèle par ce bloc. La colonne Narration du storyboard doit être recopiée mot pour mot, sans ajout de marqueurs de ton, sans parenthèses, sans changer un mot. Si on le fait, les sous-titres ne correspondront pas à l'audio.

Étape 7 · Sortie des listes

Remplir les deux modèles, les placer dans le répertoire spécifié en amont (par défaut 02-liste-actifs.md, 03-liste-generation.md).

Étape 8 · Auto-vérification

Exécuter six vérifications, avec script si possible :

python scripts/check_gen_list.py --dir <répertoire de production>

Code de sortie : 0 Réussi / 2 Élément fatal / 3 Fichier illisible.


IV. Deux Productions

Liste d'Actifs (02-liste-actifs.md)

Tableau à six colonnes, suivi pour chaque ligne du prompt d'image :

NuméroTypeUsageSourceSegments de référenceStatut
  • Type : Produit principal / Détail produit / Scène / Personnage / Accessoire
  • Source : Images réelles ou assets officiels / Génération IA / À compléter
  • Statut : Disponible / À générer / À filmer

Liste de Génération (03-liste-generation.md)

Un tableau de synthèse + le texte complet du prompt pour chaque segment (le prompt étant trop long, le mettre dans un tableau deviendrait illisible) :

| Segment | Plan n° | Durée | Mode | Actifs de référence | Première image | Post-production | Nombre de candidats | Dépendances préalables / Faits clés | |---|---:|---:|---|---|---|---:|---|

  • Mode : Première et dernière images / Image de référence / Texte-à-vidéo
  • Première image : S01_f01 ou "Aucun"
  • Nombre de candidats : Recommandé 2–4

Les trois types de mode sont destinés au choix en aval, tous les modèles ne les supportent pas. Actuellement, KIE Seedance ne propose que les modes Texte-à-vidéo, Première image, et Première et dernière images ; le mode Image de référence doit être rétrogradé en mode Première image — les règles de rétrogradation sont dans short-video-generate, ce skill se contente d'écrire tel quel, sans adapter la formulation au modèle.

Sous le tableau, pour chaque segment, utiliser ### S01 · Plans 1–2 | 8s | Première et dernière images pour donner les huit champs visuels et le prompt complet, ainsi que la source de la première image, les dépendances préalables et les éléments de post-production.

Les modèles sont dans assets/.


V. Neuf Points d'Auto-Vérification

#VérificationQue faire si échoue
1Chaque segment a un numéro de plan, pas de segment supplémentaireRevenir à l'étape 4 et re-segmenter
2La durée totale des segments ne diffère pas de plus d'une seconde de la durée totale du storyboardAjuster la durée du segment, ne pas modifier le storyboard
3Tous les numéros d'actifs référencés dans la liste sont définis dans la liste d'actifsAjouter la définition ou supprimer la référence
4Mode principal unique : ne pas mélanger Première et dernière images et Image de référenceUniformiser pour toute la séquence
5La source des plans de produit est indiquée ; les plans avec allégation utilisent des images réelles ou des assets officielsRevenir à l'étape 3 et modifier la source
6Chaque prompt vidéo a : un seul mouvement de caméra, Motion:, No subtitlesAjouter pour chaque
7Pour les segments avec narration, le bloc de narration et la colonne Narration du storyboard sont mot pour mot identiquesComparer segment par segment, même une faute de ponctuation doit être corrigée
8Tous les champs visuels sont présentsF7 vérifie uniquement si le tableau des "champs visuels" du segment existe, est complet et a des valeurs ; il ne déduit pas à partir de mots-clés prosaïques ; le sujet, l'état, l'action, l'environnement, la lumière, le plan, la position/cadre, le mouvement de caméra, les dépendances/faits visibles doivent tous être remplis ; pour les cas non applicables, expliquer la raison
9Les dépendances sont transmisesLes dépendances préalables et les faits visibles clés du storyboard ont été mappés à la première image ou à l'action dans le segment

Le vérificateur F8 confirme seulement que le tableau de synthèse a rempli la colonne "Dépendances préalables / Faits clés" pour chaque segment, il ne prouve pas que le contenu est réellement présenté par la première image ou l'action dans le segment ; G2 nécessite toujours une vérification manuelle de la cartographie segment par segment.

La formulation précise de la règle 4 : Les modes Première et dernière images et Image de référence sont mutuellement exclusifs ; le mode Texte-à-vidéo est réservé aux plans sans sujet principal. Si on mélange les deux modes principaux pour les plans de produit, les résultats ne correspondront pas.

La règle 7 est nouvelle et la plus facile à oublier. La méthode est simple mais efficace : mettre côte à côte la colonne Narration du storyboard et le bloc de narration dans la liste, et comparer mot à mot. Si on change une ponctuation ou un synonyme, les sous-titres doivent être modifiés en conséquence, et les sous-titres sont faits à l'étape S4 — à ce moment-là, il est trop tard.

En profiter pour vérifier deux choses : si le texte de chaque segment dépasse 36 mots (sinon le modèle sautera la lecture) et s'il contient des marqueurs de ton comme (rire) [excité] (le modèle les lira).


VI. Limites

  • Ne pas réorganiser le contenu : les numéros de plan, l'ordre, la durée viennent de l'amont ; ce skill ne modifie pas la structure
  • Ne pas juger la qualité du contenu : le choix du sujet, l'accroche, la structure relèvent de l'amont
  • Ne pas générer directement : ne fournit que des listes et des prompts ; la génération d'images est confiée à short-video-assets, la génération de vidéos à short-video-generate
  • Ne pas garantir une réussite immédiate : la génération est probabiliste ; ce skill garantit seulement une probabilité plus élevée pour "celle qui mérite d'être testée"
  • Ne pas copier les paramètres du modèle : les paramètres du modèle changent ; le skill fournit des principes et une formulation générale, les valeurs spécifiques se réfèrent à la documentation officielle

VII. Références

FichierQuand le lire
references/prompt-syntax.mdLors de la rédaction des prompts vidéo ; pour ajuster le mouvement de caméra, la chronologie, les références d'assets
references/assets.mdLors de l'extraction des actifs, de la rédaction des prompts pour les images d'actifs et les premières images
references/consistency.mdEn cas de décalage entre segments, déformation du produit, visage qui ne correspond pas
references/troubleshooting.mdLorsqu'un segment ne se génère pas après plusieurs tentatives

Modèles : assets/asset-list-template.md, assets/gen-list-template.md Vérification : scripts/check_gen_list.py

Individual skills in this repo

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

lhaovo/short-video-skills

为视频生成准备可用的图——把资产清单变成能直接喂给图生视频的素材:排生产顺序、定资产级别、出候选图、做一致性验收、按编号落盘、回写清单状态。支持三种来源:实拍、AI 生成、官方素材,不强制实拍。当用户说「准备素材」「出资产图」「首帧图」「角色三视图」「产品图跑一下」「资产对不上」「这条要哪些图」时使用。只管把图做出来并验收,不写分镜,不直接生成视频。

lhaovo/short-video-skills

一条短视频从策划到发布的流程总控:建制作目录、依次走「剧本分镜 → 提示词 → 生成 → 交付 → 发布」五段、每段设门禁、记录流程状态、支持跨会话续做。当用户要开一条新片子、问「下一步做什么」、想接着做某条没做完的片子、要把分镜变成提示词、要整理素材与成片、要准备发布包时使用。本技能只规定流程、目录与产物标准,不重复各环节的写作规范。

lhaovo/short-video-skills

把已过 G2 的生成清单落成真实视频片段——按段建 KIE Seedance 任务、轮询、下载、媒体体检、抽帧质检、听声核台词,并把每段的状态与请求指纹写进生成台账。三种模式互斥(文生 / 首帧图生 / 首尾帧图生)。旁白由模型直接念,台词照稿写进提示词,不走独立 TTS 配音。当用户提到视频生成、出片段、跑 Seedance、首帧图生、首尾帧、原生音频、台词念错、任务查询、片段下载、生成失败重试时使用。只管「把已定的画面和台词变成成段素材」,不重新设计视觉、不改台词文本、不做字幕、不做剪辑。

lhaovo/short-video-skills

把「我想拍点什么」变成一条想清楚的片子——先定主题(出 5 个候选、标明类型、给出推荐与淘汰理由),再定结构与分段剧本,最后切成镜头级内容分镜。支持两种入口:一句话主题(需要发散选题)与已有拆解剧本(跳过选题,先问复刻需求与复刻强度再判定改写)。当用户提到选题、定主题、短视频策划、写剧本、写大纲、分镜、镜头脚本、不知道拍什么、内容怎么排、科普干货、剧情软广、钩子怎么写、复刻别人的剧本时使用。只管内容层(讲什么、怎么讲),不碰执行层;内置的内容红线只防明显自伤,不替代合规审查。

Skills associés