/new-edit-style
Des bandes de référence entrent, un skill /<style>-edit verrouillé sort, pour que chaque montage réalisé avec lui ressemble aux
références. C'est le processus qui a construit /kallaway-edit, écrit et affiné. La personne qui l'utilise n'est généralement PAS technique : anglais simple, un message court par étape, ne jamais lui faire toucher au code.
SK = ${CLAUDE_SKILL_DIR}, le dossier de ce skill. ENGINE = ${CLAUDE_SKILL_DIR}/../kallaway-edit,
le skill de montage éprouvé sur lequel il s'appuie (il contient l'assistant de configuration, la transcription, le découpage, la suppression, le son, la construction, le rendu et l'assurance qualité). Ne jamais écrire dans SK ou ENGINE : une mise à jour remplace les deux.
DATA = $HOME/.claude-video-editor, le dossier propre à l'éditeur qui survit aux mises à jour (paramètres, Python, effets
sonores, cache de polices). ROOT = le dossier du projet (projectRoot dans DATA/config.json).
Exécute chaque script via l'un de ces chemins, exactement comme écrit, pour qu'il trouve les paramètres de l'utilisateur :
PY = VIDEO_EDITOR_DATA="$HOME/.claude-video-editor" "$HOME/.claude-video-editor/venv/bin/python" -I
SYS = VIDEO_EDITOR_DATA="$HOME/.claude-video-editor" python3 -I (avant l'exécution de la configuration)
STYLE = nom court en kebab-case (« helyane »). SDIR = ROOT/references/<STYLE>/.
WORK = ROOT/work/new-edit-style/<STYLE>/ (les PNG de progression vont dans WORK/progress/, numérotés).
Règles strictes
- Outils gratuits uniquement (ffmpeg, Python, faster-whisper, HyperFrames, polices OFL). Pas d'API payantes, pas de connexions.
Téléchargement des liens de référence déconnecté (
yt-dlp --no-cookies) ; n'utilise jamais les cookies d'un navigateur. - Ne touche jamais aux fichiers originaux de l'utilisateur ; ne supprime jamais rien (déplace les anciennes versions vers
ROOT/archive/). - N'exécute jamais
npx hyperframes initounpx hyperframes skills; rien ne peut être ajouté à~/.claude/skillsou~/.agents/skills. - Ne présente jamais une supposition comme mesurée, ni un son comme entendu. Les agents ne peuvent pas entendre ; la vérification auditive de l'utilisateur décide.
- Copier un STYLE de montage est acceptable ; ne copie jamais les plans, logos, musiques ou textes du créateur dans un montage.
- Sous-agents : un par bande de référence pour les décompositions (Sonnet convient), au maximum 3 à la fois, briefés
avec
references/breakdown-brief.md. Tout ce qui nécessite du jugement ou des yeux, tu le fais toi-même.
Flux de travail
0. Configuration (première fois uniquement)
Si DATA/config.json ne contient pas "setupComplete": true, exécute d'abord l'assistant de configuration de l'éditeur : invoque le
skill kallaway-edit avec setup (ou lis ENGINE/SKILL.md étape 0, où
${CLAUDE_SKILL_DIR} signifie ENGINE et $HOME/.claude-video-editor signifie DATA) : vérification de Claude Code, vérification
des outils, dossiers du projet, installation. Si ENGINE est manquant, dis : « Ce skill nécessite que le skill kallaway-edit soit installé à côté (il contient le moteur de montage).
Réinstalle les deux depuis https://github.com/learnaiwithhugo/video-editor-skills, puis relance /new-edit-style.
» puis arrête-toi. Ce skill nécessite aussi yt-dlp (il télécharge les bandes de référence), donc vérifie toujours
avec SYS "ENGINE/scripts/setup.py" --check --for new-edit-style, lors de la première exécution et des suivantes. Si
yt-dlp est manquant, donne à l'utilisateur sa ligne de correction (brew install yt-dlp, collée dans l'application Terminal), attends
qu'il dise que c'est fait, et vérifie à nouveau.
1. Réception (~2 min)
Demande, en un message : « Envoie-moi 2 ou 3 bandes (liens ou fichiers) d'UN SEUL créateur dont tu veux copier le style de montage,
idéalement tes montages préférés d'eux, et un nom court pour le style. » 3 c'est le mieux : les règles viennent de ce qu'elles ont toutes en commun. Puis :
SYS "SK/scripts/fetch.py" STYLE "ROOT" <lien ou fichier> ... -> SDIR/STYLE-1.mp4 ...
Dis : « Reçues. Je mesure chaque image maintenant (environ 2 minutes). »
2. Préparation, le tout scripté (~30 s par bande)
PY "SK/scripts/prep.py" "SDIR" SDIR/STYLE-*.mp4
Par bande dans SDIR/prep/<reel>/ : transcription avec horodatage, analyse de coupe par image, planches contact 4 ips avec
horodatages, images pleine taille, spectrogramme, hits d'effets sonores stéréo, volume sonore, et fingerprint.json (les
chiffres de style mesurés). Plus SDIR/style-check.png et SDIR/style-spec.json.
Regarde style-check.png maintenant. Si une bande ne partage clairement pas l'aspect des autres (disposition différente,
sous-titres, couleurs), dis-le à l'utilisateur et demande un remplacement avant d'utiliser des agents. Copie-le dans
WORK/progress/01-style-check.png.
3. Décompositions, un agent par bande, en parallèle (~15 min)
Remplis references/breakdown-brief.md une fois par bande et lance-les en un seul message. Chacune écrit
SDIR/prep/<reel>/edit-log.md. Pendant qu'elles tournent, fais l'étape 4 de correspondance de polices.
4. Correspondance de polices (~20 s)
PY "SK/scripts/font_match.py" SDIR/STYLE-1.mp4 SDIR/prep/STYLE-1/transcripts/STYLE-1.words.json "SDIR/font"
Regarde font-match.png : le gagnant doit visiblement correspondre. Exécute-le sur une deuxième bande si les deux premiers sont à moins de
0.01 l'un de l'autre. (Helyane : Archivo 800 à -0.045 em a obtenu 0.773, au-dessus du Helvetica Neue Bold à 0.759.)
5. Fusion dans le guide de style (toi, ~10 min)
Suis references/merge-guide.md : règles consensuelles, chiffres mesurés, une feuille d'images clés que tu regardes
toi-même, et la section tournage. Produis SDIR/STYLE-style-guide.md + SDIR/STYLE-key-frames.png.
Ouvre la feuille d'images clés pour l'utilisateur et donne-lui le résumé d'un paragraphe.
6. Création du skill de style (~2 min + ta réécriture, ~30 min)
SYS "SK/scripts/make_style_skill.py" STYLE "SDIR" --title "Nom d'affichage"
Il clone le moteur éprouvé (ENGINE, trouvé à côté de ce skill) dans ROOT/.claude/skills/STYLE-edit/ :
un skill de projet dans le propre dossier vidéo de l'utilisateur, jamais dans le dossier global des skills, donc les mises à jour ne l'affectent jamais.
La copie partage DATA (pas de deuxième installation). Il ajoute les outils de correspondance (scripts/match/), écrit style.json
à partir du cahier des charges mesuré, et imprime la liste de contrôle des
fichiers de style à réécrire à partir du guide de style (SKILL.md règles de style, style-rules.md, graphics-recipes.md,
sound-map.md, filming-guide.md, le kit CSS/JS, et les layouts de build.py uniquement si le style a des
layouts différents). Réécris chaque élément de la liste. Les scripts du moteur restent intacts sauf si un layout le nécessite.
7. Verrouillage du style (~45-60 min)
Suis references/lock.md : un montage test sur les plans de l'utilisateur -> score de correspondance -> correction -> recréation
idéale d'une fenêtre de référence -> correction -> un tour de critique -> vérification auditive -> approbation. Consigne chaque chiffre
dans STYLE-edit/references/lock-log.md.
8. Livraison
Dis à l'utilisateur : la nouvelle commande (/STYLE-edit, disponible à chaque ouverture de Claude Code dans ROOT ; si elle
n'apparaît pas encore, redémarre Claude Code là-bas), ce qu'elle fait en un paragraphe, le score de correspondance et les
chiffres idéaux, comment filmer pour ce style (3-4 puces de la section tournage), et ce qui ne correspond toujours pas.
Durées (sur un Mac M4 Pro, 3 bandes d'environ 1.5 min)
Récupération 1 min · préparation 1.5 min · décompositions 15-18 min (parallèle) · correspondance de polices 20 s · fusion 10 min · crétion du skill 2 min + réécriture 30 min · verrouillage 45-60 min. Environ 2 heures du début à la fin, principalement des agents et des rendus.
Fichiers
scripts/ : fetch.py, prep.py, fingerprint.py (mesure / cahier des charges / score), font_match.py, golden.py,
make_style_skill.py, engine.py (trouve ENGINE). references/ : breakdown-brief.md, merge-guide.md,
lock.md. templates/ : style-rules.md, graphics-recipes.md, lock-log.md (copiés dans les nouveaux skills de style).