Communitygithub.com

diseño-bruto-editar-video

Crea videos de marketing que venden la aplicación design:os studio – con metraje real de la app, una idea fresca, apariencia, movimiento y música únicos en cada entrega. Para beat edits en TikTok/Reels/Shorts y tutoriales de 3 a 5 minutos para YouTube con locución en vietnamita aprobada.

¿Qué es diseño-bruto-editar-video?

Esta habilidad automatiza la producción de videos promocionales para la aplicación design:os studio, asegurando que cada clip destaque una característica real de la herramienta, un único beneficio claro y una llamada a la acción directa. La app es la protagonista, no los trucos de edición. La habilidad impone una regla estricta: no hay plantillas fijas; cada video debe diferir por completo del anterior en concepto, metraje, paleta, movimiento y música. Para mantener la originalidad, el sistema lee los briefs anteriores almacenados en el proyecto y evita combinaciones ya utilizadas. La salida es un video final de 1920×1080 píxeles, 30 fps, con audio AAC. Además del formato corto (TikTok, Reels, Shorts), la habilidad soporta tutoriales largos de 3-5 minutos para YouTube con locución en vietnamita, usando el motor TTS aprobado (VieNeu-TTS v3 Turbo, preset "Hải Đăng"). Se integra con herramientas como Openscreen para la grabación de metraje real de la app, y con el puente Prompt Motion para generar ideas de movimiento. Todo el flujo está orquestado mediante scripts de Python: ideación, grabación, llenado de especificaciones, validación correspondiente a compases y rejillas, renderizado y control de calidad. La habilidad funciona en macOS y requiere Python 3, numpy, Pillow, ffmpeg/ffprobe y las fuentes tipográficas del sistema.

Compatible con~Claude Code✓Codex CLI✓Cursor
npx skills add https://github.com/NamAIEngineer/bundle-skill-video/tree/main/designos-beat-edit-video

Preguntar en tu IA favorita

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

Documentación

¿Qué hace diseño-bruto-editar-video?

Propósito: comercializar la aplicación design:os studio. Cada video muestra la app real haciendo algo que el espectador desea ver (una función, una promesa clara, una llamada a la acción). La app es la protagonista, no el truco de edición.

No es una plantilla fija. Cada video debe ser diferente de todos los anteriores: idea nueva, función o tarea nueva mostrada, metraje nuevo, estructura nueva, paleta y fondo nuevos, lenguaje de movimiento nuevo, música nueva. La creatividad debe destacar en los primeros 3 segundos. Antes de planificar, lee los briefs anteriores en el Proyecto (orca-briefs/*designos*) y elige opciones que ninguno de ellos haya usado; escribe las elecciones en el nuevo brief para que el siguiente video pueda evitarlas. (engine/ideate.py, engine/music.py, references/creative-brief.md ayudan con esto.) spec/design-in-4-4.spec.json es solo un ejemplo trabajado (su metraje es antiguo: no lo reutilices nunca, graba siempre metraje nuevo).

Un único fichero JSON de especificación lo maneja todo: video (render.py), audio (audio.py), comprobaciones (beatlib.validate, qa.py). Un video nuevo = una especificación nueva + tomas nuevas en bruto. Sin cambios de código.

Lote: python engine/ideate.py batch --count 30 --seed N --out batch/ genera N planes diferentes (estilo, bpm, concepto, paleta, estructura, cortes, duración, función) más manifest.json. Consulta references/chatgpt-instructions.md.

Regla estricta

Todo el metraje proviene de la aplicación real design:os studio (Openscreen --window "design:os studio"), grabado nuevo para cada video. Sin maquetas, sin otra app, sin tomas antiguas.

Flujo de trabajo

  1. python engine/ideate.py plan --edits N --seed <nuevo> --out plan.json -> concepto, estilo musical + bpm, paleta, estructura, dónde cae cada corte. Reescribe el copy tú mismo. Después de grabar: ideate.py build plan.json times.json --out spec.json. Música: 5 estilos generativos (house, lofi, trap, synthwave, cinematográfico), establecidos en spec.music.
  2. Graba metraje real de la app (Openscreen, --window "design:os studio", cursor con superposición editable). Reglas: haz clic, pausa unos 0.8 s, luego escribe. Muestra la app completa. Cursor similar al humano. Graba más tiempo del necesario para la acción.
  3. Rellena la especificación (spec/design-in-4-4.spec.json es el ejemplo en uso; campos en references/spec-fields.md). Por cada corte solo necesitas los tiempos de metraje en bruto: tc (el cursor empieza a hacer clic en la barra lateral), hit (la pantalla cambia), td (doble clic en el texto), ts/te (primer/último carácter escrito), más T = la línea de compás (segundos de video) donde cae el corte.
  4. python engine/run.py validate spec.json - falla si un corte está fuera de una línea de compás, la escritura está fuera de la rejilla de semicorcheas, la pausa clic-texto es demasiado corta, o las escenas no cubren la línea de tiempo.
  5. python engine/run.py all spec.json --root <directorio con tomas en bruto> --out <directorio> -> final.mp4 (1920×1080, 30 fps, AAC) y ejecuta qa.py. Parcial: render F N (escenas), audio, mux, qa.
  6. Revisa 3-4 fotogramas y la hoja de contactos antes de entregar. Nam publica él mismo; nunca publicar.

Barreras de seguridad (Marketing HQ)

GRATIS, decir "código fuente disponible" (nunca "código abierto"), nada de "Figma killer", "Vista de desarrollador", solo funciones ya lanzadas, cada afirmación respaldada por metraje real. El video trata sobre el producto, no sobre su realización.

Por qué funciona

El tiempo del metraje se asigna al tiempo del video mediante anclas (beatlib.Timeline.anchors), de modo que un clic cae en la línea de compás independientemente de la velocidad a la que se grabó. 120 BPM: pulso 0.5 s, compás 2 s, un carácter escrito = 0.125 s.

Verificado

La escena F renderizada de nuevo desde la especificación es idéntica fotograma a fotograma (PSNR inf) a la original; el audio WAV es idéntico byte a byte. El pico predeterminado de 0.89 dio un pico real de +0.7 dBFS en la muestra; para videos nuevos, establece audio.peak en aproximadamente 0.8.

Requisitos

python3, numpy, Pillow, ffmpeg/ffprobe; fuentes macOS (HelveticaNeue.ttc, SFNSMono.ttf) o edita fonts en la especificación. legacy/design-in-4-4/ conserva los scripts originales (tl.py, make8.py, audio9.py, cursor2.py) como referencia.

Prompt Motion: úsalo en cada video

Las herramientas del puente Prompt Motion (Prompt_Motion_Bridge__recommend_motion_references, search_motion_references, get_motion_reference) son la fuente de ideas de movimiento. Para cada video:

  • Describe cada escena (gancho, tarjetas de capítulo, transiciones, llamadas, subtítulos, estadísticas/resumen, tarjeta final) y pide referencias; busca con palabras clave nuevas cada vez (kinetic type, mask reveal, morph, parallax, split-screen, glitch, liquid, stagger, counter, 3D tilt...).
  • Elige al menos 5 referencias diferentes por video y constrúyelas en código (PIL/numpy/ffmpeg o Remotion). Anota los IDs de las referencias en el brief y no reutilices el mismo conjunto que el video anterior.
  • Brillante, mucha animación, pero el metraje de la app sigue siendo el protagonista y legible.

Tutorial largo (3-5 min, locución en vietnamita, YouTube)

El primero aprobado por Nam el 2026-11-16 (final_v3.mp4, 4:21: proceso de 6 pasos desde una plantilla .fig hasta pantallas de escritorio+móvil). Trátalo solo como un ejemplo: el próximo video largo necesita un tema, metraje, estructura y aspecto diferentes. Código inicial: longform/ en esta habilidad (también en el Mac en longform/): README.md, script2.py, gen_tts.py, lib.py, build.py, audio.py. Cópialo a un nuevo espacio de trabajo y cámbialo: capítulos, diseño, diseño de tarjetas y subtítulos, fondo, paleta, movimiento (de Prompt Motion), estilo musical y tempo. Nunca entregues el mismo aspecto dos veces.

Ideas: cada video elige su propio ángulo y formato, p. ej. un desafío contra un cronómetro, transformación antes/después, análisis profundo de una función, "3 errores que cometen los principiantes", rediseño de una pantalla realista, construir un sistema de diseño pequeño, mobile-first, speed-run, preguntas y respuestas. Cada capítulo debe mostrar algo que el espectador desee; un capítulo que sea solo "un error que cometí" fue rechazado por irrelevante. Solo funciones ya lanzadas; verifica en la app antes de prometer alguna (la vista previa de reproducción arriba a la derecha ▷ funciona y se ve genial).

Metraje: graba nuevo con Openscreen para cada video (plantilla o archivo diferente, pantallas diferentes, ediciones diferentes). Openscreen graba solo la ventana de la app, no los diálogos nativos de macOS: muestra el selector de archivos como una llamada de texto, nunca una maqueta. Selecciona capas de texto en Capas, presiona Intro, verifica que el texto esté resaltado, luego escribe; escribir en un campo sin foco activa atajos de teclado. Antes de que la locución afirme una edición, verifica el estado de la app nuevamente (una vez un deshacer revirtió silenciosamente el texto de un botón).

Voz (aprobada por Nam): VieNeu-TTS v3 Turbo, preset "Hải Đăng". Se ejecuta en el Mac (.venv-voice/bin/python, gen_tts.py), 48 kHz, ~0.3× el tiempo real. No clones la voz de Jang sin su permiso por escrito.

  • Genera frase por frase con 0.18 s de ceros exactos entre frases; los subtítulos se sincronizan desde esos espacios, por lo que el texto mostrado y el texto TTS deben tener el mismo número de frases.
  • Mantén dos textos: el mostrado (subtítulos, ortografía correcta) y el TTS (reescrito con fonética). Aprobado: "Design OS Studio" -> "Đi-giai Âu-ét Studio" (mantén "Studio" en inglés), "Figma" -> "Phích-ma", ".fig" -> "phích", "megabyte" -> "mê-ga-bai". Nunca TODO MAYÚSCULAS "DESIGN OS" (deletreado letra por letra).
  • Nam rechaza la pronunciación incorrecta del inglés: habla vietnamita para palabras de la interfaz (bảng lớp, vùng vẽ, bảng thuộc tính, phím xuống dòng, phím thoát, màu nền); las cadenas en inglés en la interfaz van solo en llamadas.
  • Nueva reescritura fonética: prueba 5-7 variantes, verifícalas con faster-whisper (vi, en), envía a Nam una muestra WAV corta y solo reconstruye después de su visto bueno.

Reglas de imagen: 1920×1080, 30 fps. El metraje en bruto de Openscreen solo tiene 1600 px de ancho, por lo tanto, mantén el zoom de la cámara en o por debajo de ~1.6× (más arriba se ve borroso en YouTube). Ajusta todo el texto dentro de su tarjeta (auto-encoger) y verifica que los fotogramas de resumen/estadísticas no se desborden. La tarjeta final muestra la URL completa https://jangtrinh.github.io/design-os-studio/ grande durante 8-10 s más "Código fuente disponible · No afiliado a Figma".

Entrega: exporta 1080p más una versión 4K mejorada (lanczos, crf 16); envía la 4K para YouTube, solo después de que ffprobe lea su duración completa. Dile a Nam que mantenga la subida privada hasta que YouTube muestre 2160p. Proporciona una sugerencia de título clara más una descripción con marcas de tiempo de capítulos, el enlace, el crédito de la plantilla y "No afiliado a Figma". Nunca publiques; Jang da la aprobación final.

Archivos de referencia en este paquete

  • references/openscreen.md + tools/record.sh: comando exacto de Openscreen, dónde caen las tomas, formato de cursor.json, mapeo de pantalla.
  • references/voice.md + longform/gen_tts.py + longform/check_voice.py: voz aprobada, instalación, tabla de reescritura, verificación con Whisper.
  • references/prompt-motion.md: cómo usar las herramientas Prompt Motion, referencias ya utilizadas, alternativa sin el MCP.
  • references/chatgpt-instructions.md: transferencia para ChatGPT/ORCA/Codex, ahora con el modo de formato largo.
  • longform/: motor inicial para el video largo (ROOT=<directorio de trabajo> python build.py info|agenda|<capítulo>, python audio.py).

Skills relacionados