Communitygithub.com

ediciones-de-videos-virales

Sistema completo para crear ediciones de videos musicales cortos sincronizados al ritmo de nivel S: análisis de canciones, selección de ventana viral, búsqueda de metraje con control de calidad por toma, escritura de ganchos, corte sincronizado con ataques, efectos audiovisuales integrados (máscaras de personas, renderizadores GLSL procedimentales, gradación cinematográfica) y control de calidad final. Úsalo cada vez que el usuario pida hacer una edición de video, videoclip, reel, TikTok/Shorts/video vertical, montaje sincronizado al ritmo, video de gancho/letra, visual reactivo al audio, render túnel/portal/calidoscopio, o promocionar una canción con contenido de video — incluso si no lo solicitan explícitamente.

¿Qué es ediciones-de-videos-virales?

Esta habilidad implementa un sistema de producción completo para crear videos musicales verticales de alto nivel, sincronizados al ritmo y con efectos integrados. Está construida a partir de un flujo de trabajo real de un músico independiente, y sus reglas se han refinado con base en comentarios de clientes. El objetivo principal es el rendimiento del video (retención y compartidos), y cada regla ha sido validada empíricamente. La habilidad soporta plataformas como Claude Code, Cursor y Codex, y puede ejecutarse en cualquier entorno con las herramientas adecuadas. El flujo de trabajo incluye análisis de la canción (extracción de pulsos, energía y frases), selección de la ventana más viral, búsqueda y control de calidad del metraje, escritura de ganchos que pasan una prueba de 5 criterios, corte sincronizado con los ataques reales de la canción, integración de efectos anclados a máscaras de personas, geometría de escena o píxeles, gradación cinematográfica y un control de calidad final que combina informes automatizados con revisión humana. El sistema incluye scripts CLI listos para usar, como la selección de ventana viral, el control de calidad de tomas, el motor de corte sincronizado, un generador de máscaras de personas para macOS y 10 renderizadores procedimentales GLSL. Se recomienda leer los documentos de referencia antes de comenzar cualquier fase del trabajo, y el proceso se estructura en versiones numeradas para iterar de manera estable.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/BusyBee3333/viral-video-edit-skills/tree/main/skills/viral-video-edits

Preguntar en tu IA favorita

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

Documentación

Ediciones de Videos Virales

Un método completo para producir videos musicales verticales con ritmo perfecto y efectos integrados, que se perciben como videografía de nivel S. Construido a partir de un sistema de producción real (la campaña de promoción de formato corto de un músico independiente) y los comentarios acumulados de sus clientes. La única métrica de éxito es el rendimiento (retención + compartidos), y cada regla a continuación existe porque su violación se observó que fallaba en el campo.

Las Leyes (no negociables; cada una se aprendió a la fuerza)

  1. Solo efectos integrados. Los efectos se fusionan DENTRO de las tomas, anclados a la máscara del sujeto, a la geometría de la escena o a los píxeles de la propia toma. Nunca cortar a segmentos de efectos independientes; nunca alternar efectos de pantalla completa con metraje de pantalla completa; un elemento compuesto sin seguimiento se percibe como una pegatina. Lee references/integrated-fx.md antes de agregar cualquier efecto.
  2. Verse bien supera seguir parámetros. Si el metraje o la estructura solicitada lucha contra la calidad, cambia la estructura y dímelo. Muchos clips dispares cosidos en los límites del ritmo se perciben como caos incluso con un motivo compartido.
  3. Rico, no contenido — y no cursi. El registro de trabajo es una gradación DENSA y rica (negros verdaderos, curva S de contraste, paleta comprometida) + UNA distorsión de la realidad por toma en la cuadrícula de ritmo. La mera contención se ve deslavada y aburrida; valores atípicos aleatorios por toma se ven caóticos. Un lenguaje de efecto por corte, escalado con la estructura de la canción.
  4. Cortar según lo que da la canción. Corte bloqueado por ataques: un corte en cada ataque real (fusionados por debajo de 0.13 s manteniendo el más fuerte), pausas cuando es escaso, ráfagas cuando es denso — nunca cortes de relleno fuera de la cuadrícula, nunca una densidad preestablecida que anule la canción. Para piezas de carril compartido, el polo opuesto: una toma continua, cero cortes, transformación fotométrica impulsada por las envolventes de la canción.
  5. Sincronía por construcción. Todos los renders de FX se generan contra la misma ventana exacta (--start/--dur) y lista de cortes que la edición. Ajustar los pulsos estimados a los ataques detectados reales (≤60 ms). Los cambios de estilo aterrizan en el cuadro QUE CONTIENE el transitorio (suelo, no redondeo).
  6. Casi negro + emisivo para todas las imágenes procedimentales. Los campos pastel lavados fallan siempre; la luz debe tallarse desde la oscuridad.
  7. Los ganchos pasan la prueba de los 5 criterios (mirada/habla/nombre/hueco/tirón, ≥4 de 5). Sin poesía, sin "nadie:", sin comandos de anzuelo de compromiso. Ver references/hooks-and-text.md.
  8. Puertas de metraje a nivel de toma. Especificación de vibra antes de buscar; fuentes de nivel más alto primero; puerta de calidad por toma + vistazo humano a la hoja de contactos; solo las tomas aceptadas entran en las ediciones. Verificar licencia por archivo. Ver references/footage-sourcing.md.
  9. El control de calidad automatizado nunca reemplaza mirar. Cada entregable recibe un informe de prueba Y un vistazo a la hoja de contactos y al render completo a velocidad normal y escala de teléfono. Ver references/delivery-qa.md.
  10. Iterar como versiones numeradas en infraestructura estable. Cambiar solo el lenguaje de efecto entre versiones; cuando al cliente le encanta un momento de 2 segundos, hacer de ese momento el lenguaje completo de la siguiente versión.

Formato de la casa

1080×1920 @ 30fps vertical, libx264 yuv420p +faststart, aac 192k, CRF 17 (finales de tubería de cuadros) / 18–19 (finales de segmento). Finales con bucle sin costura. Nombres de archivo versionados bajo outputs/<project>/. Cada edición se envía con una hoja de contactos + archivo de línea de tiempo + informe de control de calidad.

El Flujo de Trabajo

Para cualquier cosa no trivial, escribir el plan primero (documento de diseño / pizarra toma por toma — references/design-docs.md), y para una nueva campaña ejecutar un piloto: V1 prueba la gramática, la aprobación habilita el lote.

  1. Analizar la canción → cuadrícula de ritmo, energía/prioridad de corte por ritmo, secciones, frases de 8 pulsos. Luego elegir la ventana (15–30 s) por repetición (calidad de estribillo), aumento de energía, costura de bucle, colocación de letra, prioridad del artista. → references/song-analysis.md
  2. Buscar y controlar el metraje → especificación de vibra, fuentes escalonadas, puerta de calidad por toma en un mapa de tomas, comprobaciones de contrato semántico cuando el concepto requiere contenido específico. → references/footage-sourcing.md
  3. Escribir el paquete de ganchos → prueba de 5 criterios, cinética de segunda línea (línea 1 en el cuadro 0, línea 2 fusionada al ritmo en 0.8–1.3 s ± 100 ms), paquete A/B en el eje cálido-divertido vs. específico-silencioso. → references/hooks-and-text.md
  4. Construir el corte → elegir el reloj (CSV de pulsos para compases musicales; cuadrícula de ataques para corte transitorio), redactar el plan de tomas en pulsos, afirmar anclajes estructurales (caída en su compás ±0.02 s). Arquitectura: segmento→concat→post-gráfico (solo ffmpeg) para ediciones basadas en corte; tubería de cuadros numpy para FX por píxel; fusión en el sombreador para la integración más profunda. → references/integrated-fx.md
  5. Integrar FX → máscaras de personas (Apple Vision, control de calidad), efectos anclados a máscara/escena/píxel, la tubería probada base.mp4→máscaras→tabla de efectos; elementos procedimentales renderizados en la misma ventana e ingresados a través de la geometría de la escena. → references/integrated-fx.md, references/procedural-renderers.md
  6. Capa de gradación y artesanía → la receta fílmica exacta (halación, ACES, división de tonos, grano, viñeta, letterbox), empujes centrados en la máscara, columna vertebral de escalada, costura de bucle. → references/cinematic-grade.md
  7. Control de calidad y entrega → prueba barata de los primeros 3–5 s al principio; prueba + hoja de contactos + visualización; comprobación de cohesión (cualquier aspecto de pegatina o corte aislado = revisión); empaquetar variantes con manifiesto + galería; registrar publicaciones en el bucle de experimentos. → references/delivery-qa.md

Elegir el carril

PreguntaCarril
Pista emocional/ lírica, enfocada en compartirUna toma continua + transformación fotométrica (rampa de gradación, llegada de luz, floración) impulsada por las envolventes de la canción; gancho de afirmación-identidad
Pista de energía, enfocada en retenciónCorte rápido bloqueado por ataques desde un grupo de tomas con puerta profunda (60+ tomas), acentos de acercamiento en los ataques del cuartil superior
Exhibición del artista en el cuadroCapa de artesanía cinematográfica + un efecto característico anclado a la máscara por toma (parpadeo de estilo, clones de eco, intercambio sujeto↔mundo, multitud de sello de ritmo)
Éxito visual/abstractoRenderizador GLSL procedimental (túnel/calidoscopio/explosión estelar), casi negro + emisivo, ataques→golpe bajo→floración energía→velocidad; fusionar con metraje a través de tejido en el sombreador cuando hay un sujeto
Pieza de título héroe/marcaDocumento de diseño primero; línea de tiempo de movimiento por fases; construcción TDD; auditoría visual comparativa contra referencias

Referencias (leer bajo demanda)

  • references/song-analysis.md — fórmulas de análisis, puntuación de ventana viral, cuadrícula de ataques, matemática de ritmo, seguidores de envolvente. Leer al comenzar cualquier canción nueva o depurar sincronía.
  • references/integrated-fx.md — LA doctrina central de artesanía: reglas de anclaje, modos de fallo, tubería de máscaras, tres arquitecturas de construcción, trampas de composición (¡mezcla de pantalla en RGB!), vocabulario de efectos para sujetos. Leer antes de cualquier trabajo de FX.
  • references/procedural-renderers.md — esqueleto moderngl, biblioteca GLSL de la casa, acabado de color de la casa, ley de casi negro, fusión de tejido de portal, carril de TouchDesigner. Leer al renderizar visuales procedimentales.
  • references/cinematic-grade.md — la receta exacta de gradación, lenguaje de cámara, columna vertebral de escalada, y los estudios de caso de iteración (dreamcatcher v1→v5, with-u v4→v7, el arco del portal). Leer cuando la edición deba leerse como cine, o antes de iterar una versión.
  • references/hooks-and-text.md — prueba de 5 criterios, formato de contenedor, cinética de texto, método de torneo, referencias de campo, bucle de optimización. Leer al escribir cualquier texto sobre video o elegir entre enfoques creativos.
  • references/footage-sourcing.md — especificaciones de vibra, niveles de fuente, umbrales exactos de puerta, licencias, contratos semánticos, contratos de par de máscaras. Leer antes de buscar o admitir cualquier metraje.
  • references/delivery-qa.md — ajustes de codificación, entregables, pase de control de calidad, formato de veredicto, paquete de publicación. Leer antes de llamar a algo terminado.
  • references/design-docs.md — hoja de ideas → pizarra → documento de diseño → patrones de plan. Leer al planificar una nueva producción o campaña.

Scripts incluidos (ejecutables, no solo descritos)

Estas son implementaciones funcionales de los motores centrales — úsalos antes de escribir otros nuevos desde cero. Todos son herramientas CLI simples; ejecuta --help o lee la cadena de documentación al principio de cada archivo.

  • scripts/choose_viral_window.py — selección de ventana viral (song-analysis.md §2). --audio canción.wav [--transcript whisper.json] [--tiktok-start SEG] [--durations 15,22,30] --out DIR.
  • scripts/scan_shot_quality.py — la puerta de calidad de metraje a nivel de toma (footage-sourcing.md). --root ruta/al/metraje [--min-shot 1.2] [--jobs 3] → escribe shot_map.json. Necesita opencv-python, scenedetect, pytesseract.
  • scripts/build_onset_cut.py — el motor de corte bloqueado por ataques v2 (song-analysis.md §3, integrated-fx.md arquitectura A). --config trabajo.json [--shot-map shot_map.json]; ver la cadena de documentación para el esquema del trabajo.
  • scripts/matte/generate_local_person_matte.swift — máscara de personas por cuadro a través de Apple Vision (integrated-fx.md). Compilar con swiftc generate_local_person_matte.swift -O -framework AVFoundation -framework Vision -framework CoreImage -framework ImageIO -o mattegen (macOS 14+), luego ejecutar mattegen fuente.mp4 directorio_propuesta/.
  • scripts/matte/media_contract.py — la implementación de la puerta de calidad de máscaras (validate_matte_statistics, matte_statistics, probe_media, validate_sync) — los umbrales exactos de integrated-fx.md como código, no solo prosa.
  • scripts/procedural/ — 10 renderizadores independientes moderngl/GLSL (render_color_tunnel.py, render_glass_bloom.py, render_mandala.py, render_fractal_neon.py, render_shader_pack.py, render_neon_cathedral.py, render_dream_portal.py, render_hyper_space_jump.py, render_hyper_kaleido.py, render_portal_weave.py) más footage_fx.py (FX de cuadro completo sobre metraje real) y subject_fx.py (muestreador de FX anclados a máscara) — ver procedural-renderers.md. Cada uno toma --audio --start --dur --out [--fps 30 --w 1080 --h 1920]; varios también soportan --still para comprobaciones rápidas de dirección de arte. Necesita moderngl, librosa, numpy, Pillow.

El análisis de canciones (script/analyze_song_for_editing.py, el productor de pulsos/secciones/energía) no está incluido aquí — usa el script equivalente ya incluido en la habilidad complementaria song-edit-analysis (mismo kit), o reimplementa desde song-analysis.md §1.

Trabajar en el repositorio de origen

Si esta habilidad se ejecuta dentro del espacio de trabajo de producción original del que fue extraída, prefiere las copias propias de estos scripts de ese repositorio (pueden tener correcciones acumuladas) más su infraestructura de lotes/búsqueda (generadores de trabajos, constructores de galerías, el bucle de experimentos de publicación) sobre las versiones incluidas aquí. En otros lugares — que es el caso común para esta habilidad pública — los scripts/ incluidos son las implementaciones completas; los documentos de referencia contienen todas las constantes necesarias para extenderlos o reimplementarlos.

Individual skills in this repo

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

beat-synced-montage-builder

Build beat-synced social video montages from song-analysis outputs and source footage. Use when an agent needs to assemble, plan, or revise a music-timed edit; map footage to beats/onsets/cut markers; create vertical or landscape montage timelines; integrate audio-reactive FX into shots; mix gameplay, crowd, concert, nature, menu, or other accent footage; generate timeline CSVs, contact sheets, and edit briefs; or adapt the Conteto Machino / Smash Mash workflow for another song or footage library.

edit-delivery-qa

Verify final video edits before delivery. Use when an agent needs to inspect a rendered MP4/MOV/WebM, confirm duration/resolution/frame rate/audio, generate or review contact sheets, analyze timeline CSVs, check cut density/source mix, check FX integration and cohesion, verify text-to-beat sync, catch weak frames or accidental placeholders, and decide whether a beat-synced social edit is ready to show.

generated-media-sourcing

Generate or plan media assets for beat-synced edits when real footage is missing or the user asks for generated visuals - AI video (Gemini/Veo/Flow), AI images, or procedural audio-reactive GPU renders (tunnels, portals, kaleidoscopes, starbursts, mandalas, title pieces via Python+moderngl GLSL). Use with beat-synced-montage-builder when a montage needs generated clips, stills, or procedural audio-reactive elements instead of, or alongside, sourced footage.

song-edit-analysis

Analyze songs and audio files for beat-synced video editing, clip timing, energy mapping, viral window selection, onset-locked cut grids, footage selection, and agent-readable edit briefs. Use when an agent needs to inspect an MP3/WAV/M4A/audio track, estimate tempo and beat grids, identify sections, produce cut markers, pick the best 15-30s window of a song for short-form video, or guide a human or another agent in choosing footage that matches musical energy.

Skills relacionados