Communitygithub.com

beachyphotoandfilm-arch/video-skills

Diseña una portada única de Instagram para cada reel con el estilo de tu marca. Lee de qué trata el reel, escribe un titular breve, selecciona una de tus propias fotos de una biblioteca etiquetada, la maqueta como tus portadas existentes y la prueba en vista de cuadrícula en tamaño de teléfono. Se renderiza localmente, nunca con generación de imágenes por IA. Puede ser invocada por una habilidad de programación antes de programar los reels. Actívala con "hacer portadas", "portadas de reel", "foto de portada para este reel", "diseñar las portadas de IG".

¿Qué es video-skills?

Esta habilidad automatiza la creación de portadas personalizadas para cada reel de Instagram, manteniendo la coherencia visual de tu marca. Lee la descripción del reel y el titular de apertura para generar un titular breve y atractivo, selecciona una foto real de tu biblioteca etiquetada que coincida con el tema y el espacio disponible, y la maqueta siguiendo tu estilo visual predefinido (tipografía, colores, disposición). El proceso es completamente local: usa Puppeteer para renderizar imágenes en 1080x1920 píxeles y genera pruebas de vista de cuadrícula y de teléfono para verificar la legibilidad y composición. No utiliza generación de imágenes por IA, sino que combina tus fotos reales con tus diseños de portada. La habilidad está diseñada para trabajar junto con otras habilidades, como una de programación de reels, y se activa mediante comandos como "hacer portadas" o "diseñar las portadas de IG". Incluye reglas de unicidad para evitar repeticiones de fotos, diseños o tipos de titulares, y permite ingresar fotos tanto desde una carpeta local como desde Canva.

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

Preguntar en tu IA favorita

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

Documentación

Portadas de reel

Cada reel tiene su propia portada. Está hecha con tus fotos reales y con tu tipografía real, y mantiene el texto dentro de la parte que Instagram muestra en la cuadrícula del perfil.

Configuración: define tu marca aquí

Edita esto una vez antes de la primera ejecución.

ajustedóndepredeterminado
color de acento--brand en scripts/cover.html#3b82f6
fuente del titular--display-font en scripts/cover.htmlAnton (gratuita, Google Fonts)
fuente del subtítulo.sub en scripts/cover.htmlMontserrat Bold (gratuita)
subtítulo predeterminadotus portadasp. ej. "de un Cocina Casera", o ninguno
carpeta de fotosphotos_dir en library.json<RUTA_A_TUS_FOTOS_DE_PORTADA>
carpeta de fotos de Canva (opcional)canva_folder en library.json<ID_DE_TU_CARPETA_DE_CANVA>
documento maestro de portada de Canva (opcional)referencia para tu estilo actual<ID_DE_TU_DOCUMENTO_MAESTRO_DE_PORTADA_DE_CANVA>
diseño de borrador de Canva (opcional)utilizado para exportar fotos desde Canva<ID_DE_TU_DISEÑO_DE_BORRADOR_DE_CANVA>
registro de portadasvariable de entorno COVER_LOG para pick.pydrafts/social/cover-log.json en la raíz del proyecto
destino de las portadas terminadaspaso 8<TU_CARPETA_DE_VIDEO>/<Video> AAAA-MM-DD/Portadas/
palabras prohibidasreglas de hooks.mdtu lista (p. ej. un nombre de oferta anterior)

Diseñado para Instagram. La portada puede usarse en una publicación normal de IG + TikTok + Shorts como miniatura del video (por ejemplo, videoThumbnailUrl de Metricool). Solo la cuadrícula de Instagram importa para el diseño. Nunca reemplaces una portada que una publicación ya tenga.

Nunca generes la imagen con IA. Los fondos son tus fotos y los diseños se copian de tus portadas. El código solo las organiza.

Estilo de casa predeterminado (cambia a gusto)

Consulta solo tus portadas más nuevas en tu documento maestro. Los estilos anteriores que hayas dejado atrás no cuentan.

  • Una foto brillante y neutral tuya con un accesorio relevante (portátil, cámara, teléfono, producto), con una pared lisa donde va el texto.
  • El titular en fuente de visualización blanca, TODO EN MAYÚSCULAS siempre, centrado, de 2 o 3 líneas, bastante pequeño.
  • Un subtítulo opcional en Montserrat Bold, mayúsculas y minúsculas normales.
  • Predeterminado: sin sombra, sin contorno, sin banda ni oscurecimiento detrás del texto, sin texto de color de acento.
  • Sin etiquetas, sin tipo inclinado, sin fuentes de script o cursivas, sin diseños de números grandes o series.
  • El único extra: una flecha dibujada a mano simple de color de acento, de vez en cuando.
  • Nada debajo del ícono del reel: la cuadrícula de Instagram lo coloca en la esquina superior derecha de cada mosaico. render.mjs advierte si algo se encuentra en x superior a 760 e y inferior a 540.

Las reglas de titulares, tipos de ganchos y etiquetas están en hooks.md. Léelo antes de escribir un titular.

Archivos

scripts/cover.htmlel único diseño: titular + subtítulo opcional, más los extras arrow / inset / avatar. Configuración de marca en la parte superior.
scripts/render.mjsrenderiza JPG de 1080x1920 + ambas pruebas, y advierte sobre texto fuera de la zona segura o archivos de más de 8 MB
scripts/pick.pypreselecciona fotos por tema, bloquea las últimas 9 usadas, e imprime los diseños y tipos de ganchos recientes
library.jsoncada foto, etiquetada (pose, accesorios, dónde está el espacio vacío, punto de enfoque). Incluye un ejemplo; crea el tuyo propio.
registro de portadas (COVER_LOG)cada portada enviada. Esto es lo que las mantiene únicas
photos_dirtus fotos de alta resolución (solo local, mantenlas fuera de git)

scripts/ necesita puppeteer-core (npm i puppeteer-core en scripts/, o un enlace simbólico scripts/node_modules a la instalación de otra habilidad) más Google Chrome y ffmpeg. render.mjs apunta a la ruta predeterminada de Chrome en macOS; cambia executablePath si la tuya es diferente.

Ejecútalo

1. Conoce el reel. Necesitas la transcripción, el pie de foto y la tarjeta de texto de apertura de cada reel. Nombra la única promesa que hace el reel.

2. Titular. Elige un tipo de gancho que no sea el tipo de la última portada (pick.py lo imprime). Escribe 3 o 4 opciones, de 3 a 8 palabras cada una, y elige la más fuerte. No debe repetir la tarjeta de texto de apertura palabra por palabra.

3. Foto.

python3 .claude/skills/reel-covers/scripts/pick.py "<palabras del tema>" --space top

Luego mira las 3 o 4 mejores antes de elegir (crea una hoja de contacto con ffmpeg). Relaciona el accesorio con el tema: portátil para correo electrónico, sistemas o sitio web; cámara o producto para equipo; tú hablando para ventas y mentalidad. Para historias de clientes, usa un recuadro o avatar del cliente (con permiso).

4. Diseño. No el mismo que el de la última portada (consulta pick.py). Coloca el texto en el espacio vacío de la foto (space), establece focus para que la cara quede despejada, y establece y para que el bloque de texto quede entre 300 y 1250.

5. Renderiza.

OUT="<trabajo>/covers" node .claude/skills/reel-covers/scripts/render.mjs covers.json
{"covers":[{"id":"3-el-cierre-exacto","img":"<RUTA_A_TUS_FOTOS_DE_PORTADA>/<archivo>.jpg",
  "data":{"head":"el cierre exacto que uso en llamadas de ventas","sub":"de un Cocina Casera","y":560,"headroom":280}}],
 "history":["<últimos archivos de portada enviados del registro de portadas, del más nuevo al más antiguo>"]}

Expande ~ a una ruta real; render.mjs no lo hace. Una salida distinta de cero significa una advertencia, así que arréglala antes de compartir.

6. Revísalo tú mismo primero. Abre _proof.png y _grid-phone.png:

  • ¿Es legible el titular en la prueba de cuadrícula (130 px de ancho)? Si no, reduce las palabras.
  • ¿La cara está libre del texto tanto en la portada completa como en el recorte de la cuadrícula?
  • Junto a las otras portadas en la cuadrícula, ¿se ve diferente (foto, diseño, posición del texto) pero claramente del mismo conjunto?

7. Puerta. Muéstrale al usuario _grid-phone.png y _proof.png, con cada titular y un titular alternativo. Pregunta: "¿Estas portadas detienen el desplazamiento?" Cambia fotos o palabras a pedido y vuelve a renderizar. Tarda segundos.

8. Después de la aprobación:

  • Copia cada JPG a <TU_CARPETA_DE_VIDEO>/<Video> AAAA-MM-DD/Portadas/, nombrado como el reel (3. el cierre exacto.jpg).
  • Agrega una entrada por portada al registro de portadas: {"date":"AAAA-MM-DD","video":"<slug-del-video>","reel":"3. el cierre exacto","photo":"<archivo>","layout":"stack","hook_type":"how","head":"el cierre exacto que uso en llamadas de ventas","file":"<ruta absoluta al JPG de Portadas>"}
  • Entrega los archivos a tu paso de programación, que sube cada uno y lo adjunta a la publicación de Instagram.

Reglas de unicidad

  • Ninguna foto utilizada en las últimas 9 portadas. pick.py lo exige.
  • Nunca el mismo diseño o tipo de gancho dos veces seguidas.
  • Rota el subtítulo: ninguno, centrado, o desplazado a la derecha e inclinado (subdx, subrot).
  • Varía la posición del texto (superior, media, alineado a la izquierda o derecha) según la foto. No lo centres siempre en la parte superior.
  • Si la biblioteca se agota (cada buena foto usada recientemente), dímelo y sugiere una nueva sesión de fotos en lugar de romper la regla.

Lecciones de diseño

  • El recorte 9:16 coloca la cara arriba. La mayoría de las fotos son 2:3. Escaladas a 1920 de alto, pierden los lados, no la parte superior, por lo que una cara que se ve baja en el original se sitúa alrededor de y 600 a 800. El fallo más común es que el texto se superponga al cabello del sujeto. Mira cada prueba para detectar eso antes que cualquier otra cosa.
  • Arrégralo con headroom, no reduciendo el texto. "headroom": 150-350 empuja la foto hacia abajo y estira la pared lisa sobre el sujeto. Es invisible en paredes de estudio lisas. No lo uses en fondos exteriores con mucho detalle (los árboles y el cielo se emborronan).
  • Tamaño del titular: automático es 104 px para 4 palabras o menos, 84 px para más, encogiéndose para caber en 3 líneas.
  • Elimina el subtítulo si tocaría la cabeza. Es textura, no el mensaje.
  • Colocar el texto teniendo en cuenta el ícono del reel: o comienza el bloque en y 560 o más abajo (empuja la foto hacia abajo con headroom para que se despeje la cabeza), o mantenlo arriba y usa align: left, right: 320. Mezcla ambos en un lote.
  • Un recorte de cuadrícula 3:4 no oculta nada por encima de y 240. Mantén el texto comenzando en 280 o más abajo (render.mjs lo advierte).

Agregar fotos

Desde una carpeta local: verifica md5 contra photos_dir para duplicados, copia como <nombre>-<k>__local<MMDD>.jpg, luego etiqueta.

Desde Canva (opcional). Canva no descargará imágenes directamente de una carpeta de subidas. Una ruta viable es un diseño de borrador utilizado solo para exportaciones:

  1. list-folder-items en <ID_DE_TU_CARPETA_DE_CANVA>, y compara los IDs de los activos con library.json (mantén el ID en cada nombre de archivo después de __).
  2. read-design en <ID_DE_TU_DISEÑO_DE_BORRADOR_DE_CANVA> con open_transaction, luego una llamada edit-design con un add_page (2400x3600, título = ID del activo) por cada foto nueva. Lee los IDs de las nuevas páginas, luego una llamada con un insert_fill por página (página completa, top 0, left 0). commit.
  3. export-design como PDF, export_quality: pro, luego pdfimages -j -f <primero> -l <último> -p all.pdf ex/img. El PDF incrusta los JPEG originales intactos. La exportación JPG también funciona, pero da una URL por página.
  4. Guarda cada una como <nombre>__<idactivo>.jpg en photos_dir. Varias fotos pueden compartir un nombre de Canva, por lo que el ID las mantiene separadas. Luego etiquétalas.

Si la misma foto se subió dos veces, mantén una copia ok y marca la otra "ok": false, "note": "duplicado de N", o la regla de no repetición podría elegir la misma imagen dos veces.

Etiqueta cada archivo nuevo en library.json mirándolo:

{"file":"photo_-13.jpg","pose":"sonriendo frente al portátil","props":["portátil","escritorio"],"topics":["correo","seguimiento","sistemas","sitio web"],
 "cap":false,"space":["top"],"focus":"50% 55%","ok":true}

space es donde el texto puede ir sin tocar la cara. Marca las tomas borrosas, oscuras o extrañas como "ok":false en lugar de eliminarlas.

Relacionado

  • video-reels: la tarjeta de texto de apertura, que el titular de la portada no debe repetir
  • una habilidad de programación (opcional): sube las portadas y programa los reels

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

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

Design YouTube thumbnails and titles for a talking-head video. Pulls graded full-res frames out of the raw footage, renders brand-styled variants in two proven layouts, and proofs them at phone size where the click actually gets decided. Trigger on "make thumbnails", "thumbnail for this video", "title and thumbnail", or after a 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