Communitygithub.com

CrissAlvarezH/video-script

Escribe guiones para videos cortos que enganchan a los espectadores, utilizando las analíticas del propio creador. Úsalo para elegir el gancho de una idea, escribir o ajustar un guion antes de grabar, o convertir las lecciones de un video publicado en aprendizajes.

¿Qué es video-script?

Esta habilidad convierte datos de audiencia reales en guiones de video corto diseñados para retener espectadores. No se basa en suposiciones: lee el perfil del creador, su biblioteca de videos pasados y un archivo de hallazgos para tomar decisiones sobre el gancho, las primeras dos frases y la prueba visual. El proceso se divide en dos tareas principales: **Guion** (escribir desde cero o refinar una idea existente) y **Revisión** (analizar un video publicado para extraer lecciones y mejorar futuros guiones). Cada guion se construye en torno a una sola idea, con un gancho que abre una pregunta, un desarrollo que retiene la respuesta hasta que se abre otra pregunta, y un final que cumple la promesa del gancho. La habilidad también comprueba cada afirmación contra fuentes verificables y ajusta el ritmo según el perfil del creador (por defecto, 3 palabras por segundo). Los hallazgos medidos en la audiencia del creador tienen prioridad sobre cualquier regla general, lo que hace que esta herramienta sea especialmente útil para creadores que buscan mejorar su retención basándose en datos reales, no en intuiciones.

Compatible con✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/CrissAlvarezH/ai-reel-gen-app/tree/HEAD/.claude/skills/video-script

Preguntar en tu IA favorita

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

Documentación

Guion de video

Un video corto se decide en su mayor parte antes de filmar, mediante tres elecciones: la apuesta (quién, más allá de los internos, tiene una razón para importarle), las primeras dos frases (por qué seguir viendo) y la prueba (lo que el espectador ve que hace real la afirmación). Toma cada elección basándote en evidencia: primero en los videos pasados del creador, luego en declaraciones de la plataforma, y por último en el gusto personal.

Lo que el espectador busca es la respuesta a una pregunta. La curiosidad los mantiene, y cada respuesta les da una razón para irse, por lo que un guion es un equilibrio entre ambas: abre una pregunta temprano y no la cierres hasta que haya otra abierta.

Configuración

SKILL_DIR significa la carpeta de esta habilidad. Lee ~/.video-script/profile.md si existe: nombra la biblioteca de videos del creador, el archivo de hallazgos, las notas de la plataforma, la voz y el ritmo. Antes de proponer algo, lee el archivo de hallazgos (incluyendo pruebas aún en ejecución) y el índice de la biblioteca, y cita los videos pasados a los que se parece una idea. Cuando los hallazgos entren en conflicto con una regla predeterminada, los hallazgos ganan: fueron medidos en esta audiencia.

Sin perfil, pregunta una vez por la plataforma, la audiencia, y un video pasado que funcionó bien y otro que no, con sus números. Luego ofrece crear el perfil y una biblioteca en el formato de biblioteca.

Objetivo significa para qué está hecho un video: alcance (vistas de no seguidores), seguidores, guardados o compartidos. Cuando la solicitud no mencione ninguno, asume alcance y dilo.

Las tareas aquí son Guion y Revisión de un video publicado; las ideas van a content-ideas. Esta habilidad termina en un guion o una lección: la filmación es del creador, la edición de video-edit, la animación de animated-video.

Ideas

Proponer ideas y guardarlas es tarea de content-ideas. Cuando un guion comienza desde una idea, sus notas ya dicen el gancho, la pregunta que abre, qué se retiene y la prueba: empieza desde ahí, y verifícalas contra la fuente antes de confiar en ellas.

Guion

Expresa la idea en una oración, con su objetivo. Una idea que necesita dos oraciones son dos videos; pregunta cuál hacer primero.

Encuentra la recompensa y la prueba más fuerte antes del gancho, luego escribe el gancho en dos partes: el tema expresado como el resultado que esta audiencia quiere, en sus palabras sobre su problema, luego la afirmación o prueba más sorprendente y verdadera que tengas, que abre una pregunta que el espectador podría poner en palabras. No nombres el sujeto cuando nombrarlo respondería esa pregunta. Redacta al ritmo del creador (del perfil; por defecto 3 palabras habladas por segundo). Tres momentos están atados al reloj, y el tramo entre ellos sigue una regla; el resto toma la forma propia de la historia:

  • 0–3 s, el gancho: sobre la apuesta del espectador o lo que está en pantalla. Las credenciales vienen después, como la razón para creer; un resultado que el espectador quiere cuenta como apuesta cuando abre la pregunta.
  • 3–10 s, la segunda oración: aumenta la apuesta del gancho o afina su pregunta, sin responderla. La mayoría de las pérdidas evitables ocurren aquí, así que los antecedentes esperan. Antecedentes es cualquier cosa que el espectador necesita solo para seguir un detalle posterior (historia, quién es alguien, cómo funciona algo); la prueba: si mover una línea después de los 15 s no pierde nada en los primeros 15, es antecedentes.
  • Entre medio, la respuesta se retiene: la recompensa no es un momento único. Nombra la línea que cierra la pregunta del gancho, a menudo un término que el espectador reconoce: una vez que lo oyen, creen que saben el resto. Antes de eso, va lo que lleva allí y vale la pena escuchar por sí mismo: lo que la mayoría se equivoca, lo que les cuesta, por qué las alternativas obvias fallan. Cuando finalmente se dice, el mismo aliento abre una nueva pregunta, algo sobre ello que no han escuchado. Retener significa darles algo más mientras tanto; una línea que solo provoca o dice "quédate hasta el final" no es retener, es relleno.
  • El final: la recompensa final, la promesa del gancho mostrada en pantalla, luego como máximo una llamada a la acción corta. Cualquier cosa después de la recompensa se dirige a una audiencia que se va.

Para un explicador (cómo funciona algo), lee explicadores antes de redactar.

Junto a cada línea, escribe lo que el espectador ve y la captura que necesita (grabación de pantalla, documento, la persona real o el producto). Una línea que nadie podría dibujar es una que el espectador tiene que retener en su cabeza. Para una película animada, esta columna es una nota para animated-video, que diseña el mundo.

Entrega y guarda donde dice el perfil: el guion como tiempo, línea hablada e imagen en pantalla; la lista de capturas; un borrador de título que lleve las advertencias y enlaces que el guion hablado no puede, cuya apertura plantee la pregunta del gancho en lugar de responderla; la duración estimada; ganchos alternativos, cada uno con su propia segunda oración, cuando la apertura aún está abierta; y las afirmaciones a verificar, con fuentes (marca cualquier fuente que no hayas podido abrir). Haz que un agente nuevo verifique cada afirmación tal como está redactada en el guion contra su fuente: una investigación correcta aún puede estar exagerada en el guion.

Cuando el creador reescriba algunas líneas, traslada las diferencias estilísticas a las líneas que aún posees. Mantén su redacción a menos que te pida editarla, y plantea los problemas factuales por separado.

Lista de verificación

Revisa el guion contra estos puntos, el archivo de hallazgos y las notas de la plataforma antes de entregarlo:

  • Una sola idea. Una lista merece su lugar solo cuando cada elemento prueba esa idea.
  • La apuesta está enmarcada por a quién afecta y qué quieren, en palabras que un no experto entienda. Los nombres de herramientas y la jerga llegan una vez que el espectador tiene una razón para importarle.
  • Lee como el espectador: en cada línea, pregúntate si ahora sentirías que sabes la respuesta y te irías. Si es así antes del punto planeado, mueve la línea o abre la siguiente pregunta allí. Di qué cierra la pregunta del gancho y cuándo.
  • Cada afirmación se muestra. Voz, título y pantalla dan el mismo número.
  • Cada promesa en el gancho se cumple en pantalla.
  • Cada oración, leída por sí sola, dice quién hace qué a qué, y a dónde va cualquier resultado. Reemplaza objetos omitidos y referencias ambiguas con el sustantivo; mantén los pronombres cuyo referente esté claro. Las revisiones rompen esto, así que verifica nuevamente después de cada una.
  • Las líneas son oraciones completas y conectadas en la voz del creador (la guía de voz que nombra el perfil), fáciles de decir en voz alta. Una línea tan corta que plantea una pregunta ("la ruta completa" ¿de qué?) cuesta más de los segundos que ahorra.
  • Cada línea avanza la historia (una línea que repite la anterior o anuncia lo que viene no lo hace), y la duración es tan corta como la historia lo permita.

Revisar un video publicado

  • Registra cada número: vistas, espectadores, tiempo de visualización promedio, seguidores, conteos de interacción, cada tasa con su etiqueta, vistas por fuente, y la curva de retención con su duración (lectura de estadísticas). Desde una captura de pantalla, lee la curva con python3 SKILL_DIR/scripts/retention_curve.py CAPTURA --duration SEGUNDOS y verifica su promedio basado en área contra la cifra de la aplicación. Identifica el video de cada captura de pantalla por su miniatura, fechas del gráfico y conteo de vistas; pregunta cuando esa evidencia no pueda decidir.
  • Alinea la curva con los subtítulos del render final: para cada caída y meseta, registra lo que se dijo y mostró en los segundos anteriores. Compara con la biblioteca: videos en el mismo formato, y la caída de 3→10 s de cada video.
  • Nombra la siguiente versión cuando valga la pena hacerla: el cambio más pequeño que aborde lo que encontraste, como un nuevo gancho o un corte donde la gente se fue, o qué hizo diferente un video que superó a los demás y cómo repetirlo.
  • Escribe la entrada de la biblioteca del video y la fila del índice, luego actualiza el archivo de hallazgos: agrega la evidencia a cada hipótesis que toque, y cambia un estado solo cuando dos o más videos coincidan. Antes de guardar, toma cada línea citada y hora del archivo de subtítulos, no de un resumen; da una fecha de publicación solo con su fuente; verifica cada palabra de ranking (más alto, más bajo, único, mejor) contra el índice, limitado a los videos que cubre.

Individual skills in this repo

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

CrissAlvarezH/animated-video

Make animated videos in code with Remotion (React, SVG, three.js): explainers, character stories, motion graphics, kinetic typography, paper collage and animated infographics, in 2D or 3D, from a script or voiceover, in any aspect ratio. Use when asked to animate a script, make an animated video or Reel, or motion graphics. Not for editing camera footage (video-edit) or AI-generated clips (higgsfield-*).

CrissAlvarezH/new-style

Create a new visual style for the creator's videos in a Reel Studio workspace (styles/<id>/style.json): interview him for its name, feel, colours and what each one means, fonts, motion, where pictures come from, reference links and images, then write the style so it shows in Estilos and new videos can use it. Use when he asks for a new style or presses "Nuevo estilo" on the Estilos page.

CrissAlvarezH/persona-hablando

The "Persona hablando + animaciones" format of a Reel Studio video — the creator talks to camera in his own recording; you transcribe it, agree the cuts with him (pauses, flubs, retakes), cut it, and lay the video's style animations over or between his shots. Use for any video whose format.txt says persona-hablando.

CrissAlvarezH/reel-studio

How a narrated explainer video is made in a Reel Studio workspace, in any visual style — script, pictures, voice, images, build, board, sound, mute test, render — following the creator's settings from the studio (profile, format, voice, image sources). Use for any new or revised video in a project's videos/ (projects/<id>/videos/). The video's style adds its own skill (styles/<id>/SKILL.md) for the look and the Remotion kit; LESSONS.md has what past videos taught.

Skills relacionados