olegspiridonovdev-spec/cinematic-video-skill

Que fait cinematic-video-skill ?

Compétence agent pour la génération de vidéo cinématique en prise de vue réelle — un contrat de plan en 12 blocs, la loi de fer du plan unique, et un générateur multi-fournisseur (Veo 3.1 / Sora 2 / Runway) avec une boucle ébauche→visionnage→correction. Fonctionne avec Claude Code, Codex, Cursor et plus.

Concepts Clés

Contrat de plan en 12 blocs

Chaque plan vidéo suit un format structuré avec 12 blocs obligatoires :

1. Plan — numéro de plan séquentiel
2. Description — résumé narratif
3. Cadre — plans larges, moyens, gros plans
4. Mouvement — mouvement de caméra (panoramique, travelling, etc.)
5. Durée — durée estimée en secondes
6. Dialogue — lignes prononcées
7. Action — actions des personnages
8. Son et Musique — indications audio
9. Effets — effets visuels (VFX)
10. Émotion — ton émotionnel
11. Matériel — équipement spécifique (lentilles, éclairage)
12. Notes — notes de production

Loi de fer du plan unique

Chaque plan est un plan unique sans coupure. Cela signifie :

• La caméra doit se déplacer de manière fluide d'un bloc à l'autre
• Les transitions entre blocs se font par le mouvement de la caméra, les changements de focus ou l'éclairage, jamais par des coupures
• Résultat : une continuité spatiale et temporelle parfaite

Boucle Ébauche → Visionnage → Correction

La génération vidéo suit un cycle :

1. Ébauche — générer une version préliminaire selon le contrat de plan
2. Visionnage — examiner le résultat (automatiquement ou avec retour humain)
3. Correction — ajuster le contrat de plan et regénérer

Fournisseurs Supportés

Fournisseur	Modèle	Activation
DeepMind	Veo 3.1	VEO_API_KEY
OpenAI	Sora 2	SORA_API_KEY
Runway	Gen-3	RUNWAY_API_KEY

Utilisation

# Définir la clé API (utiliser un seul fournisseur)
export VEO_API_KEY=votre_clé
# ou export SORA_API_KEY=votre_clé
# ou export RUNWAY_API_KEY=votre_clé

# Définir le répertoire de projet
export VIDEO_PROJECT_DIR=./ma_video

# Lancer la génération vidéo
# Le skill créera un fichier plan.md dans le répertoire du projet
# puis générera chaque plan séquentiellement

Workflow

1. L'agent écrit un plan.md complet avec un contrat de 12 blocs pour chaque plan
2. Le premier plan est généré en tant qu'ébauche
3. L'agent examine la sortie (ou invite l'utilisateur à la visionner)
4. Le plan est affiné et regénéré si nécessaire
5. Passer au plan suivant

Notes de Compatibilité

• Claude Code : support complet via claude_code_engine
• Codex : support complet via codex_engine
• Cursor : support complet via cursor_engine
• Autres agents : tout agent supportant les appels d'API et la manipulation de fichiers

Licence

MIT — voir le fichier LICENSE pour les détails.