Pedrovbm1/guion

---

name: guion description: Escribir el guion de un video explicativo corto (Reel, TikTok, Short o un explicador animado en 3D) con datos investigados y con fuente, una idea por frase en plática cotidiana, y una Ronda 0 de revisores (A retención, B datos, C claridad) con umbrales antes de gastar en voz o animación. Termina en la parada GUION LISTO para que el usuario dé su OK. Úsala cuando el usuario pida "un guion", "escríbeme el texto del video", "explícame X en un video", o como primer paso de la skill explicador. También cuando mande un video viral de referencia y quiera "uno igual": se toma el tema y lo que funciona, nunca su guion.

Guion de un explicador

El guion es lo más barato de arreglar y lo más caro de descubrir mal. Rehacer un guion cuando el video ya está construido cuesta horas; leerlo en texto cuesta un minuto. Por eso esta skill siempre para en GUION LISTO.

Salida: una carpeta del proyecto con voz/frases.txt (una frase por línea), MAPA.md (guion visual + datos con fuente) y DECISIONES.md. Si se usa con la skill explicador, el proyecto ya lo creó nuevo.py y el MAPA es el borrador del escena/CONTRATO.md.

1. Recibir la idea

• Si llega un link de video, analízalo con la skill ver-video. De un video ajeno se toma solo el tema y lo que lo hace funcionar (gancho, ritmo, estructura). Nunca su guion, sus frases, sus imágenes ni su música.
• Pregunta lo que no sepas en un solo paquete (máximo 4 preguntas): público, duración, si es suelto o parte de una serie, tono. Lo que decida el usuario va a DECISIONES.md con fecha (se relee después de compactar el contexto).

2. Investigar con fuentes

• Cada cifra, fecha o afirmación verificable lleva su fuente (link + qué dice). Si no hay fuente seria, no entra. Si las fuentes no coinciden, se dice con matiz ("entre 10 y 15", "se estima").
• Las explicaciones de "por qué" que sean teoría o hipótesis se dicen como tal ("se plantea", "una idea es").
• Un "por ejemplo" inventado se dice como ejemplo ("digamos que mide 8 cm").
• Puedes delegar la búsqueda a un subagente con búsqueda web en esfuerzo high (un dato mal dicho cuesta confianza), pero tú revisas las fuentes clave.
• Anota todo en MAPA.md → sección "Datos verificados": dato · fuente · cita corta.

3. Escribir

Reglas de estilo (son las que más suben la retención y la claridad):

1. Una idea por frase. Si una frase tiene "y además", "aunque", o una condición encimada, pártela.
2. Plática cotidiana, como se lo contarías a un amigo: palabras de diario, ejemplos de la casa o el trabajo. Cada término técnico se explica la primera vez o no se usa.
3. Gancho antes de 3 s (a más tardar 4.5 s): una pregunta de curiosidad o algo que contradiga lo que el público cree. El cuadro 0 se tiene que entender sin audio: imagen nítida + pregunta escrita.
4. Promesa y pago: lo que el gancho promete se paga, y se paga con algo que se ve.
5. Un microgancho cada 5-8 s ("pero ojo", "y aquí viene lo raro").
6. Final que regresa al inicio (loop) y una pregunta para comentarios que no sea genérica.
7. Duración: ~16 caracteres por segundo de voz (≈ 3 palabras/s). Un video suelto rinde mejor en 15-30 s; más de 60 s solo si es parte de una serie con nombre y número.
8. Nada de copiar a otros creadores, ni sus frases hechas.
9. Para animación 3D: nada con ojos ni pares de círculos iguales que parezcan ojos (orbes con aros, dos ventanas gemelas, discos con un arco encima). Si el objeto es redondo, el MAPA dice cómo se dibuja para que no lo parezca.

Escribe voz/frases.txt y el MAPA: una tabla con cada frase, su palabra clave (la que manda el cambio de imagen), qué se ve en esa palabra, el letrero exacto si lo hay y su segundo aproximado.

4. Ronda 0 sobre el MAPA (solo texto, antes de voz y animación)

Lanza 3 revisores independientes en paralelo (subagentes, modelo medio tipo Sonnet en esfuerzo medium; B en high). Cada uno lee voz/frases.txt y MAPA.md, no lee lo de los otros, y entrega revision/REV_<letra>_mapa_v<N>.md con calificación /10 y arreglos exactos (qué frase, qué palabra, qué letrero). El encargo está en RONDA0.md.

• A · Retención: cuadro 0 sin audio, gancho < 3 s, promesa y pago, microganchos, tramos de más de 5 s sin cambio, loop, pregunta final, duración.
• B · Datos: cada cifra contra su fuente (la verifica), que cada número dicho tenga su letrero, que no haya en pantalla nada que no esté en el MAPA.
• C · Claridad para un desconocido: cuenta el guion de vuelta como alguien de 15 años; lista cada palabra, nombre, sigla o cifra sin explicar; marca frases con más de una idea y letra chiquita ("en general", "un escenario, no una predicción"). Propone la versión reescrita de cada frase y fija la duración.

Aplica los arreglos y repite hasta A ≥ 9 y C ≥ 9 y B sin hallazgos ALTOS, con máximo 2 rondas. Si a la segunda no pasa, para y mándale al usuario el guion con las notas: no se construye.

5. GUION LISTO (parada obligatoria)

Manda al usuario, en un solo mensaje y en el chat (no como archivo):

• el guion en texto plano (10-12 líneas),
• la duración estimada y las notas de la Ronda 0,
• los datos con su fuente,
• máximo 4 preguntas.

Termina tu turno con GUION LISTO. No generes voz ni lances animadores hasta que el usuario conteste. Este paso no se salta ni cuando el usuario diga "trabaja de corrido": eso aplica a investigar y construir, no a esto.