Communitygithub.com

Claude Video Kit (Editoryal Animasyon)

Genera videos editoriales de gráficos en movimiento basados en datos y texto para X/Twitter, Reels/Shorts y YouTube (con Remotion). La historia se define como una lista de escenas JSON (título, texto escrito, contador, medidor, columnas, comparación, lista, pregunta), se renderiza en 16:9 y 9:16, y se le añade audio sintetizado (whoosh, teclado, música de fondo).

¿Qué es Claude Video Kit (Editoryal Animasyon)?

Este skill permite a un agente de IA (como Claude Code, Cursor o Codex) crear vídeos cortos de estilo editorial con gráficos animados. El usuario escribe la narrativa como una lista de escenas en un archivo JSON, y el skill se encarga de todo el proceso: renderizado del vídeo con Remotion, síntesis de audio (whoosh suave, sonidos de teclado y música de fondo generada con numpy), y medición de la calidad final. Está diseñado para plataformas como X/Twitter (16:9), Reels/Shorts (9:16) y YouTube (pausas entre vídeos). La salida es un archivo MP4 listo para publicar. El skill también incluye herramientas para previsualizar borradores, medir el volumen (LUFS) y verificar la sincronización. Es útil para contar historias con datos, mostrar resultados de pruebas, crear comparaciones o generar contenido animado a partir de números.

Compatible con✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/UgurKeskekci/claude-video-kit/tree/HEAD/.claude/skills/x-animasyon

Preguntar en tu IA favorita

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

Documentación

Gráficos editoriales animados (Remotion)

Convierte la historia de un experimento, prueba o idea en un vídeo de 15-30 segundos basado en números y texto. El aspecto es fijo y cuidado: título serif elegante + palabra de énfasis en cursiva (azul cielo), etiquetas monoespaciadas en MAYÚSCULAS con poco espaciado, números grotescos en negrita y compactos; marco delgado continuo (marca arriba a la izquierda, "01 — CAPÍTULO" arriba a la derecha, progreso dividido + tiempo abajo), ligera cuadrícula de fondo, viñeteado y grano sutil. Tú escribes la historia en JSON, la imagen surge de ahí.

Si necesitas dibujos, personajes o escenas hechas a mano, esto no es lo adecuado; usa el skill animacion (PIL ink).

Ejemplo: ejemplos/x-animacion/ejemplo.json ("Hice el mismo trabajo con tres configuraciones diferentes"; los números son datos de demostración inventados, en pantalla aparece "datos de ejemplo").

Instalación (una vez)

cd remotion && npm install      # Node 18+; la carpeta fuentes/ se copia automáticamente a public/fonts

El primer render descarga Chrome Headless Shell (~100 MB). Parte Python: numpy, Pillow, ffmpeg. En los comandos, usa .venv/bin/python como Python (Windows: .venv\Scripts\python).

Ciclo

1. Entiende la historia

¿Cuál es la afirmación en una sola frase? ¿Qué números hay y de dónde vienen? Plataforma y relación de aspecto (X: 16:9, Reels/Shorts: 9:16, o ambas), duración (X 15-30 s). Si no hay números, invéntalos: pide al usuario el número medido o usa escenas sin números (título, lista, pregunta).

2. Escribe la lista de escenas: trabajo/x-animacion/<nombre>.json

Copia del ejemplo. Reglas:

  • Cada escena una sola idea, 3-7 palabras por línea, español natural y sencillo. En lugar de una frase larga, usa dos líneas.
  • *palabra* = énfasis (cursiva en serif + azul). Máximo un énfasis por escena.
  • Los números solo pueden ser medidos. Si usas números no medidos/de ejemplo, mantén "etiqueta": "datos de ejemplo" a nivel superior e informa al usuario.
  • En español, el porcentaje va delante: "prefijo": "%" → %80. Para dinero y tiempo en comparaciones, proporciona el texto listo: "$0,61", "5 min 12 s".
  • capitulo abre un nuevo capítulo (etiqueta arriba a la derecha + parte de la barra de progreso); 3-5 capítulos son suficientes.
  • Insignias de estado como "en espera", "próximamente" y notas para ti mismo; cada texto en pantalla es para el espectador.
tipoCamposPara quéDuración recomendada
titulosup?, lineasgancho: primeros 2-3 s2,4-3
textolineas?, sup?, texto (≤160)prompt/comando se escribe letra a letra con sonido de teclado0,55 + letra × 0,09 + 0,9
contadorsup?, valor, inicio?, decimal?, prefijo?, sufijo?, inf?un solo número grande que aparece contando3
medidorlineas, niveles[2-6] (nombre, etiqueta?)nivel conceptual: se llena en orden de bajo a alto3-4
columnaslineas, elementos[2-6] (nombre, valor, etiqueta?), prefijo/sufijo/decimal?, nota?resultados medidos, etiqueta de orden automática4-4,5
comparacionlineas (una sola línea), a, b (nombre, sup?, valor, infEtiqueta?, inf?), diferencia? (valor, etiqueta?, inf?)A vs B: coste, duración4-5
listalineas, elementos[2-5]inferencia, regla, paso1,6 + 0,5 × elemento
preguntalineas, inf?pregunta de cierre / llamada a la acción3

Cada escena requiere duracion (s), capitulo es opcional. A nivel superior: marca (nombre arriba a la izquierda), etiqueta?, tema?, escenas. Esquema: remotion/src/x/esquema.ts.

3. Borrador (vistazo rápido)

.venv/bin/python .claude/skills/x-animacion/herramientas/generar.py trabajo/x-animacion/<nombre>.json --relacion ambas --borrador

Render a media resolución, sin audio + página de contactos (<nombre>-<relacion>-borrador-sin-sonido-pagina.jpg). ÁBRELA y mira: líneas que sobresalen, elementos superpuestos, etiquetas ilegibles, grandes espacios vacíos. Corrige, vuelve a tomar borrador. Para editar en vivo: cd remotion && npx remotion studio.

4. Render + audio

.venv/bin/python .claude/skills/x-animacion/herramientas/generar.py trabajo/x-animacion/<nombre>.json --relacion ambas

Salidas en trabajo/x-animacion/: <nombre>-16x9.mp4 (1920×1080, 60 fps) y <nombre>-9x16.mp4 (1080×1920, 30 fps), con audio. El nivel de volumen predeterminado es -26 LUFS: claramente por debajo del habla (-14..-16), no ahoga si se superpone narración o cabeza parlante. Si se envía solo, usa --lufs -18; si se desea sin música, --sin-musica.

Paso a paso (lo mismo):

cd remotion && npx remotion render XAnimacion16x9 ../trabajo/x-animacion/<nombre>-16x9-sin-sonido.mp4 \
    --props=../trabajo/x-animacion/<nombre>.json --muted && cd ..
.venv/bin/python .claude/skills/x-animacion/herramientas/audio.py trabajo/x-animacion/<nombre>.json \
    --video trabajo/x-animacion/<nombre>-16x9-sin-sonido.mp4 --salida trabajo/x-animacion/<nombre>-16x9.mp4

5. Mide — no puedes mirar, no puedes escuchar

Al final de generar.py se ejecuta medir.py (a mano: medir.py <mp4> --json <json>):

  • número de fotogramas y duración igual a lo esperado del JSON, audio y vídeo misma longitud;
  • página de contactos: dos fotogramas de cada escena (mitad y justo antes de la salida) — ábrela y mira;
  • LUFS integrado y pico real; en cada corte, el whoosh supera el lecho en cuántos dB (aviso si 2 dB por debajo). En el corte justo después de una escena de escritura, la diferencia es pequeña: hay sonido de tecla en la ventana anterior, normal. Lo que no puedas medir (si la música es agradable, si el ritmo es correcto) déjaselo claro al usuario.

6. Entrega

Rutas de archivo, duración, tiempo de render y resumen de medición. Si se usaron datos de ejemplo, repítelo.

Adaptar la apariencia

  • Color: En JSON: "tema": {"enfasis": "#38bdf8", "fondo": "#111113", "texto": "#ece7df", "palido": "#8b8883", "serie": [...]}. Mantén un solo color de énfasis; serie son colores de medidor/columnas. Valores predeterminados en remotion/src/x/componentes.tsx.
  • Marca: "marca" es el nombre arriba a la izquierda (nombre del canal o de la serie).
  • Fuente: solo fuentes de distribución libre (como OFL). Pon el TTF y el texto de licencia en fuentes/, añádelo a la lista en remotion/scripts/copiar-fuentes.mjs y a CARAS en remotion/src/x/fuentes.ts, ejecuta npm run fuentes. Las fuentes incluidas con el sistema operativo (fuentes del sistema macOS/Windows) no se ponen en el repositorio, no se pueden distribuir.
  • Diseño: dos orientaciones en useDiseno() (dentro de componentes.tsx). En vertical, el contenido está entre y 300-1320: la interfaz de Reels/Shorts cubre ~190 px arriba, ~520 px abajo y la esquina inferior derecha.
  • Nuevo tipo de escena: añade esquema a esquema.ts, componente a escenas.tsx, rama a DibujarEscena, nombre a TIPOS en generar.py. Si necesita un sonido interno como el de teclado, calcula su tiempo con tiempo.ts y en herramientas/comun.py con la misma fórmula.

Errores comunes (medidos)

  • El tiempo es la única fuente: remotion/src/x/tiempo.ts y herramientas/comun.py hacen el mismo cálculo (redondeo de fotogramas, ritmo de escritura). Si cambias uno y olvidas el otro, el whoosh se desvía del corte y el sonido de tecla de la letra.
  • El ID de composición no tiene guión bajo; no incrustes JSON en --props, pasa la ruta de archivo.
  • Las fuentes se cargan con la API FontFace; no se espera document.fonts.ready (en renders largos se ha visto que nunca se resuelve en una pestaña). Si la fuente no se carga, el render falla con error, no cae silenciosamente en una fuente de respaldo.
  • El grano no se calcula con SVG feTurbulence en cada fotograma (bloquea el render): se desplaza una baldosa de ruido generada una vez.
  • Mayúsculas en español con CSS (lang="es" + text-transform): la Ñ sale correctamente. No uses toUpperCase() en JS.
  • No apliques animaciones de escala (zoom/pop) al texto: tiembla. Entrada = elevación desde máscara + opacidad.
  • Si el render largo a 60 fps se traba, divídelo en partes como --frames=0-899 y combínalas con ffmpeg concat.
  • Tiempo de render medido (M1 Pro, 16 GB, concurrencia predeterminada): ejemplo de 27,4 s 16:9@60 ~67 s, 9:16@30 ~40 s; borrador (media res) 33 / 18 s.

Nota de licencia: Remotion

Remotion no tiene licencia MIT. Es gratuito para individuos y pequeñas empresas; las empresas por encima de cierto tamaño deben adquirir una licencia de pago. Antes de usarlo, consulta las condiciones actuales: https://www.remotion.dev/license — el código de este repositorio es MIT, Remotion en sí está sujeto a su propia licencia.

Individual skills in this repo

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

UgurKeskekci/claude-video-kit

Kodla (görsel üretim modeli OLMADAN) hikâye anlatan kısa mürekkep çizgi animasyonu üretir — X/Twitter gönderisi, Reels/Shorts, YouTube video arası ya da soğuk açılış. Görüntü PIL mürekkep motoruyla, müzik ve efektler numpy sentezi ile aynı zaman programından üretilir, sonuç ölçülerek denetlenir. Şu durumlarda kullan: "animasyon yap", "çizgi animasyon", "halimi anlat", "durumumu göster", "twitter için animasyon", "reels animasyonu", "araya animasyon", "çöp adam animasyonu", "kodla video", "one-shot animasyon".

UgurKeskekci/claude-video-kit

Konuşan kafa kaydından (kamera, ses içinde; yatay 4K ya da dikey) dikey Instagram Reels / YouTube Shorts / TikTok videosu (1080x1920, 30 fps) üretir, "kart" formatında - üstte söylenen kelimede beliren sade arayüz kartları (sohbet balonu, liste, harf harf yazılan terminal, dosya ağacı, büyük sayı, gerçek ekran görüntüsü), altta yuvarlak köşeli yüz kartı, aralarında kelime kelime altyazı, kart geçişinde yumuşak whoosh, yazarken klavye sesi, sonda "yorumlara yaz" sorusu. Şu durumlarda kullan - "reels yap", "bundan reels çıkar", "shorts yap", "dikey video", "kartlı reels", "bilgi veren reels", "ipucu videosu", "üstte kart altta yüz", "yorumlara yaz diye bitsin", "tips reels".

UgurKeskekci/claude-video-kit

Yatay YouTube konuşma videosunu (kamera kaydı, isteğe bağlı ayrı ekran kaydı) kaba kurgular. Harfiyen döküm çıkarır, duraklamaları ve art arda tekrarları sesten keser; Claude dökümü okuyup gerekçeli bir atma listesi yazar, mp4 üretilir, kesilmiş ses yeniden çözülüp her birleşim denetlenir. Şu durumlarda kullan - "videoyu kurgula", "kaba kurgu", "ham kaydı kes", "beklemeleri/duraklamaları kes", "tekrarları at", "takılmaları temizle", "jump cut", "keseceğim dediğim yerleri at", "kamera ile ekran kaydını senkronla", "ekran kaydının köşesine kamera koy", "sessiz yerleri hızlandır".

Skills relacionados