Communitygithub.com

tatacardona/Reels-FR-Doc-Juanes

Edita vídeos crus de Futuros Residentes / Doc Juanes (persona parlant a càmera, guions gravats) i els converteix en Reels verticals 9:16 dinàmics amb Remotion. Talla claquetes, toms falsos, repeticions i silencis, neteja l’àudio, posa subtítols paraula per paraula amb èmfasi de color que mai tapa la cara, canvia de pla en cada tall i, si es demana, afegeix fotos superposades (fins i tot esquinçant-se), emojis/stickers amb efectes de so, llampecs de llum a les transicions i música lliure de drets. Funciona en Mac i Windows.

O que é Reels-FR-Doc-Juanes?

Aquest skill transforma vídeos crus (persona parlant a càmera) de les marques Futuros Residentes i Doc Juanes en Reels dinàmics per a Instagram/TikTok/Shorts. Utilitza Remotion per generar vídeos 9:16 amb edició automàtica que inclou: tall de claquetes, toms falsos i silencis; neteja d’àudio amb DeepFilterNet (eco i soroll); subtítols paraula per paraula amb emfàsi de color que evita tapar la cara; canvis de pla en cada tall; i opcions com fotos superposades (que es poden esquinçar), stickers amb so, efectes de llum (whoosh, flash, leak) i música lliure de drets. El skill requereix Node.js i Python 3.11, i funciona tant en Mac com en Windows (amb Git Bash). Inclou scripts de transcripció (Whisper), d’energia de paraules, de seguiment de cara i de generació de fons amb IA. Tot el flux de treball es guia per un `edit-config.json` que defineix talls, enfàsi, fotos i efectes. És útil per a editors de vídeo que vulguin automatitzar la creació de Reels a partir de gravacions senzilles, estalviant temps en edició manual i assegurant un estil consistent i professional.

Funciona com✓Claude Code~Codex CLI~Cursor
npx skills add tatacardona/Reels-FR-Doc-Juanes

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

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.mp4 i NOM_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 a out/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 rm fitxers de la persona: utilitza ./scripts/papelera.sh <fitxers> (Paperera del Mac o Paperera de reciclatge de Windows; es poden recuperar).
  • 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:

EtapaPassos de ClaudeCost aprox.
Preparar, transcriure i presentar el pla15-25US$ 1-2
Propostes visuals (fonts, color, llum) amb mostres8-15US$ 1-1,5
Muntar l'edició, text per aprovar i exportar la v120-35US$ 2-3
Cada ronda de canvis + nova exportació10-25US$ 1-2,5
Cercar i ajustar música10-20US$ 1-2
3 portades8-15US$ 1-1,5
Vídeo complet típic (pla, v1, 2 rondes, portades)80-130US$ 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.11 i winget 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, mira references/problemas.md i explica-li-ho a la Janeth.

Pas 1: Projecte Remotion

  • Projectes a $PROYECTOS/<MARCA>/NOM_CURT, amb <MARCA> = Doc Juanes o FR (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.css i src/Root.tsx d'un projecte anterior, i node_modules (Mac: cp -c -R, clon instantani; Windows: npm ci). Sense projecte previ: npx create-video@latest (Blank, Tailwind Yes), npm i i npm i @remotion/google-fonts@<versió de remotion>.
  • Plantilla i scripts: cp -R ~/.claude/skills/editar-reel-fr/assets/template/src/Reel src/Reel i mkdir -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

  1. Extreu un fotograma ("$FF" -ss 20 -i cru -frames:v 1 x.jpg) i mira'l: orientació (si la persona surt de costat utilitza ccw/cw), color de la paret (decideix el color de les paraules clau) i posició de la cara (FACE_ORIGIN).
  2. FF="$FF" ./scripts/prep.sh "<cru>" <none|ccw|cw> → public/video-vertical.mp4 (amb la corba d'il·luminació que aclareix ombres; LIGHT=0 la treu) + àudios a work/.
  3. Si demana millorar el fons o la llum (fons carregat, cara fosca per llum de dalt): scripts/fondo-luz.py separa la persona amb IA i crea public/video-fondo.mp4 amb fons difuminat, llum de farcit que segueix la cara i, si es vol, llums de colors tipus vitrall a la paret. Ajustos a edit-config.json → "fondo" (vegeu l'encapçalament del script); s'executa després de build-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 amb VIDEO_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, vegeu estilo.md), flash (llampec blanc). zoom fixa 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 a assets/edit-config.stickers.example.json): {kind, show_at, hide_at, x, y, size, sfx: [[fitxer, seg, volum]]}. Tipus: broken-heart (break_at) i dibuixos de ART a src/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: true donen 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) i EMPH2_* (segona, paraules marcades "alt" a emphasis) a constants.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ó]

Habilidades Relacionadas