Communitygithub.com

Akira Video

Point d'entrée et chef d'orchestre pour un projet de production vidéo IA ; lit ou crée le VIDEO.md, achemine les tâches vers les Skills vidéo canoniques en fonction du script, des assets réutilisables, des plans, des résultats de génération et de l'état du montage final, sans tout fourrer dans un seul prompt.

Qu'est-ce que Akira Video ?

Akira Video (`akira-video`) est le routeur principal de la suite Akira Video Skills. Il gère l'entrée dans un projet vidéo, la maintenance du fichier `VIDEO.md`, la délégation des tâches de production spécialisées et les limites d'arrêt. Chaque aspect spécifique (scénario, design, audio, plans, génération, révision, montage) est confié à un Skill canonique dédié, ce qui permet de garder un prompt principal léger et facile à maintenir. Le système protège une hiérarchie de priorités stricte : intégrité factuelle, intention narrative/visuelle, identité des personnages/objets, continuité spatio-temporelle, esthétique, et effets techniques. Il est conçu pour être utilisé sur des plateformes supportant les Skills (comme Claude Code, Cursor, etc.) et s'appuie sur des fichiers de référence structurés (`VIDEO.md`, `SHOT.md`, `references/workflow/`) pour garantir la cohérence entre les sessions. L'approche modulaire permet de reprendre un projet existant sans réexécuter mécaniquement les étapes amont et de gérer efficacement les cycles d'attente pour les générations externes.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Akira-TL/akira-video-skills/tree/HEAD/skills/video/akira-video

Demander à votre IA préférée

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

Documentation

Que fait Akira Video ?

akira-video est le routeur principal d'Akira Video Skills. Il gère le point d'entrée dans un projet vidéo, le fichier VIDEO.md, l'évaluation de la tâche en cours, l'orientation vers le Skill spécialisé approprié et les limites d'arrêt. Les aspects spécifiques (scénario, assets réutilisables, plans, packs de génération, révision et montage final) sont pris en charge par le Skill correspondant. Les dépendances complètes du projet et les transitions homme-machine suivent references/workflow/PRODUCTION-FLOW.md ; pour un projet existant, on reprend le travail réel en cours, sans réexécuter mécaniquement les étapes amont.

Tout au long de la production, la priorité est toujours donnée à la protection : faits utilisateur/source → intention narrative/visuelle (le cas échéant) → identité et structure des personnages/objets → faits produit (pour les publicités) → continuité spatiale et temporelle → qualité esthétique → effets techniques. Les niveaux hiérarchiques détaillés, la vérification des conflits et les exceptions à la « sortie réelle adoptée » sont décrits dans references/workflow/AUTHORITY.md ; les objectifs ultérieurs ne peuvent pas compromettre les contraintes antérieures.

1. Entrer dans un projet ou le reprendre

Lire d'abord le fichier VIDEO.md à la racine du projet. S'il n'existe pas, créer un projet vidéo minimal selon references/project/PROJECT-LAYOUT.md ; la définition du projet et son état actuel suivent references/project/VIDEO-HOME.md et la nomenclature suit references/project/NAMING.md. Créer uniquement les répertoires et fichiers réellement nécessaires à l'instant ; ne pas pré-générer de catégories vides. Lors du premier besoin réel d'un pack de génération, s'assurer que le .gitignore du projet cible ignore .tmp/.

Si l'utilisateur a déjà fourni des images, vidéos, fichiers audio, montages bruts ou vidéos de référence, évaluer d'abord leur véritable utilité dans le projet actuel selon references/project/IMPORT-MEDIA.md ; les résultats directement réutilisables ne forcent pas une refonte ou une nouvelle génération.

Ensuite, lire le contenu minimal nécessaire en fonction de la tâche en cours :

  • Script vidéo et aperçu des plans : video/script/
  • Contenu réutilisable entre les plans : video/materials/
  • Plan en cours : video/shots/<shot-id>/
  • Si le montage final a commencé : video/edit/
  • Sources amont (roman, chapitres, brief de marque, etc.) : suivre le pointeur réel du projet, sans créer une deuxième copie de la source factuelle.

Critère d'achèvement : être capable d'expliquer l'objectif de la vidéo, les exigences de livraison, le contenu en cours de production, les actifs réutilisables disponibles, l'état actuel du plan/montage et les véritables blocages.

Avant d'entamer une étape de production coûteuse, exécuter uniquement les contrôles légers applicables au projet selon references/workflow/PRODUCTION-GATES.md ; ces contrôles ne génèrent pas de fichiers d'état supplémentaires pour le projet. Lire references/project/SCALING-VERSIONS.md uniquement si le projet actuel est devenu trop volumineux pour une lecture linéaire, ou si la comparaison de versions créatives est réellement nécessaire ; ne pas présupposer de répertoire pour longs-métrages. Pour le nettoyage des résultats échoués, packs ponctuels, caches ou médias obsolètes, vérifier d'abord selon references/project/MEDIA-LIFECYCLE.md que le fichier n'est pas la seule entrée, le résultat adopté actuellement, ou la seule dépendance du montage final.

Pour savoir comment enregistrer les décisions importantes, quand mettre à jour VIDEO.md, et pourquoi les résultats de plans adoptés ne sont écrits que dans SHOT.md, voir references/project/RECORDING.md ; l'historique de chat et les packs de génération ponctuels ne sont pas des enregistrements de projet à long terme.

2. Maintenir VIDEO.md

VIDEO.md est la page d'accueil de production vidéo, lisible par les humains et le prochain Agent. Il ne conserve que les informations toujours utiles. Il se concentre sur :

  • L'objectif du projet et de la vidéo
  • Les exigences de livraison
  • La progression actuelle de la production
  • Le travail en cours
  • Les blocages
  • Les décisions clés ayant encore un impact sur la suite
  • La navigation vers le script, les actifs réutilisables, les plans et le montage final

L'historique des prompts génériques, tous les résultats de génération, les logs de génération et les anciennes décisions déjà remplacées par l'historique Git ne doivent pas figurer dans VIDEO.md.

Les instructions détaillées de rédaction se trouvent dans references/project/VIDEO-HOME.md.

3. Acheminer le travail spécialisé

En fonction de l'objectif actuel de l'utilisateur et du contenu existant du projet, choisir la prochaine tâche de production réelle. Un projet complet ne nécessite pas de passer mécaniquement par toutes les capacités ; si le script existe déjà, on peut passer directement aux plans ; si les plans et les assets sont prêts, on peut préparer un pack de génération ; après le retour des résultats, on passe directement à la révision.

Charger le Skill canonique en fonction de la tâche :

  • Pour créer/réviser un script vidéo, les performances des personnages, les scènes ou l'aperçu des plans à partir d'un roman, d'un chapitre, d'un brief ou d'autre contenu amont → video-script
  • Pour les personnages ou les scènes n'ayant qu'une description fonctionnelle, sans apparence/vêtements/matériaux/espace/éclairage concrets → video-design
  • Pour les personnages nécessitant une voix stable entre les plans, des références sonores, ou pour planifier les dialogues, l'ambiance, les effets sonores et les limites audio de l'ensemble de la vidéo → video-audio
  • Pour planifier ou maintenir des prompts et des actifs de référence (personnages, scènes, accessoires, produits) réutilisables entre les plans → video-materials
  • Pour développer l'aperçu des plans en SHOT.md, en gérant l'action, la photographie, le son et la continuité avec les plans adjacents → video-shot
  • Pour rédiger les prompts de génération en cours, sélectionner le plus petit ensemble de références, organiser un pack de génération ponctuel et importer les résultats de l'utilisateur → video-generation
  • Pour juger de l'adoption des images ou résultats rapportés par l'utilisateur, ajuster la suite, procéder à des corrections, des régénérations ou des réécritures → video-review
  • Pour le montage final de plusieurs plans adoptés dans Premiere Pro, After Effects, DaVinci Resolve, etc. → video-editing
  • Pour les sous-titres, voix off, doublage ou versions finales formelles en plusieurs langues → lire d'abord references/workflow/LOCALIZATION.md ; confier le contenu traduit à video-script, l'audio à video-audio, les sous-titres/éléments graphiques/export final à video-editing, sans dupliquer l'ensemble du projet
  • Pour les placements de marque, de produit ou les publicités nécessitant une vérification des fonctionnalités, de la structure, des assets officiels et des limites d'expression publicitaire → charger le Skill optionnel video-advertising si nécessaire ; s'il n'est pas installé pour la cible actuelle, utiliser la coordinate explicite akira-tl/akira-video-skills/video-advertising, la soumettre au Routeur akira / Skiloom pour générer un plan candidat et l'installer après autorisation.

Le Routeur ne conserve que le résumé des responsabilités ci-dessus ; une fois entré dans une branche, le Skill effectivement chargé fait autorité comme seule source pour cette méthode spécialisée.

Si l'objectif nécessite une adaptation spécifique au modèle vidéo, lire d'abord references/workflow/MODEL-ADAPTERS.md pour choisir le plus petit package d'adaptation disponible dans le dépôt actuel ; s'il n'est pas encore installé, soumettre la coordinate explicite au Routeur akira / Skiloom pour générer un plan candidat et l'installer. Ne pas coder en dur les paramètres de modèle ou les détails du fournisseur dans akira-video. La génération d'images suit actuellement les règles générales de video-design + video-materials, sans maintenir d'adaptateur de modèle d'image séparé.

Si la génération externe est confiée à l'utilisateur et nécessite d'attendre entre les sessions, enregistrer dans VIDEO.md selon references/workflow/WAITING-RESUME.md uniquement le chemin du pack de génération, le retour attendu, la prochaine étape et les véritables blocages ; la session suivante donne la priorité à la reprise du pack existant / des résultats, sans refaire le packing en raison d'un changement de session.

4. Frontière homme-machine pour la génération externe

Par défaut, l'utilisateur peut effectuer la génération réelle dans des modèles d'image/vidéo externes. Lorsqu'une génération externe est nécessaire, le Skill de génération spécialisé prépare un pack de génération ponctuel à partir du contenu formel du projet :

Contenu formel du projet → pack de génération ponctuel .tmp/ → génération externe par l'utilisateur → retour des résultats → archivage dans le répertoire formel → suppression du pack temporaire.

Le pack ponctuel est un dérivé, pas une source factuelle à long terme du projet ; les prompts à long terme restent dans le répertoire d'actifs ou de plan correspondant, le pack temporaire ne copie que ce qui est réellement nécessaire pour la génération en cours.

5. Réorientation et limites d'arrêt

Dès qu'un Skill spécialisé a terminé une action délimitée :

  1. Archiver les assets formels retournés, les résultats de génération, les décisions de plan ou le projet de montage dans le répertoire correspondant
  2. Mettre à jour le VIDEO.md avec les informations encore pertinentes pour la production
  3. Déterminer le prochain travail de production en fonction de l'objectif de l'utilisateur et des livrables actuels

S'arrêter uniquement si le périmètre défini par l'utilisateur est achevé, si l'étape suivante nécessite d'attendre une génération externe de l'utilisateur ou la fourniture d'actifs, s'il existe un véritable blocage, ou si le livrable actuel est terminé. Lorsqu'on attend une génération externe de l'utilisateur, fournir clairement le pack de génération ponctuel et les exigences de nommage pour le retour, sans faire semblant de produire des actifs.

Individual skills in this repo

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

Akira-TL/akira-video-skills

为 Runway 当前视频模型编译和检查生成提示词;当 video-generation 需要使用 Runway(当前主线 Gen-4.5)的 Text to Video 或 Image to Video,并需要 Runway 专用动作、摄影和时序表达时使用。

Akira-TL/akira-video-skills

为 ByteDance / BytePlus Seedance 当前视频模型编译和检查提示词;当 video-generation 需要使用 Seedance 2.5 的参考素材、时间线、同步声音、视频编辑、延长或多镜头能力时使用。

Akira-TL/akira-video-skills

为 Google Veo 视频生成编译和检查提示词;当 video-generation 需要使用 Veo 的 Text to Video、Image to Video、首尾帧、参考元素或同步声音能力时使用,并先核验具体 Google 使用入口与 model 的当前支持范围。

Akira-TL/akira-video-skills

为品牌短片、产品植入剧情、广告或比赛作品建立产品事实与广告边界;当视频需要准确表达某个具体产品的官方功能、参数、结构、使用方式、品牌素材或产品与剧情关系时使用。

Akira-TL/akira-video-skills

设计并维护 AI 视频中跨镜头复用的角色声音、音色参考、对白声音要求与整片声音关系;当同一角色需要跨镜头保持声音一致,或需要规划语音参考、环境声、音效、音乐与画面的职责边界时使用。

Akira-TL/akira-video-skills

设计 AI 视频中的角色与场景视觉方案;当脚本只说明“需要一个什么样的人/场景”,但还没有形成可稳定生成的外形、服装、材质、色彩、空间、光线和视觉识别系统时使用。

Akira-TL/akira-video-skills

组织整片级剪辑、合成、全片声音和最终成片;当多个已采用镜头需要进入 Premiere Pro、After Effects、DaVinci Resolve 等后期工程,或需要整片字幕、Logo、音乐、混音、比例版本和最终导出时使用。

Akira-TL/akira-video-skills

为 AI 图片或视频生成准备可直接使用的提示词与一次性生成包,并在用户把生成结果带回项目后归档;当需要从正式视频脚本、复用素材和 SHOT.md 编译生成内容、选择参考素材、约定返回文件名或清理临时包时使用。

Akira-TL/akira-video-skills

规划、创建、整理和维护多个镜头会重复使用的视频复用素材;当需要人物/场景/道具/产品提示词、参考图、官方素材、身份与状态参考或其他可重复引用内容时使用。

Akira-TL/akira-video-skills

审核 AI 生成的人物/场景等复用素材或镜头生成结果,判断采用、修改提示词、重生成还是留给后期修复;当生成结果返回项目、需要检查身份/结构/连续性/动作/摄影/产品真实性或选择生成结果时使用。

Akira-TL/akira-video-skills

把小说、章节、故事梗概、品牌 brief 或其他上游内容转换成当前视频自己的脚本层;当需要编写或修订 SCRIPT.md、视频人物表演定义、场景定义、对白或镜头总表时使用。

Akira-TL/akira-video-skills

把 SHOTS.md 中的镜头总览展开成可直接制作的单镜头定义;当需要创建或修改 video/shots/<shot-id>/SHOT.md、镜头连续性、摄影、动作、表演、声音或镜头专属生产约束时使用。

Skills associés