Communitygithub.com

thativanng/reels-maker

Una entrevista estructurada antes de construir cualquier video. Lee el material existente, hace preguntas en rondas numeradas con una respuesta recomendada, y termina con un briefing en una pantalla que separa lo que dijo el usuario de lo que se asumió, incluyendo un storyboard. No construye nada hasta que el usuario dé el visto bueno.

¿Qué es reels-maker?

Esta skill implementa un proceso de 'intake' o entrevista previa a la creación de cualquier video (reel, explicativo, video de carrera, animación, etc.). Su objetivo es evitar costosos errores de reconstrucción que surgen cuando se construye un video sin haber aclarado preguntas fundamentales: el propósito real, la audiencia, el formato, la duración, el sonido y las restricciones visuales. La skill lee automáticamente cualquier material ya proporcionado (CV, enlaces, archivos de marca, solicitud original) y, basándose en eso, realiza hasta cuatro rondas de preguntas numeradas, siempre ofreciendo una respuesta recomendada (marcada con ★) y una razón breve. Cubre aspectos como propósito del video, formato (plataforma, relación de aspecto, diseño, duración, sonido), material existente, historia, guardarraíles estéticos y proceso de revisión. Al final, genera un briefing de una sola pantalla que separa explícitamente lo que el usuario dijo ('You said') de lo que el sistema asumió ('I assumed'), más un storyboard en tabla. Nada se construye (ni un solo fotograma) hasta que el usuario confirma con un 'sí' explícito. La skill está diseñada para ejecutarse antes de cualquier skill de estilo (reel-style) o motor de video (film-engine), y nuevamente si la solicitud cambia de propósito, plataforma o audiencia a mitad del proyecto.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/thativanng/reels-maker/tree/HEAD/skills/reel-intake

Preguntar en tu IA favorita

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

Documentación

reel-intake: pregunta antes de construir

Dónde vive el kit: ejecuta cada comando de esta skill desde la carpeta reels-maker (el clon de github.com/thativanng/reels-maker que contiene template/ y tools/). Si el proyecto no la tiene, configúrala primero siguiendo el SETUP.md de ese repositorio.

La regla: no se construye nada (sin aspecto visual, sin fotograma) hasta que la persona diga que sí al briefing y su storyboard. Los errores costosos en un video construido con código rara vez son de sincronización; son respuestas que nadie pidió. El propósito real surge después de escribir el guión. La relación de aspecto resulta incorrecta para la plataforma. El estilo visual resulta ser uno que la persona considera barato. Cada uno de esos cuesta una reconstrucción; una pregunta cuesta una línea.

0 · Mira antes de preguntar

Lee todo lo que ya está disponible y nunca preguntes algo que puedas buscar:

  • la solicitud en sí, cualquier texto fuente, enlaces, un CV, su sitio web o perfil
  • archivos de marca (colores, fuentes, logotipo) en el proyecto
  • .reels/looks-log.md, si existe (la memoria de reel-style sobre estilos pasados)

Un campo que el material responda se completa y se marca como "de tu CV", "de tu sitio", etc. Una suposición no es una respuesta: una suposición va al briefing bajo "Asumí", donde la persona puede verla y corregirla.

1 · Cómo preguntar

  • Rondas, no un formulario ni un goteo. Una ronda = un bloque a continuación, en un solo mensaje. Numera cada pregunta. Marca la respuesta recomendada con ★ y da una razón de una línea.
  • Los hechos tienen opciones (plataforma, duración, sonido). Los campos creativos reciben una sugerencia redactada para editar, nunca un espacio en blanco: "Lo único que el espectador debe recordar: ★ 'Un pronóstico es una suposición; el stock de seguridad cubre las sorpresas.' ¿Mantener, editar o reemplazar?"
  • Una pregunta que depende de una respuesta anterior se precarga con ella (la relación de aspecto sigue a la plataforma), o espera a la siguiente ronda.
  • Atajos que la persona puede escribir: defaults acepta todas las ★ de la ronda. just build it termina la entrevista: cada campo abierto se convierte en una decisión declarada en el briefing, con su razón.
  • Cuatro rondas es lo normal, cinco es el límite. Detente tan pronto como todos los campos requeridos estén respondidos o marcados por defecto.

2 · Las rondas (el banco completo de preguntas, con opciones y valores por defecto, está en references/rounds.md)

Ronda 1 · Propósito (requerido)

  1. ¿De qué trata? (solo si no se proporcionó una fuente)
  2. Lo único que un espectador debe recordar (redactado para ellos; para una solicitud vaga, ofrece 2–3 borradores)
  3. ¿Quién es el ÚNICO espectador? (un reclutador, un cliente, colegas en su campo, desconocidos fuera de él)
  4. ¿Qué debería hacer ese espectador después de verlo? (seguir · comentar · tocar el enlace · guardar o compartir · solo recordar)

Ronda 2 · Formato (requerido, los seis, en este orden; los hechos y las zonas despejadas están en references/platforms.md)

  1. ¿Dónde se publica primero? La primera plataforma es la maestra; el resto se convierten en versiones recortadas.
  2. ¿Reel o video? Pregunta solo donde la plataforma tenga ambos (LinkedIn, X, YouTube, Facebook).
  3. Relación de aspecto, por defecto según la plataforma: Reels, TikTok y Shorts → 9:16; LinkedIn → 4:5; YouTube → 16:9.
  4. Diseño: ★ deja que reel-style muestre tres, o nombra uno si ya lo saben (entonces vincula los tres looks). Indica la zona despejada; no preguntes al respecto. En Reels, TikTok y Shorts orgánicos, las palabras permanecen en la banda central (práctica de la casa, no un número de la plataforma): la aplicación cubre el cuarto inferior y la barra de botones derecha. Un reel potenciado o pagado mantiene el 35% inferior despejado (guía de anuncios de Meta); usa las claves de plataforma -ads.
  5. Duración: ¿un límite estricto, o seguir el contenido? Muestra los límites oficiales de la plataforma junto a ella.
  6. Sonido: funciona silenciado y mejor con sonido (★ por defecto) · liderado por sonido · seguro en silencio. Luego voz en off, música y estilo de subtítulos.

Ronda 3 · Material e historia (pregunta lo que corresponda)

  • ¿Qué existe ya: capturas de pantalla, grabaciones, fotos, metraje de ellos, logotipo, datos, o nada? El material faltante se convierte en un marcador de posición etiquetado, nunca en un falso.
  • Cada número: medido, un objetivo, o ilustrativo, y de dónde viene. Nunca inventes uno.
  • ¿Quién escribe las palabras en pantalla? (★ Yo redacto, tus ediciones son finales · tus palabras exactamente) ¿En qué idioma, y ortografía del Reino Unido o de EE. UU.?
  • ¿Una vez o una serie? (una serie fija un estilo visual en todos los episodios; reel-style lo maneja)
  • Una historia de viaje o carrera agrega el bloque de viaje (references/journey.md): cada rol y cada función, nombra/describe/oculta cada empleador, las afirmaciones que un colega consideraría exageradas.

Ronda 4 · Estilo, guardarraíles, revisión (requerido)

  1. 1–3 videos que les gusten, y qué les parece barato visualmente. Esta es la pregunta más costosa de omitir.
  2. Colores y fuentes de la marca (buscados primero; pregunta solo si no se encontraron).
  3. Cualquier cosa que NO deba aparecer (números, nombres, rostros, logotipos), y cualquier cosa que DEBA aparecer (nombre de usuario, tarjeta final, descargo de responsabilidad).
  4. La portada, la imagen que la gente ve antes de presionar reproducir (cuadrícula del perfil, miniatura de LinkedIn): ★ la línea de enganche, grande, sobre el look de apertura. Sin una, la plataforma elige un fotograma por ti (en LinkedIn supuestamente el primero; no verificado), que rara vez es el mejor.
  5. Cómo quieren revisar: ★ imágenes fijas → una tira de 10 segundos → la película completa después de la verificación independiente → una vista previa en el teléfono.

3 · El cierre

  1. Verificación de conflictos. Lee las respuestas entre sí antes de escribir el briefing:
    • 9:16 para LinkedIn → sugiere 4:5
    • liderado por sonido en LinkedIn → los subtítulos grabados son obligatorios
    • un guión largo en la banda central de un reel 9:16 (el cuarto inferior despejado; 35% si es pago) → corta palabras, no tamaño de letra
    • más de 3 minutos en Instagram → no se recomendará a nuevas audiencias
  2. El briefing, en una pantalla (plantilla en references/brief.md), guardado como reels/<nombre-corto>/brief.md: cada reel recibe su propia carpeta. Divídelo en Dijiste y Asumí (y por qué). Incluye la línea de formato: plataforma → reel o video → relación de aspecto y tamaño → diseño y zona despejada → duración → sonido.
  3. La tabla del storyboard: tiempo · palabras en pantalla, exactamente como aparecerán · sonido y subtítulos · por qué este beat. El enganche aparece en los primeros 3 segundos, y la duración de cada beat suma la duración total.
  4. Pide un "sí". Una corrección recibe una nueva lectura en voz alta. Nunca construyas en el mismo mensaje que el briefing.

Luego pasa el control: reel-style elige el estilo visual (3 imágenes fijas), y film-engine construye en él, con la página dimensionada según el formato del briefing.

Nunca

  • Preguntes lo que el material ya responde.
  • Inventes un número, una cita, un cliente o un resultado.
  • Cambies las palabras de la persona por las tuyas. Revísalas (gramática, flujo), no las reescribas.
  • Omitas la ronda de formato, incluso cuando la plataforma parezca obvia.
  • Elijas el estilo visual dentro de la entrevista. Ese es trabajo de reel-style, mostrado como imágenes fijas, nunca nombrado desde una lista.

Créditos

La postura de la entrevista (el agente pregunta antes de actuar, con una respuesta recomendada para cada pregunta) proviene de grill-me de Matt Pocock (mattpocock/skills, MIT). Las reglas de preguntar una vez (opción recomendada primero, omitir lo ya respondido, dicho vs. asumido, una verificación de conflictos antes del resumen) están adaptadas de la entrevista de intención de HyperFrames (heygen-com/hyperframes, Apache-2.0). Los campos del briefing siguen los briefings de video de agencias comunes. Los hechos de las plataformas se verificaron el 2026-10-06 contra las páginas de las propias plataformas donde se pudieron leer; las que no se pudieron (X) están marcadas como no verificadas en references/platforms.md.

Individual skills in this repo

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

thativanng/reels-maker

The gates every code-rendered film passes before anyone sees it. A 40 fps collision pass (no mover touches a solid or another mover), pixel probes (nothing sits over or behind a face, a head, a subtitle or the frame edge), then an independent auditor (a fresh agent) who reads frame sheets at ≥2 fps and signs off. The builder never signs off their own film. Use it before sending ANY render, after every fix round, and whenever someone says "check the film", "audit this", "is it ready", or "why does this frame look wrong".

thativanng/reels-maker

Build and render a film, reel or animation as code. One HTML page draws any frame on demand with window.seek(t), and a headless browser renders every frame at 2x into an MP4 with sound. Use it whenever someone wants a video made with code rather than a video generator, says "make a film / reel / animated explainer / career video", "render this to MP4", "turn this page into a video", or needs the finishing steps (audio cues, loudness, colour-safe encode, phone preview). It is style-agnostic and renders 9:16, 4:5, 1:1 or 16:9. It runs after reel-intake (the brief) and reel-style (the look), builds on template/starter.html or a style pack such as voxel-walk, and passes film-audit before anything is shown to anyone.

thativanng/reels-maker

Picks the look of a reel or film before it is built. It shows three genuinely different looks as stills of the same opening frame with the same words, so the person judges the look and not the content. It keeps a log of every look ever shown, so no look comes back unless asked for, and it locks one look on purpose for a series. Use it after reel-intake's brief is signed and before any test strip, whenever someone says "what should it look like", "give me options", "make it look different from last time", "it looks cheap", or starts a new reel or a new series.

thativanng/reels-maker

The voxel career-film style. A blocky 3D version of the person walks, without ever vanishing, through one scene per role. Their outfit changes as they walk, each scene rises out of the floor ahead of them, and a dark banner tracks year, company and role. Use it when someone wants their career, a journey or a "how I got here" told as a short 3D film for LinkedIn or a portfolio, says "make my career film", "turn my CV into a video", "voxel film", or wants a new chapter added to an existing one. It runs on film-engine (render, audio, finish) and must pass film-audit before anything is sent.

Skills relacionados