Editar Reel de Futuros Residentes / Doc Juanes
Abans de decidir res editorial, llegeix references/estilo.md: és l'estil aprovat i el perquè de cada regla. Si alguna cosa falla, revisa references/problemas.md: gairebé tot el que pot sortir malament ja va passar una vegada. Per a música, references/musica.md.
Com treballar amb qui demana el vídeo
- Escriu-li en espanyol, clar i sense argot tècnic. Potser no programa: explica-li què veus i què faràs.
- Abans d'executar, resumeix el pla d'acció i espera la seva aprovació, sempre, a cada etapa (pla inicial, cada ronda de canvis, portades, música). El resum porta dos criteris: l'audiovisual (què es farà, pas a pas) i el financer: la projecció de consum de tokens (vegeu "Consum de tokens"). Pots preparar i transcriure el cru abans, perquè el pla sigui concret.
- Tu no pots escoltar àudio. Verifica amb mesures i re-transcripcions, i demana-li que escolti el subjectiu: efectes de so, volum de la música i talls molt ajustats.
- Mostra-li fotogrames i el MP4 a cada versió. Quan demani un canvi, localitza'l al segon del vídeo EDITAT que esmenta (mapeja amb
src/Reel/edit.json) i confirma quina frase és. - Marca: al pla confirma si el vídeo és de Doc Juanes o de Futuros Residents (FR). Defineix la carpeta del projecte i l'espai de Google Chat on s'avisa (Pas 9).
- Noms: al pla proposa (o demana-li) un NOM_CURT en majúscules amb guions baixos (p. ex.
JUANCHO_PASASTE); és també el nom de la carpeta del projecte.- Mentre es revisa: cada versió amb número perquè no en vegi una de vella ("no percebo canvis"):
NOM_CURT_REEL_v2.mp4,NOM_CURT_PORTADA_1.jpg... A Descàrregues, només l'última versió. - Quan aprovi la versió definitiva, reanomena'ls traient tota la resta, inclòs el número:
NOM_CURT_REEL.mp4iNOM_CURT_PORTADA.jpg, i treu de Descàrregues les versions i portades descartades. - Portada: tan bon punt en triï una, reanomena-la de seguida a
NOM_CURT_PORTADA.jpg(sense número), a Descàrregues i aout/portades/, encara que el vídeo segueixi en revisió, i treu les altres opcions. Si després demana ajustos a la triada, sobrescritu aquest mateix fitxer sense número. - Imatges de prova que li envies (fonts, colors, llum, efectes, fotogrames de revisió):
NOM_CURT_PROVA_<TEMA>_N.jpg(p. ex.NOM_CURT_PROVA_FONTS_1.jpg). En aprovar la versió definitiva, treu-les igual que les versions descartades: només queden el REEL i la PORTADA. - No esborris mai amb
rmfitxers de la persona: utilitza./scripts/papelera.sh <fitxers>(Paperera del Mac o Paperera de reciclatge de Windows; es poden recuperar).
- Mentre es revisa: cada versió amb número perquè no en vegi una de vella ("no percebo canvis"):
- Música: no tots els vídeos en porten; només si la demanen. No repeteixis mai una cançó ja usada (llista a
references/musica.md), llevat que la Janeth autoritzi reciclar-la. - Els programes interactius (com
npx create-video) s'executen en una pestanya del tauler Terminal: digue-li que faci clic a la pestanya i respongui allà, explicant-li cada pregunta.
Qui pot canviar aquest skill
El skill viu a GitHub (github.com/tatacardona/Reels-FR-Doc-Juanes) i només la Janeth Cardona el modifica. Per saber en quin ordinador ets: git -C ~/.claude/skills/editar-reel-fr config user.email.
- Si respon
[email protected](ordinador de la Janeth): abans de canviar el skill, pregunta-li sempre i espera el seu sí; digue-li en una línia què canviaries i per què serveix per a tots els vídeos (si ella mateixa demana el canvi, ja està aprovat). Allò puntual d'un vídeo (cançó, temps, posicions, volums) va només al seu projecte, mai al skill. Després de canviar-lo:git -C ~/.claude/skills/editar-reel-fr add -A && git commit -m "<què va canviar>" && git push. - En qualsevol altre ordinador: no modifiquis mai els fitxers del skill. Si descobreixes una millora o un problema que serveix per a tots, digues a la persona que li ho expliqui a la Janeth i escriu-li el text per enviar-li (què va passar, en quin vídeo i què proposes).
- Les cançons usades s'anoten a
references/musica.md; en altres ordinadors, passa-li a la Janeth el títol, artista i enllaç perquè ho afegeixi.
Consum de tokens (els comptes són compartits per tot l'equip)
Cada pas de Claude rellegeix tota la conversa: això és gairebé tot el cost i creix amb la seva llargària. Per això:
- Una conversa nova per vídeo. En aprovar un vídeo, suggereix obrir una conversa nova per al següent. Seguir a la mateixa pot costar 2-3 vegades més.
- Canvis en lot: demana que ajunti totes les seves correccions en un sol missatge numerat, i aplica-les en una sola exportació.
- Llegeix poc i petit: tires de fotogrames reduïdes (
SCALE=0.25-0.35), només la part necessària de fitxers i sortides (tail,grep), re-transcriu només el tram en dubte. Les imatges grans costen. - Esperes sense preguntar: les exportacions llargues van en segon pla; no revisis cada minut.
- Sense passos que no es van demanar: adhesius, música, fons amb IA o cerques extra només si els demanen.
Projecció a cada pla (xifres mesurades en vídeos reals de 30-45 s; cost a tarifa pública de l'API amb Claude Opus 5.5, en una conversa nova). Mostra una taula curta amb els passos del pla, el seu rang i el total, i aclareix que és aproximat:
| Etapa | Passos de Claude | Cost aprox. |
|---|---|---|
| Preparar, transcriure i presentar el pla | 15-25 | US$ 1-2 |
| Propostes visuals (fonts, color, llum) amb mostres | 8-15 | US$ 1-1,5 |
| Muntar l'edició, text per aprovar i exportar la v1 | 20-35 | US$ 2-3 |
| Cada ronda de canvis + nova exportació | 10-25 | US$ 1-2,5 |
| Cercar i ajustar música | 10-20 | US$ 1-2 |
| 3 portades | 8-15 | US$ 1-1,5 |
| Vídeo complet típic (pla, v1, 2 rondes, portades) | 80-130 | US$ 7-12 |
Amb pla Team/Enterprise la factura pot ser diferent; la xifra serveix per comparar opcions. Si la persona vol estalviar, ofereix-li alternatives concretes (menys rondes, sense música, sense portades noves, o usar un model més econòmic per a un vídeo senzill); la decisió és seva.
En tancar cada vídeo, mesura el consum real amb python3 scripts/consumo.py --desde "<text del primer missatge del vídeo>" i comparteix-lo junt amb la projecció. Si la diferència és gran i estàs a l'ordinador de la Janeth, proposa ajustar aquesta taula.
Pas 0: Eines (una vegada per màquina) i actualitzar el skill
git -C ~/.claude/skills/editar-reel-fr pull -q # porta l'última versió del skill (cada vídeo)
source ~/.claude/skills/editar-reel-fr/scripts/setup-tools.sh # exporta $PY, $FF, $PROYECTOS, $DESCARGAS
Instala ffmpeg complet, faster-whisper, DeepFilterNet (treu eco) i OpenCV en un entorn propi. La primera transcripció descarrega el model large-v3-turbo (~1,6 GB): demana permís abans.
- Mac: necessita Node.js i Python 3 (venen amb les eines de Xcode o s'instal·len una vegada).
- Windows: Claude Code utilitza Git Bash, i aquests programes hi corren. Abans, una sola vegada, instal·la Python 3.11 i Node.js LTS (
winget install Python.Python.3.11iwinget install OpenJS.NodeJS.LTS, amb permís de la persona; Python 3.12 o més nou no serveix). Si alguna cosa falla a Windows, mirareferences/problemas.mdi explica-li-ho a la Janeth.
Pas 1: Projecte Remotion
- Projectes a
$PROYECTOS/<MARCA>/NOM_CURT, amb<MARCA>=Doc JuanesoFR(Mac: Pel·lícules → Reels Doc Juanes; Windows: Vídeos → Reels Doc Juanes), un per vídeo. Projectes anteriors per copiar: en aquestes dues subcarpetes. - El més ràpid: copia
package.json,package-lock.json,tsconfig.json,remotion.config.ts,src/index.ts,src/index.cssisrc/Root.tsxd'un projecte anterior, inode_modules(Mac:cp -c -R, clon instantani; Windows:npm ci). Sense projecte previ:npx create-video@latest(Blank, Tailwind Yes),npm iinpm i @remotion/google-fonts@<versió de remotion>. - Plantilla i scripts:
cp -R ~/.claude/skills/editar-reel-fr/assets/template/src/Reel src/Reelimkdir -p scripts && cp ~/.claude/skills/editar-reel-fr/scripts/* scripts/. - Registra la composició (vegeu
assets/template/Root.snippet.tsx) i"resolveJsonModule": true.
Pas 2: Preparar el cru
- Extreu un fotograma (
"$FF" -ss 20 -i cru -frames:v 1 x.jpg) i mira'l: orientació (si la persona surt de costat utilitzaccw/cw), color de la paret (decideix el color de les paraules clau) i posició de la cara (FACE_ORIGIN). FF="$FF" ./scripts/prep.sh "<cru>" <none|ccw|cw>→public/video-vertical.mp4(amb la corba d'il·luminació que aclareix ombres;LIGHT=0la treu) + àudios awork/.- Si demana millorar el fons o la llum (fons carregat, cara fosca per llum de dalt):
scripts/fondo-luz.pysepara la persona amb IA i creapublic/video-fondo.mp4amb fons difuminat, llum de farcit que segueix la cara i, si es vol, llums de colors tipus vitrall a la paret. Ajustos aedit-config.json→"fondo"(vegeu l'encapçalament del script); s'executa després debuild-edit.py(només processa els trams usats; torna a executar-lo si canvien els trams, o aquells quadres sortiran sense processar) i s'activa ambVIDEO_SRC = "video-fondo.mp4". Mostra-li abans un fotograma de prova. L'estil el prefereix subtle: desenfocament lleu (5), vora molt suau (14) i vitrall/bokeh molt tènues.
Pas 3: Transcriure i mapejar
"$PY" scripts/transcribe.py # frases amb temps → work/transcript.json
"$PY" scripts/energy.py words # volum de cada paraula vs. la seva frase (+dB = èmfasi)
Munta el mapa editorial i explica-li-ho en una llista curta:
- Fora: claqueta ("Llest, guió N…"), toms falsos ("una altra vegada", paraulotes, rialles), frases repetides (queda't amb la presa més neta; sol ser l'última), arrencades en fals, tancament ("llest").
- Ganxo: la primera frase forta; va primer.
- Paraules estirades (p. ex. "no" de 3 s), paraules estranyes o veu sense transcriure = preses repetides o arrencades en fals: re-transcriu aquests trams aïllats (WhisperModel sobre el tros d'àudio) i afina amb
energy.py zoom <inici> <fi>. - Si el guió té una dada equivocada (una xifra mal dita), proposa tallar-la; no imitis mai la veu amb IA.
Pas 4: Àudio
FF="$FF" PY="$PY" ./scripts/audio.sh # veu amb menys eco i natural (DeepFilterNet + expansor suau, −14 LUFS)
"$PY" scripts/energy.py # mesura sobre la veu neta → talls més ajustats
"$PY" scripts/sfx-stickers.py # només si hi haurà adhesius amb so
"$PY" scripts/sfx-tear.py # només si hi haurà foto esquinçant-se
Pas 5: edit-config.json: les decisions editorials
Base: assets/edit-config.example.json. Tots els temps en segons del vídeo CRU:
clips: un tram per frase o idea, en ordre, amb marge ample. El script retalla els silencis a dins i a fora, sense tallar mai una paraula.fx:punch(continuació),whoosh(canvi de tema),leak(llampec de llum de sol amb colors; per a vídeos inspiradors, vegeuestilo.md),flash(llampec blanc).zoomfixa el pla d'un tram;steps: [[seg, zoom], …]és una escalinata de plans sense tallar l'àudio.hold_zoom: true= un sol pla.tail: 0.1= marge extra al final del tram si el tall es menja una consonant final suau.emphasis:[paraula, segon]de les paraules dites amb força o clau (~1 cada 1,5-2 s).word_fixes: temps reals d'una paraula. Després confirma que va quedar DINS del tram (si cau al silenci previ, desapareix del subtítol).idea_start: majúscula d'inici d'idea (afecta a tota paraula a < 0,1 s: si la següent està molt a prop, com "I no", utilitza un temps just abans de la primera).text_fixes:[{"at": seg, "text": "pregunta:"}]text exacte d'una paraula (p. ex. conservar ":").brand_words(protegeix "Futuros Residents", "Doc Juanes"; afegeix-ne d'altres com "UdeA"),small_extra(paraules curtes que mai van soles: "fue", "esa", "mi", "tan"…).photos:{src, show_at, tear_at}(s'esquinça) o{src, show_at, hide_at}.stickers(només si els demana; exemple aassets/edit-config.stickers.example.json):{kind, show_at, hide_at, x, y, size, sfx: [[fitxer, seg, volum]]}. Tipus:broken-heart(break_at) i dibuixos deARTasrc/Reel/Stickers.tsx. Per a un de nou, dibuixa'l com a SVG propi (mai emojis d'Apple ni imatges amb drets). Posa'ls on la persona mou les mans (mira fotogrames), mai sobre la cara ni els subtítols. Si un efecte ha de seguir el cap,"$PY" scripts/head-track.py <inici> <fi>+follow_head: truedonen la seva posició fotograma a fotograma (track).sounds:[[fitxer, seg, volum, desfasament_seg]];shakes: segons amb sacsejada (impactes).end_push: {at, to}: tancament per defecte, acostament suau a la cara (~1,6) sense fos a negre.end_hold: segons extra al final.speed: si demana accelerar (vegeu Pas 7).- Font base (paraules normals): Montserrat Black 900, blanca amb vora negra, llevat que la marca del vídeo demani una altra (p. ex. vídeos de Futuros Residents amb la font de la seva pàgina web).
- Paraules ressaltades: proposa-li-les al pla segons el to del vídeo, amb 2-3 opcions sobre un fotograma real: una sola font o dues fonts (p. ex. una elegant/serif per a allò emotiu i una grosseta per a allò impactant), amb el mateix color o colors diferents. Fonts i colors acords al to (inspirador, nostàlgic, enèrgic, còmic…).
EMPH_*(primera) iEMPH2_*(segona, paraules marcades"alt"aemphasis) aconstants.ts. El color ha de contrastar amb la paret. echo:[[inici, fi]]eco suau en una frase de transcendència (després:"$PY" scripts/eco.py). Proposa-ho si detectes una frase així, o aplica-ho si ho demanen.
…
[truncated per traducció]