Communitygithub.com

Hownameee/videos-cortos

Ejecuta la Fase 2 del flujo de trabajo de video corto: convierte una dirección seleccionada y su investigación en un guion gráfico, narración, tiempos flexibles de escena, texto en pantalla, plan visual, subtítulos, pistas de música y efectos de sonido, notas de pronunciación, remate, conclusión y CTA contextual. Úsalo cuando un usuario solicite escribir, revisar, previsualizar o aprobar un guion de video corto. Detente para la aprobación del guion y no generes TTS ni renderices el video todavía.

¿Qué es videos-cortos?

Este skill gestiona la Fase 2 de la creación de videos cortos, transformando una dirección de contenido seleccionada y su investigación asociada en un guion completo y listo para revisión. Es parte de un flujo de trabajo más amplio que abarca desde la definición de la dirección hasta la producción final del video. El skill se ejecuta en dos pasadas: primero, genera un esquema de escenas (beat sheet) que define la estructura narrativa (gancho, promesa, desarrollo, remate, conclusión y CTA) con tiempos estimados. Luego, produce un guion detallado con narración, texto en pantalla, plan visual, instrucciones de subtítulos, pistas de música y SFX, notas de pronunciación y un plan de sonido compacto. El skill está diseñado para plataformas como Claude Code, Cursor o Codex que siguen el flujo de trabajo 'short-video-workflow'. Su utilidad principal es asegurar que el guion esté completo y coherente antes de pasar a la fase de producción, evitando generar TTS o renderizar video prematuramente. Requiere que la dirección esté explícitamente seleccionada y que la investigación esté actualizada, y aplica valores predeterminados de producción como resolución 2160x3840 a 60 fps, modo de subtítulos 'word-highlight' y un plan de sonido detallado.

Compatible con✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Hownameee/short-videos/tree/HEAD/.agent/skills/short-video-script

Preguntar en tu IA favorita

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

Documentación

Guion de Video Corto

Propietario de la Fase 2. Lee la dirección seleccionada y su investigación antes de escribir. Usa los contratos de artefactos al persistir la salida.

Precondiciones

Confirma que la dirección esté explícitamente seleccionada. Si falta, redirige a short-video-discovery. No elijas una dirección en silencio a menos que el usuario haya solicitado selección automática; al seleccionar automáticamente, usa la dirección recomendada y registra esa suposición.

Exige que la dirección seleccionada haga referencia a la versión actual de la investigación. Si la investigación falta o está desactualizada, detente y repara la Fase 1 en lugar de rellenar vacíos desde la memoria.

Rechaza o suaviza cualquier gancho que sea más fuerte que la investigación. Mantén los ID de fuente asociados a afirmaciones factuales a través del plan de escenas.

Escribir en dos pasadas

Esquema de escenas

Define el trabajo de cada escena antes de escribir la narración pulida:

  1. gancho de tensión;
  2. promesa, que puede superponerse al gancho;
  3. configuración del caso de uso cuando sea necesario;
  4. de una a tres escenas explicativas o demostrativas;
  5. remate con prueba o resultado;
  6. conclusión de una oración;
  7. un CTA contextual, que puede superponerse al remate.

Trata el tiempo como un presupuesto:

SecciónDuración típica
Gancho de tensión3–7s
Promesa2–5s
Configuración del caso de uso4–10s
Explicación/demo20–40s
Remate/evidencia5–15s
Conclusión2–6s
CTA contextual2–6s

Los presupuestos pueden superponerse y no necesitan llenar la duración objetivo. Termina temprano cuando el remate esté completo.

Guion y plan de escenas

Escribe para escuchar: cláusulas cortas, una idea por oración, verbos concretos y pausas naturales. Evita un saludo, logotipo independiente de introducción, listas densas, experiencia personal falsa y estadísticas sin respaldo.

Para cada escena proporciona:

  • propósito y duración flexible;
  • narración exacta;
  • texto en pantalla;
  • tipo visual, acción y necesidades de activos;
  • intención de agrupación de subtítulos;
  • pista de música y SFX;
  • transición;
  • IDs de fuente;
  • notas de pronunciación Kokoro para acrónimos, nombres de productos, números y URLs.

Aplica los valores predeterminados de producción del repositorio: los nuevos videos usan meta.width: 2160, meta.height: 3840, meta.fps: 60 a menos que se sobrescriban explícitamente. Sigue el formato registrado de la solicitud; no copies metadatos de proyectos antiguos de 1080p/30 fps en un nuevo guion predeterminado. El comando draft rellena los campos de formato faltantes antes de la aprobación. Planifica el movimiento en segundos para que su velocidad sea independiente de fps. Mantén los valores predeterminados de salida en inglés, captions.mode: "word-highlight", y un plan de movimiento concreto por escena. Registra qué cambia visualmente, su pista de narración y el estado final; "aparece gradualmente la diapositiva" por sí solo no es un plan de movimiento de escena. Diseña grupos de subtítulos para una o dos líneas; los tiempos reales de las palabras provienen de la generación de voz, no del guion.

Incluye el plan de sonido compacto de los valores predeterminados en las notas de producción: emoción prevista, música a través de gancho/explicación/revelación/final, ducking y pistas de acento selectivas vinculadas a la narración o los visuales. "Música ambiental" o una lista de SFX vacía por sí sola no es un plan de sonido. Transfiérelo a producción sin requerir otro recordatorio; respeta y registra una anulación de sonido explícita del usuario.

Cuando el usuario solicite una dirección de arte detallada o el plan de escenas defina un diseño, tipografía, color, diagrama, subtítulo, movimiento o comportamiento de transición concretos, lee ../short-video-visual-design/SKILL.md. Mantén la planificación visual a nivel editorial en la Fase 2; el JSX detallado sigue siendo trabajo de la Fase 3.

Trata las ortografías de pronunciación como candidatos para audicionar, no como instrucciones de renderización autoritarias. Esto importa cuando el idioma del guion carece de una voz oficial en el proveedor de TTS seleccionado.

Estima la duración del habla y marca las escenas que son demasiado densas. No resuelvas una escena demasiado larga aumentando ciegamente la velocidad del TTS; acorta el texto o expande la escena primero.

Formato de revisión

Presenta un script.md legible para humanos en este orden:

  1. título, audiencia, rango de duración, tono;
  2. gancho, promesa, remate, conclusión, CTA;
  3. una tabla de escenas que contenga la función de escena, narración y notas de producción;
  4. solo las fuentes, candidatos de pronunciación, suposiciones y advertencias que no estén ya claras en la tabla;
  5. duración total estimada.

Pide una decisión: aprobar el guion o enumerar revisiones. No llames a Kokoro, obtengas activos de producción, inicies Remotion Studio ni renderices mientras la aprobación esté pendiente.

Registra las ediciones con video script --draft (también compatible después de la producción). Después de la aprobación explícita, usa video script --approve; no establezcas manualmente hashes ni marcas de tiempo de aprobación. Registra script_approved. Redirige a short-video-production solo cuando el usuario también solicite una vista previa o un render final; la aprobación por sí sola espera en la puerta.

Individual skills in this repo

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

Hownameee/short-videos

Generate, revise or troubleshoot local Kokoro narration, pronunciation and scene word timing. Reuse verified unchanged clips; inspect the Python environment before setup changes. Exclude research, visuals, music composition and publishing.

Hownameee/short-videos

Router for all Remotion skills

Hownameee/short-videos

Transcribing, displaying and animating captions

Hownameee/short-videos

Structure Remotion markup for interactivity

Hownameee/short-videos

Remotion Map animation knowledge

Hownameee/short-videos

Content, animation and effects best practices

Hownameee/short-videos

Upgrade Remotion, and related packages

Hownameee/short-videos

>- Run Phase 1 of the shared short-video workflow: turn a raw topic or prompt into a sourced research pack and 2–4 distinct video directions, each with a defensible tension hook, promise, payoff, beats, visual approach, duration range, and risks. Use whenever the user asks for video ideas, angles, research, facts, hooks, topic analysis, or choices before scriptwriting. Stop for the user's direction choice and do not silently continue into script or production.

Hownameee/short-videos

Produce an approved short video or correct an existing video's background sound, emotion, captions, mix or export. Generate only changed narration, render and review a current preview, run technical and editorial QC, then export. Exclude script-only and general audio-advice requests.

Hownameee/short-videos

>- Design and review a coherent visual system for short-form video before and during Remotion implementation. Use for video art direction, scene UI, typography, layout, color, diagrams, captions, motion, transitions, platform safe areas, or visual-quality review. Use Remotion skills separately for API, timeline, media, Studio, and rendering behavior; do not use this skill for narration-only or research-only work.

Hownameee/short-videos

Coordinate prompt-to-short-video discovery, scripting and production. Resume existing projects and route soundtrack or mix corrections directly to production. Preserve direction choice and script approval; exclude general audio advice.

Skills relacionados