Communitygithub.com

doc-real

Style de montage vidéo documentaire réaliste pour Claude : cadre letterbox, étalonnage cinéma, sous-titres minuscules et indicatif de lieu. Idéal pour mini-documentaires, portraits de fondateurs, voyages, interviews et films de marque. Transforme un clip brut en un montage 9:16 fini avec le moteur video-studio-core (transcription, coupes automatiques, habillage, son, étalonnage).

Qu'est-ce que doc-real ?

Ce skill permet à Claude de produire des montages vidéo dans un style documentaire réaliste, à partir d'une séquence brute filmée en caméra. Il exploite le moteur `video-studio-core` pour transcrire l'audio, effectuer des coupes automatiques, ajouter un habillage sobre (barres letterbox, étalonnage cinéma, grain, push lent) et générer des sous-titres minuscules blancs centrés bas, ainsi qu'une étiquette de lieu/chapitre dans le coin supérieur gauche. Le format par défaut est 9:16 (vertical), mais peut être changé via `--format`. Le skill est conçu pour les mini-documentaires, portraits de fondateurs, voyages, interviews et films de marque. L'utilisateur fournit un clip vidéo (par ex. `clip.mp4`), et Claude exécute une série de scripts Python (`run.py`, `render.py`, `finish.py`) pour aboutir à un fichier `final.mp4`. Le plan de montage (`plan.json`) peut être affiné manuellement : réécrire l'accroche, corriger les mots mal reconnus, ajouter des chapitres `titlecard`, et paramétrer la musique. Une feuille de contacts (`contact_sheet.png`) permet de vérifier le rendu avant export final. Le skill s'appuie sur un dossier `video-studio-core` voisin, qui doit être installé préalablement.

Compatible avec✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Viprasol-Tech/claude-video-editing-skills/tree/HEAD/plugins/video-studio/skills/doc-real

Demander à votre IA préférée

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

Documentation

Doc Real

Réalisme documentaire : cadre letterbox, étalonnage cinéma, sous-titres minuscules et indicatif de lieu.

  • Idéal pour : mini-documentaires, portraits de fondateurs, voyages, interviews, films de marque
  • Catégorie : Montage tête parlante
  • Format par défaut : 9:16 (modifiable avec --format 9:16 | 1:1 | 4:5 | 16:9)
  • Nécessite une séquence caméra : oui, un clip brut
  • Texte derrière l'intervenant : non

Avant de commencer

Ce style repose sur le skill video-studio-core, qui doit être installé dans le même dossier de skills.

  • CORE = le dossier video-studio-core situé à côté de celui-ci (ex. ~/.claude/skills/video-studio-core).
  • STYLE = le dossier de ce skill (contient theme.json et theme.css).
  • Première utilisation sur une machine : python CORE/scripts/check_env.py, et corrigez tout ce qui est signalé.
  • Si CORE est manquant, demandez à l'utilisateur d'installer video-studio-core depuis le même pack.

Réaliser le montage

python CORE/scripts/run.py clip.mp4 --style STYLE --work edit-doc-real --stop-after plan --title "lieu, heure"
# affiner edit-*/plan.json (voir ci-dessous), puis vérifier les plans :
python CORE/scripts/render.py edit-doc-real/plan.json --frames 1,3,6,9
python CORE/scripts/render.py edit-doc-real/plan.json
python CORE/scripts/finish.py edit-doc-real/plan.json

Ouvrez contact_sheet.png et examinez-la avant le rendu complet. La vidéo finale est final.mp4 dans le dossier de travail. Utilisez --formats 1:1,16:9 sur finish.py pour des formats supplémentaires. Ajoutez de la musique avec "music": {"src": "track.mp3", "volume": 0.12} dans le plan.

Le rendu

  • Barres letterbox, étalonnage cinéma, grain, push lent. Sous-titres petits, minuscules, blancs, centrés en bas.
  • Une petite étiquette de lieu ou de chapitre en haut à gauche pendant les 3 premières secondes. Pas de zooms, pas d'émojis, pas d'effets sonores.

Affiner le plan

L'ébauche générée par make_plan.py est automatique. Rendez-la bonne :

  • Lisez words.json et réécrivez l'accroche (les 2-3 premières secondes) en une promesse courte et spécifique.
  • Remplacez les mots-clés faibles automatiquement sélectionnés par ceux qui portent le sens (chiffres, résultats, noms, contrastes).
  • Corrigez les mots mal reconnus dans le tableau words (conservez leurs durées).
  • Passez un lieu/contexte comme --title (ex. 'julana, haryana — 6:40 am').
  • Ajoutez des coupures titlecard avec la classe dr-chapter pour les films plus longs.
  • Types d'éléments et champs : CORE/references/plan-schema.md.

Vérifier avant de livrer

  • Contact sheet : texte lisible, rien de coupé, rien qui cache le visage sauf intention, zones de sécurité respectées (9:16 : garder le texte entre 10% et 85% de la hauteur).
  • Vérifiez le timing : les incrustations apparaissent avec le mot prononcé, pas après.
  • ffprobe le fichier final : bonne taille, durée et audio.
  • Dites à l'utilisateur ce que vous avez coupé (secondes retirées), ce que le rendu apporte, et où se trouve le fichier.

Modifier le rendu

Les couleurs et polices se trouvent dans theme.json (vars, fontsUrl) et theme.css. Pour un changement ponctuel, éditez plan.json (theme.vars, style d'élément) plutôt que les fichiers du skill.

Exemples de demandes

  • "Montage style documentaire."
  • "Donne à mon histoire un look de doc Netflix."
  • "Look documentaire cinématographique avec un indicatif de lieu."

Individual skills in this repo

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

Skills associés