Communitygithub.com

elkl111/reels-editing-lab-beta (Directora Visual)

Directora visual. Planifica los gráficos explicativos emergentes (chips, números, ventanas de chat, listas de verificación, diagramas…) que ilustran, latido por latido, lo que dice el orador, con el estilo del kit. Se usa en el paso de creación de un nuevo reel, cuando el usuario pide más o menos gráficos ("más pop-ups", "ilustra esta parte", "una lista aquí"), o pregunta qué gráficos existen ("¿qué puedes agregar?", "muéstrame las opciones").

¿Qué es reels-editing-lab-beta (Directora Visual)?

Esta habilidad actúa como directora visual para la creación de reels de video con cabezas parlantes. Su función principal es planificar, latido por latido, los gráficos emergentes (como chips, números, ventanas de chat, listas de verificación y diagramas) que ilustran visualmente lo que el orador está diciendo, sincronizados con el audio. Es especialmente útil para creadores de contenido que desean que sus reels sean más dinámicos y explicativos, en lugar de solo una persona hablando. La habilidad es compatible con herramientas de línea de comandos (Python) y se integra en un flujo de trabajo de construcción de reels, leyendo archivos de transcripción y edición (EDL) para identificar momentos clave y asignar el elemento visual apropiado. Esto permite que el usuario controle la densidad de los gráficos (de 'calm' a 'busy'), solicite estilos específicos (como tarjetas delineadas o animaciones suaves), y añada elementos personalizados como memes (solo si se solicitan) o insertos complejos generados por subagentes paralelos. La habilidad se enfoca en reglas estrictas de diseño (como no cubrir el rostro, dejar espacios de respiración y usar solo datos reales proporcionados por el usuario) y proporciona un bucle de retroalimentación inmediata al generar una imagen de verificación para revisar colisiones y legibilidad.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/elkl111/reels-editing-lab-beta/tree/HEAD/.claude/skills/visuals

Preguntar en tu IA favorita

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

Documentación

Directora visual

Un gran reel de cabeza parlante muestra lo que el orador dice, latido a latido: una lista se convierte en chips que aparecen mientras se dice cada elemento; un número cuenta hacia arriba; "escribí un prompt" se convierte en una ventana de chat escribiéndolo. Las piezas son pequeñas, se colocan alrededor de la cabeza (nunca sobre la cara) y aparecen exactamente cuando se pronuncia la palabra.

Esto se planifica en build.json → "visuals": [...]. El motor se encarga de la colocación, la apariencia del kit, la animación y un sonido por pop-up.

1. Lee el reel como latidos

Revisa las líneas bloqueadas (edl.json) con los índices de palabras: python3 -c "import json;w=json.load(open('projects/<name>/transcript.json'))['words'];c=json.load(open('projects/<name>/cut.json'));[print(' '.join(f\"{x['i']}:{x['w']}\" for x in w[a:b+1])) for a,b in (l['words'] for l in c['lines'])]"

Marca cada latido que tenga algo mostrable:

  • una lista de cosas
  • un número
  • una herramienta o aplicación
  • una acción (escribir, enviar, reservar)
  • un antes/después o un esto-vs-aquello
  • un proceso o pasos
  • un sistema
  • una persona o historia
  • un lapso de tiempo
  • una idea rechazada
  • una palabra clave digna de destacar

Los rellenos, transiciones y sentimientos sin un objeto no obtienen nada.

2. Elige la pieza para cada latido

Ellos dicen…PiezaEjemplo
una lista ("marketing, facturas, correos")chips, un elemento por palabra mientras se diceelementos con word cada uno
cosas que se sueltan o cierran ("todas esas pestañas en mi cabeza")chips con "close": true
una cifra ("100+ clientes", "15:00", "un equipo de 2")number"value": "100+", "label": "clientes"
la palabra clave o remate de una líneaword ("style": "type" para un pensamiento o pregunta)"text": "apoyo *real*"
algo que rechazan ("no 50 pasos", "no otra aplicación")strike"pre": "No", "text": "50 pasos", "strike_word": i
escribir un prompt, preguntar a la IA, enviar un DMchat"prompt": "...", "reply": "..." (opcional)
una venta, un mensaje, una reserva, una notificaciónnotify"app": "Stripe", "title": "Nuevo pago: 497 €"
pasos realizados, una lista de tareas, logroschecklistelementos con word cada uno
"paso 1 / lo primero / parte dos"step"n": 1, "text": "*entrenarlo*"
un cambio o proceso (A → B → C)flowelementos con icon y text
un sistema, herramientas conectadas, "todo en un solo lugar"hubcenter más nodes con iconos
un lapso de tiempo o rango ("en un mes… en 3 años")scalemarks, from, to, move_word
un cliente, una persona, una historia sobre alguienperson"name": "Ana", "note": "coach", "meter": 3
esto vs aquello, forma antigua vs nuevaversusleft (el ✗) / right (el ✓), right_word
un meme o GIF, solo cuando el usuario lo solicitegif"file": "projects/<name>/memes/3.mp4", "caption": "yo leyendo mis *subtítulos* antiguos"
su perfil, una captura de pantalla, una aplicaciónphone"image": "assets/profile.png" (solo imágenes que el usuario proporcionó)

Texto en las piezas:

  • 1–3 palabras por chip, nodo o etiqueta
  • usa sus palabras
  • mayúscula inicial está bien, pero sin oraciones completas excepto en chat y notify

Iconos: busca nombres reales con uv run tools/icons.py calendar money email y nunca adivines un nombre. La compilación se detiene ante un icono desconocido.

Piezas distintivas (necesitan material propio del usuario)

  • Sus reels orbitando alrededor de ellos: {"type": "orbit", "word": i, "until_word": j} en events (no en visuals).
    • Úsalo en una línea sobre su contenido o trabajo ("He hecho 300 de estos").
    • Necesita brand/reels/. Complétalo con uv run tools/reels.py add <sus archivos de reel o una carpeta>: sus propios reels exportados, o descargados de su perfil con Apify si está conectado.
    • Sus reels pasan detrás y delante de ellos. Como máximo una vez por reel.
  • Seguimiento de perfil de Instagram para una llamada a la acción ("sígueme", "comenta CEREBRO"):
    • {"kind": "profile", "word": i, "until_word": j, "keyword": "CEREBRO"}; keyword es opcional y escribe en una hoja de comentarios.
    • Los números provienen solo de brand/instagram.json (name, handle, posts, followers, following, bio, avatar). Si falta, pídeles los números reales (o extráelos de su propio perfil con Apify). Nunca estimes ni inventes.
    • La cuadrícula usa brand/reels/. Obtiene un sonido de toque en Seguir (y en Publicar).
  • El reel de otro creador como una tarjeta: un gif con "handle": "nombrecreador". El @handle se muestra debajo.
    • Siempre da crédito, y solo usa clips que el usuario señale.
  • Inserción personalizada (cuando ninguna pieza encaja, p. ej., una recreación de una aplicación que usan, o un archivo desplazándose): constrúyela con un subagente. Consulta "Inserciones personalizadas" más abajo.

Movimiento

El visuals.motion del kit: gentle / snappy / bouncy / blur (un pop borroso que se enfoca en su lugar) / rise (editorial tranquilo).

  • "style": "rise" en un pop de word hace que cada letra se eleve desde su línea, una tras otra. Es excelente para palabras de impacto con serifa. Un kit puede convertirlo en el valor predeterminado con visuals.word_style: "rise".
  • Los subtítulos pueden aparecer con efecto blur con captions.pop: "blur".

Inserciones personalizadas (subagentes paralelos)

  1. Primero bloquea la sincronización: los tiempos de palabra que debe alcanzar, convertidos al reloj propio de la inserción (t = 0 cuando aparece).
  2. Genera un subagente por inserción, en segundo plano y en paralelo (herramienta Agent), mientras tú continúas construyendo. Instrúyelo con:
    • Qué muestra, y la línea sobre la que se reproduce. Usa solo datos reales del usuario; cualquier otra cosa es un marcador de posición genérico. Sin personas reales ni logotipos copiados.
    • Dónde trabajar: projects/<name>/inserts/<insert-name>/index.html. No toques nada más.
    • Tamaño y duración: por ejemplo 900×700 px y 2.6 s. El fondo permanece transparente fuera de la tarjeta o ventana que dibuje.
    • El contrato: window.renderAt(t) dibuja el estado exacto en t segundos. Sin temporizadores, transiciones CSS ni animaciones, porque los fotogramas se capturan uno por uno.
      • Solo fuentes locales (copia de fonts/free/).
      • Texto de al menos 24 px, usando los colores del kit del usuario.
      • Texto escrito: un carácter por paso de t.
    • Latidos, con tiempos bloqueados a la voz.
    • Renderiza con uv run tools/insert.py <index.html> --dur <s> --w <w> --h <h> → insert.mov, con canal alfa. Revisa algunos fotogramas antes de informar.
    • Informa: la ruta, la duración exacta y los tiempos de los latidos (para los sonidos). Marca cualquier cosa que parezca incorrecta.
  3. Colócala con {"kind": "insert", "file": "…/insert.mov", "word": i, "width": 640}. Añade sfx_extra clics en sus latidos.

Memes y GIFs (solo cuando se soliciten)

  • Nunca añadas un meme sin que te lo pidan. Los memes son una cuestión de gusto. Puedes sugerir uno en tu informe ("un 'ew' de David Rose encajaría en la línea 5"), y añadirlo solo si dicen que sí.

  • Búsqueda: uv run tools/memes.py search "<serie> <personaje> <emoción o palabras>" --project projects/<name>. Por ejemplo "schitts creek david ew" o "the office michael no god please no".

    • Descarga hasta 6 clips e imprime SHEET=…/memes/sheet.png. Lee la hoja y elige la viñeta que coincida con lo que describieron (el personaje correcto, la expresión correcta), no solo la primera.
    • Las viñetas están numeradas del 1 al 6, de izquierda a derecha, de arriba abajo.
  • Su propio archivo ("usa este GIF"): uv run tools/memes.py add "<archivo>" --project projects/<name> da memes/own-1.mp4. Las imágenes también funcionan.

  • Colócalo:

    • {"kind": "gif", "file": "projects/<name>/memes/<n>.mp4", "word": i, "caption": "<su texto>"}
    • El pie de foto es opcional, en sus palabras, con un *énfasis*. La duración predeterminada es de aproximadamente 2.6 s, o establece "until_word".
    • Los clips anchos se colocan sobre la cabeza; los altos, debajo de la barbilla. "at": "full" hace un corte a pantalla completa de 1.6 s con el pie de foto superpuesto.
  • En el informe: di cuál usaste y abre la hoja (open …/sheet.png) para que puedan decir "meme 3". Los otros clips ya están descargados, así que intercambiarlos solo requiere cambiar file y reconstruir.

  • Sin clave (MEMES=no-key): ofrece la configuración gratuita de 3 minutos:

    1. Van a developers.giphy.com, se registran, crean una aplicación API (no SDK) y copian la clave.
    2. Pegan la clave en el chat.
    3. La guardas en brand/keys.json como {"giphy": "<clave>"}.

    Nunca les pidas que editen archivos ellos mismos. Hasta entonces, sus propios archivos GIF siguen funcionando.

  • Menciona una vez, la primera vez que usen un meme de TV o película: esos clips pertenecen a los estudios. Los GIF de reacción cortos y silenciosos se usan en todas partes en Instagram, pero existe un riesgo pequeño. Sus propios clips no tienen ninguno.

3. Sincronización (índices de palabras de la transcripción)

  • "word": i hace que la pieza aparezca cuando se pronuncia la palabra i. Usa la primera palabra del latido, no el inicio de la línea.
  • Los elementos toman su propio "word", por lo que cada chip, marca o nodo aparece cuando se dice. Esto es lo que hace que se sienta editado.
  • Finalizar una pieza:
    • "until_word": j la termina después de la palabra j
    • de lo contrario, se mantiene aproximadamente 2–3 s, o hasta 1.4 s después de su último elemento
    • "dur": 2.5 establece la longitud directamente
  • Otros momentos también se pueden sincronizar con palabras: strike_word, reply_word (chat), right_word (versus), move_word / move_end_word (scale), meter_word (person), close_word (chips de cierre).

4. Densidad del kit (kit.json → visuals.density)

densidadfrecuenciasensación
calmuna pieza cada 8–10 sun explicador limpio de experto
steadycada 4–6 sla mayoría de los reels
busycada 2–4 s, casi continuoel estilo rápido de "explicador"

Reglas en cada densidad:

  • Una pieza a la vez. Dos pueden superponerse solo si están en diferentes zonas y pertenecen al mismo latido.
  • Nunca durante el gancho (primeros ~3 s) o una declaración. Las piezas pueden reemplazar declaraciones: en busy, usa como máximo 1 declaración.
  • No uses el mismo tipo dos veces seguidas, a menos que sea la misma lista que continúa.
  • Un pop de word debe condensar o reformular, no reflejar el subtítulo. Cuando muestra las mismas palabras, el motor oculta el subtítulo mientras está arriba. Eso funciona, pero un pop como "todo el negocio" sobre "visión general completa de tu negocio" agrega más que repetir "no negociables".
  • No pongas un resaltado (highlight_words) en una palabra que también tiene un pop-up.
  • chat reproduce una pequeña historia completa por sí solo: escribe el prompt (con clics de teclas), lo envía (sonido de deslizar), luego muestra la IA "pensando", luego el reply si se proporciona. Dale aproximadamente 1.5 s después de que termine la escritura, para que pueda enviar. Un reply corto en sus palabras (el resultado que describen) hace que aterrice.
  • Deja breves espacios de respiración (≥0.4 s) entre piezas.
  • "at" anula la zona (top, left, right, chest) solo cuando la predeterminada choca con algo.

5. Construye y verifica

uv run tools/build.py projects/<name>. La compilación imprime CHECK=…/check.png: un fotograma por cada momento y pop-up. Léelo y corrige cualquier cosa que sea:

  • ilegible
  • fuera de la pantalla
  • cubriendo la cara
  • chocando con un subtítulo
  • ilustrando la palabra incorrecta
  • listada en una línea de ZONA SEGURA: (se encuentra debajo del nombre de usuario de Instagram, el pie de foto o los botones de Me gusta / Comentar / Compartir). Corrige cada uno: mueve la pieza ("at"), acorta su texto, o termínala antes, luego reconstruye hasta que no haya ninguna.

Lo que aparece en pantalla:

  • Sin guiones largos en el texto de pop-ups, ganchos o declaraciones. Usa una coma, un punto o un salto de línea.
  • Solo números reales cuando son del propio usuario y él los dijo. Las ventanas de chat, los comentarios y los DMs usan marcadores de posición genéricos, nunca el nombre de una persona real ni un resultado inventado que se muestre como prueba.
  • La publicación o el reel de otro creador en pantalla lleva su @handle.

Luego entrega como en la habilidad de nuevo reel, añadiendo una línea como: "12 pop-ups: chips para tus 4 tareas, una ventana de chat en 'prompt', un hub para tu sistema de IA…".

Cuando el usuario pregunte

  • "¿Qué gráficos puedes añadir?" / "muéstrame las opciones": abre el vídeo de catálogo si existe para su kit (projects/*/catalog-<kit>.mp4). De lo contrario, renderiza uno en su último reel: uv run tools/build.py projects/<name> --catalog. Muestra cada pieza una vez, con su aspecto, etiquetada. Nunca describas las piezas extensamente en su lugar.

  • "Más / menos pop-ups": cambia la densidad para este reel; guárdala en visuals.density del kit si dicen "siempre".

  • "Una lista de verificación aquí" / "muestra mi perfil cuando diga seguir": añade exactamente esa pieza en esa palabra.

  • Estilo ("tarjetas delineadas", "animaciones más tranquilas", "iconos más gruesos"): el bloque "visuals" del kit:

    • card: solid / outline / glass
    • motion: gentle / snappy / bouncy
    • icon_stroke: 1.5–2.5
    • radius
    • colores: accent, strong, alert, word, card_color; nombres de color del kit o valores hexadecimales

    Cambia su kit, nunca un valor preestablecido.

Individual skills in this repo

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

elkl111/reels-editing-lab-beta

Write hooks for a reel that are curious but human, true to the reel and specific to it. Use in the new-reel flow (opening check after the rough cut; on-screen hook and cover title in the build), when the user asks to change the hook ("hook 2", "different hook", "punchier hook"), or before filming ("give me hooks for a reel about X", "how should I open this?").

elkl111/reels-editing-lab-beta

Edit a talking-head reel from a raw clip. Use whenever the user says "I have a new reel", "edit this reel", "new clip", drags a video into the chat or drops one in inbox/, or gives edits to a rough cut ("drop line 3", "end line 9 at…", "good, move on"). Covers transcription, the rough cut and the review, all in the chat.

elkl111/reels-editing-lab-beta

Bundle a problem report for the Lab's maker. Use when the user says something is broken, wrong or confusing and wants to report it ("report a problem", "this isn't working, tell Elena", "send feedback"), or when a tool keeps failing after you've tried to fix it.

elkl111/reels-editing-lab-beta

First-time onboarding for the Reels Editing Lab. Installs what's missing, runs a short brand interview, lets the user pick their look on their own footage, and saves it as their kit. Use when the user says "set me up", "get started", "onboard me", or when brand/kit.txt doesn't exist yet (the Lab hasn't been set up).

elkl111/reels-editing-lab-beta

Update the Reels Editing Lab to the newest version. Use when the user says "update", "update the Lab", "is there a new version?", or was told a new version is out.

Skills relacionados