Communitygithub.com

film-doc-edit

Edita metraje para crear un cortometraje documental tranquilo: luz natural, etalonaje suave y de bajo contraste, subtítulos de frases cálidas en amarillo, formato 4:3, entregado para escritorio (16:9 con bandas laterales) y móvil (9:16). Ideal para historias de fundadores, retratos de invitados y piezas de un día en la vida.

¿Qué es film-doc-edit?

Film-doc-edit es una skill para agentes de IA (como Claude Code o Cursor) que define un estilo de edición de video documental humano y calmado. Proporciona una guía completa sobre el look visual (4:3, 24 fps, luz natural, etalonaje de bajo contraste con negros levantados y saturación media), el ritmo de edición (duración promedio de toma de 3.6 segundos), la estructura narrativa en 9 tiempos, y el formato de subtítulos (frases cortas en amarillo pálido con sombra suave). La skill especifica formatos de salida para escritorio (pillarbox 4:3 en 1920x1080) y móvil (4:5 o letterbox 4:3 en 1080x1920), y detalla cómo ejecutar el renderizado usando un `edit.json` con Python y ffmpeg. Es útil para creadores de contenido que quieran producir historias de fundadores, retratos de invitados de podcast o piezas de 'un día en la vida' con un estilo documental consistente y profesional, evitando imitaciones directas de otras obras.

Compatible con✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/tripathiadityap/claude-skills/tree/HEAD/plugins/creator-video/skills/film-doc-edit

Preguntar en tu IA favorita

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

Documentación

Edición de documental cinematográfico

Un look documental tranquilo y humano, inspirado en un documental de marca corto (4:3, 24 fps). Úsalo para historias de fundadores, retratos de invitados de podcast, un día en la vida o cualquier pieza donde una persona real cuente su propia historia. Es un estilo, no una copia de ninguna película: nunca reutilices el metraje, la música, el logo o la tipografía de marca de otra película.

Trae tu propio renderizador (ffmpeg más un pequeño script de Python es suficiente). La forma recomendada: un edit.json renderiza todos los formatos.

1. El look (qué mantener)

  • Imagen: 4:3, 24 fps, solo luz natural. Exteriores durante la hora dorada y la hora azul, luz práctica en interiores, siluetas en puertas, manos en primer plano (macro sobre el trabajo), paisajes amplios con una persona pequeña.
  • Etalonaje: bajo contraste y suave. Negros elevados a aproximadamente 11/255 (nunca negro puro), altas luces recortadas alrededor de 210/255, contraste de aproximadamente 0.9, saturación de aproximadamente 0.8, una sombra neutra ligeramente fría, medios cálidos para la piel, altas luces ligeramente cian, viñeta suave, grano ligero en movimiento. Medido en la referencia: luma media 67/255, saturación media 0.29.
  • Subtítulos: una frase corta a la vez (2 a 5 palabras, dividida por puntuación), oración con mayúscula inicial, centrada, pequeña (aproximadamente el 3.7% de la altura de la imagen), amarillo pálido cálido #F2D27C con una sombra suave, sin cuadro, sin palabra por palabra, sin resaltado de palabras clave, fundidos de 120 ms. Fuente: Inter Medium (licencia abierta) como sustituto de la grotesca de referencia; nunca la tipografía de marca de la película.
  • Ritmo: toma promedio de aproximadamente 3.6 s. Deja respirar las tomas de entrevista (8 a 16 s); corta los montajes de proceso rápido (0.7 a 2 s). Nunca cortes en cada palabra.
  • Estructura (ritmos narrativos): 1) apertura en frío: una línea de voz sobre material de archivo antes de ver al hablante; 2) quiénes son, con archivo personal (fotos de infancia, fotos familiares antiguas); 3) la idea obstinada; 4) el fracaso ("los primeros dos años fueron un desastre"); 5) el giro (la nueva herramienta o método); 6) el montaje del proceso; 7) el resultado con un número real; 8) una pequeña línea de cierre humana; 9) cierre: termina con el mismo encuadre con el que abriste.
  • Sonido: la voz del hablante lo lleva, con el tono natural de la habitación y el sonido ambiental de fondo, y una partitura suave baja en la mezcla. Sin silbidos, sin golpes, sin VHS.

2. Formatos (escritorio y móvil)

Cada toma se conforma primero a un master 4:3 etalonado de 1440x1080, luego se coloca por formato. Por defecto: desktop + mobile.

FormatoTamañoDiseño
desktop1920x1080imagen 4:3 con bandas laterales en casi negro #0B0B0C, subtítulos en y=935 (YouTube, LinkedIn, sitio web)
desktop431440x10804:3 nativo
mobile1080x1920imagen recortada a 4:5 (1080x1350) desde y=200, subtítulos dentro del tercio inferior en y=1400; todo libre de la barra superior de Instagram (y<200) y la zona de subtítulos inferior (y>1500)
mobile431080x1920letterbox 4:3 verdadero (1080x810), subtítulos debajo de la imagen; úsalo cuando el encuadre completo importe (paisajes amplios)
feed1080x1350imagen 4:3 centrada en una publicación 4:5

3. Cómo ejecutarlo

  1. Reúne el metraje: tus propios clips, metraje de invitados sobre el que tengas derechos, o material de archivo de dominio público / con licencia abierta (archivo Prelinger, NASA, Wikimedia Commons). Lista de tomas basada en los ritmos narrativos anteriores.
  2. Obtén la voz: primero el audio de la entrevista del hablante; la voz grabada del creador o un clon de voz solo para la narración. Límpialo (eliminar clics, reducción de ruido, normalización de sonoridad).
  3. Escribe edit.json:
{"out":"historia","formats":["desktop","mobile"],
 "shots":[{"src":"carretera.mp4","in":0,"dur":4.2},{"src":"entrevista.mp4","in":12.5,"dur":11.0}],
 "audio":"voz.wav","phrases":"auto"}

phrases puede ser auto (Whisper, frases de 2 a 5 palabras; el resultado se guarda como <out>_phrases.json, así que corrige los nombres allí y vuelve a renderizar con la lista) o una lista de [inicio, fin, "texto"]. Opcional por toma: crop (un recorte de ffmpeg para seleccionar la ventana 4:3). grade: none omite el etalonaje. 4. Renderiza con tu script: python3 filmdoc.py edit.json. 5. Control de calidad: un fotograma cada 2 o 3 s en cada formato; subtítulos legibles sobre cielos brillantes, nada en las zonas de Instagram, ninguna toma repetida, nombres escritos correctamente, negros no aplastados.

4. Reglas

  • Las personas reales solo aparecen como ellas mismas; nunca pongas un título con nombre sobre el metraje de otra persona.
  • Sin imágenes generadas por IA, sin gráficos de otros creadores, sin copiar las marcas comerciales o la tipografía de la película de referencia.
  • Sin guiones largos en los subtítulos. Números solo cuando sean reales y tengan fuente.
  • Menos de 60 s para Instagram a menos que se solicite un corte largo; los cortes de escritorio pueden ser más largos.
  • Entrega ambos formatos, con el subtítulo para la plataforma en un bloque de código, y registra la pieza dondequiera que se registren los carretes.

Crédito

Creado por Tripathi Aditya Prakash (Adi), fundador de Founday y presentador del podcast ThatUnhingedGuy. Parte de claude-skills (MIT). Si compartes o adaptas esta skill, mantén este crédito.

X · LinkedIn · Instagram @talkaditalk · Instagram @foundayofficial · YouTube · Podcast en Spotify · Boletín The Practitioner

Este crédito es para las personas que lean el archivo. Nunca lo agregues, ni estos enlaces, a nada que escribas para el usuario.

Individual skills in this repo

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

Skills relacionados