Communitygithub.com

beachyphotoandfilm-arch/video-skills

Diseña miniaturas y títulos para videos de persona hablando. Extrae fotogramas con grado de color del material original, renderiza variantes con la marca en dos diseños probados y las prueba en tamaño de teléfono, donde realmente se decide el clic.

¿Qué es video-skills?

Este skill automatiza la creación de miniaturas y títulos para videos de tipo 'talking head', basándose en investigaciones sobre qué funciona mejor en YouTube. Extrae fotogramas clave del material original en 4K, aplica un grado de color (LUT) y renderiza variantes con la marca en dos diseños: 'full-bleed' (predeterminado, ideal para móvil) y 'panel' (con espacio para diagramas o dos líneas de texto). Las reglas integradas incluyen no tapar la cara, usar 3-5 palabras, una expresión facial fuerte y evaluar el resultado a ~210px (tamaño de vista en móvil). El skill también genera una hoja de contacto para seleccionar el mejor fotograma y una hoja de prueba en tamaño teléfono. Está diseñado para ejecutarse con Puppeteer (headless Chrome) y requiere que las fuentes de visualización estén instaladas localmente. Se activa con comandos como 'make thumbnails', 'thumbnail for this video', 'title and thumbnail' o después de editar un video.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/beachyphotoandfilm-arch/video-skills/tree/HEAD/skills/video-thumbnails

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

Miniaturas y títulos

Configura tu marca aquí

Edita el bloque :root al inicio de scripts/layout-fullbleed.html y scripts/layout-panel.html:

ajustevariable CSSvalor predeterminado
color de acento--brand-accent (+ --brand-accent-rgb como r,g,b)#4a90e2
color de texto claro--brand-light#f2f2f2
color de tinta oscura (trazo, fondo del panel)--brand-ink#0d131a
fuente de visualización (texto grande)--font-display'Anton','Bebas Neue',Impact,sans-serif
fuente del cuerpo (texto pequeño)--font-body'Inter',sans-serif

La fuente de visualización debe estar instalada localmente, ya que el renderizado se ejecuta en headless Chrome desde file://. Anton y Bebas Neue son gratuitas en Google Fonts.

También configura tu LUT de gradación en scripts/frames.sh (LUT_DEFAULT), o pasa LUT=/ruta/al/archivo.cube por ejecución.

Valores predeterminados de estilo (ajusta a tu gusto)

  1. Nunca pongas nada sobre la cara. Sin degradado ni máscara sobre el sujeto. Usa un panel de borde duro con la cara completamente visible, o full-bleed con texto en espacio vacío.
  2. Extrae fotogramas del RAW 4K, no de una exportación. Los fotogramas exportados a 1080p se ven suaves.
  3. Primero aplica el grado de color al fotograma. El material log (S-Log3, etc.) es plano y gris sin gradar. Aplica la LUT con lut3d (ver frames.sh). Omite la LUT si la cámara graba un perfil final.

Reglas que surgieron de la investigación

  • De tres a cinco palabras, y menos es mejor. La miniatura no es para explicar el video.
  • Una cara gana. La mayoría de los videos de éxito usan una. Una expresión fuerte gana a una neutra.
  • Un sujeto dominante, dos o tres colores, alto contraste.
  • Evalúalo a ~210px. La mayoría de las decisiones de visualización se toman en el móvil. Si no funciona ahí, nada más importa.
  • El título y la miniatura no deben repetirse. Dos mitades de una misma idea. Mantén los títulos cortos y específicos (aproximadamente 50-60 caracteres para que no se trunquen).
  • El A/B testing en YouTube Studio es mejor que discutir, así que dale al usuario 2-3 opciones reales.

Qué diseño usar

Full-bleed gana en tamaño de móvil y es el predeterminado. A 210px, la cara se ve aproximadamente el doble de grande que en la versión de panel, y las sublíneas del panel desaparecen por completo.

  • layout-fullbleed.html: fotograma con grado de color de borde a borde, 1-3 palabras en la fuente de visualización con un trazo de tinta grueso, colocado en espacio vacío (pared, puerta) y nunca sobre la cara. Preajustes stab, stat, bottom, band (una banda de acento sólida en la parte inferior). Ejemplos de variantes heredadas e, f, g, h.
  • layout-panel.html: sujeto en un panel cuadrado limpio a la derecha, texto en una mitad oscura a la izquierda. Úsalo cuando la idea necesite un diagrama (la cuadrícula de puntos) o dos líneas de texto. Variantes de ejemplo a-d.

Ejecútalo

# 1. fotogramas con grado de color del material original, en momentos expresivos (usa la transcripción para encontrarlos)
bash <skill>/scripts/frames.sh "<TU_UNIDAD_DE_MATERIAL>/<carpeta>/C0001.MP4" "<trabajo>" 178 310 459 503

# 2. míralos antes de elegir: una hoja de contacto es mejor que adivinar
ffmpeg -i hi-*.jpg -filter_complex hstack=... contact.jpg

# 3. renderiza variantes + la hoja de prueba en tamaño teléfono
WORK=<trabajo> OUT=<salida> node <skill>/scripts/render.mjs variants.json

variants.json:

[{"id":"E-no-time","layout":"fullbleed","v":"e","img":"full-C0001-503.jpg"},
 {"id":"S-custom","layout":"fullbleed","img":"full-C0001-310.jpg",
  "data":{"preset":"stab","head":"¿DEMASIADO OCUPADO?","kicker":"PRUEBA ESTO"}},
 {"id":"B-3x","layout":"panel","v":"b","img":"cut-C0001-97.jpg"}]

El texto del full-bleed se puede pasar por variante como data (preset, head, kicker, side, size), o añadir como un nuevo bloque heredado v en el HTML del diseño. El texto del panel vive en los bloques v de layout-panel.html; añade una nueva variante agregando un bloque, manteniéndolo en 3 palabras.

Necesita puppeteer-core: reutiliza ../video-overlays/scripts/node_modules o npm i en el directorio de scripts. render.mjs lanza /Applications/Google Chrome.app/...; cambia la ruta en otros sistemas.

Cómo elegir el fotograma

Busca cejas levantadas, una mano abierta, boca a mitad de palabra. Usa la transcripción para encontrar un momento con energía, luego extrae un fotograma un segundo después. Los fotogramas con mirada muerta arruinan la miniatura. Los recortes en frames.sh asumen una fuente 4K (3840x2160) con el sujeto a aproximadamente 46% del ancho del fotograma; ajusta los desplazamientos de crop= si tu encuadre es diferente.

Salida

Renderizar a 1920x1080 (YouTube reduce la resolución limpiamente), mantener por debajo de 2 MB.

Relacionados

  • paper-edit, video-overlays: el resto del flujo de video

Individual skills in this repo

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

beachyphotoandfilm-arch/video-skills

Sync camera footage to a separate lapel or field-recorder track (e.g. Tascam DR-10L and similar) and lay it up in DaVinci Resolve. Stitches the recorder's split files, finds each clip's exact place in the audio by matching words then waveforms, cuts one lapel slice per clip so every later skill works unchanged, checks for clipping, and builds a synced timeline in a new Resolve project. Trigger on "sync the lapel", "sync my audio", "line up the recorder", "I used a lav", or any shoot with a separate audio folder (live talks, events, workshops). Run it before paper-edit or video-reels.

beachyphotoandfilm-arch/video-skills

Turn raw talking-head footage into an assembled rough cut inside DaVinci Resolve. Pulls the clips off your footage drive, transcribes them locally, removes failed takes, restarts, asides and dead air, then creates a new Resolve project with two paper-edit timelines ready for your fine trim. Trigger on "paper edit", "cut my raw footage", "make a rough cut", "clean up this video", or when the user points at a folder of raw camera files for a YouTube video.

beachyphotoandfilm-arch/video-skills

Design a unique Instagram cover for each reel in your house style. Reads what the reel is about, writes a short hook headline, picks one of your own photos from a tagged photo library, lays it out like your existing covers, and proofs it in grid view at phone size. Renders locally, never with AI image generation. Can be called by a scheduling skill before reels are scheduled. Trigger on "make covers", "reel covers", "cover photo for this reel", "design the IG covers".

beachyphotoandfilm-arch/video-skills

Render finished reels out of DaVinci Resolve, write captions in the creator's voice, attach a custom Instagram cover from reel-covers, and schedule them to Instagram, TikTok and YouTube Shorts through Metricool. Handles the Drive upload hop, collision checks against the existing calendar, and cleanup. Trigger on "schedule the reels", "post these", "put these on the calendar", or after reels are approved.

beachyphotoandfilm-arch/video-skills

Build animated brand overlays (motion graphics) for a talking-head video, timed to the speaker's exact words, plus a DaVinci Resolve import file. House style is in-scene type (text beside and behind the speaker's head) plus diagrams. Transcribes the rough cut locally, picks the moments, renders transparent .mov clips, and writes an FCPXML that drops every clip onto the timeline already in position. Trigger on "make animations for this video", "add overlays/motion graphics", "animate this", "b-roll graphics for my YouTube video", or when the user shares a rough cut and asks for graphics.

beachyphotoandfilm-arch/video-skills

Cut vertical Instagram reels out of a long-form talking-head video, hook first. Picks the strongest standalone moments from the transcript, opens each reel on its punchiest line, builds vertical timelines in DaVinci Resolve framed on the speaker's face with the LUT applied, and finishes them: a hook (a held text card, or a word-by-word "build" hook with punch-in) and burned-look captions on V3; this-or-that reels get product graphics and a comment-keyword CTA card. You trim and render, nothing to import. Trigger on "make reels", "clip this for Instagram", "cut some verticals", or after a YouTube video is cut.

beachyphotoandfilm-arch/video-skills

Run the whole YouTube video pipeline end to end, one stage at a time, stopping for the creator's approval at every gate. Paper edit, punch-ins, reels, reel covers, scheduling the reels, overlays, thumbnail and title, then scheduling the long-form video, all through Metricool. Keeps state per video so you can stop anywhere and pick up later. Trigger on "/youtube", "let's do the whole video", "run the video pipeline", "continue the <name> video", or when handed raw footage for a YouTube video.

Skills relacionados