¿Qué hace script?
El escritor escribe lo que el usuario dice en el video. Objetivo: el usuario lo lee una vez y lo graba. Cada oración cumple o demuestra la promesa del título y la miniatura.
Antes de escribir
- El título y el texto de la miniatura están aprobados (
brief/TITLE-vNNN.md). Sin título, no hay guion. - La prueba está aprobada (
brief/PROOF-vNNN.md). Nunca inventes un número, una experiencia o una cita. Si falta algo, pregúntalo a través del chat (crewcut say) antes de escribir; el guion no tiene vacíos ni marcadores de posición. - Lee
voice.md(cómo habla el usuario, palabras que usar y evitar),brand/rules/script.md, y la duración enedit-style.json(length_minutes) junto con la velocidad de habla enchannel.json(script.words_per_minute). - Lee los finales de los últimos tres guiones, para que este veredicto tome una forma nueva.
Estructura
Dos formas. Usa la forma de test para una herramienta o una afirmación; usa la forma de historia cuando algo sucedió (detalles en references/forms.md).
- Apertura, de 2 a 6 oraciones. Los primeros segundos contienen la promesa y su número: la oración 1 nombra la herramienta o el tema y su afirmación. Sin saludo, sin pregunta, sin "en este video". Los primeros 30 segundos confirman el clic: el espectador ve que obtuvo el video que el título y la miniatura prometieron. Como máximo un bucle abierto, resuelto al final.
- El problema, en un caso que el espectador conozca. Explica una herramienta desconocida la primera vez que aparece.
- Lo que hace, en imágenes, solo lo que el espectador aún no sabe.
- La propia prueba, con números reales, redondeados como la gente habla. Solo pruebas de aquello para lo que está hecha la herramienta.
- Una línea de suscripción, justo después del primer resultado fuerte: lo que el espectador obtiene del canal. Si ningún proveedor paga las pruebas, dilo en esa línea. Nunca al inicio, nunca como una súplica al final.
- Pequeñas historias con apuestas crecientes. Cada bloque entre la apertura y el veredicto tiene un objetivo, un obstáculo y una solución; de bloque a bloque las apuestas suben (más datos, más dinero, una prueba más difícil). La prueba más fuerte llega al final, antes del veredicto; la apertura puede anunciarla pero no revelarla.
- El lado crítico. El número del proveedor contra la propia medición o una independiente; los límites. Si la herramienta no cumple su promesa, dilo, y el título vuelve al paso del título.
- El veredicto, en su propia forma cada vez: una tarea para el espectador, el único número que queda, lo que significa para el trabajo del propio usuario, un eco de la imagen de apertura. No una pregunta fija de cierre.
- El final. Si
channel.jsontiene una oferta o una mención obligatoria (script.end_mentions), aparece en las últimas oraciones, en las palabras del usuario. La última oración es laclosing_linedel canal cuando existe.
Videos de comparación: como máximo dos bloques con la misma estructura seguidos; el tercero cambia de forma. Un nuevo gancho a la mitad. Cada afirmación una vez. Costo y tiempo de todos los candidatos una vez, juntos en pantalla, no al final de cada bloque.
Palabras
- Las palabras del usuario de
voice.md; nunca las palabras de su lista de evitar. - Oraciones cortas: mediana de aproximadamente 10 a 12 palabras, nunca más de
script.sentence_max_words. - Como máximo tres nombres de productos en una oración; listas más largas van en pantalla.
- Fuera: conocimiento básico que la audiencia tiene, detalles que a nadie le importan (conteos de pruebas, interruptores internos), nombres de archivos, comandos, temas secundarios, personas privadas, por qué se eligió un ejemplo, costos que no son parte de la promesa.
- Sin tono publicitario o de ventas: di lo que se probó, no prometas nada al espectador. Sin grandes "no esto, sino aquello" en la apertura.
- El negocio se muestra a través de ejemplos, no dirigiéndose al negocio del espectador.
Formato de teleprompter
El usuario lee desde un teléfono al lado de la cámara.
- Solo texto hablado arriba de una línea
---. Las notas para la edición (escenas, clips, de dónde viene cada número) van debajo. - Un párrafo es una respiración: de 1 a
script.paragraph_max_sentencesoraciones. Una línea vacía es una pausa corta. - Tres líneas vacías separan partes: ahí la edición puede cortar, ahí el teleprompter pagina, ahí puede correr un clip.
- Sin corchetes, notas de escena, encabezados, capítulos, marcas de tiempo ni línea de título. Guiones solo si el paquete los permite.
- Marca la o las dos palabras clave de un párrafo en negrita. El modo de puntos del teleprompter las muestra en lugar del texto completo, para un usuario que quiera hablar libremente.
Pasos
- Llena la estructura con los números probados.
- Corta: cada oración cumple o demuestra la promesa.
- Ponlo en la voz del usuario. Lee cada oración en tu cabeza: ¿diría esto el usuario frente a la cámara?
- Escribe el borrador en
work/script-draft-vNNN.mdcon el siguiente número libre; nunca sobrescribas una versión. - Pase de Humanizer (ver abajo). Escribe el resultado en
brief/SCRIPT-vNNN.md(mismo número), luego grábarlo:crewcut humanize record --draft work/script-draft-vNNN.md --final brief/SCRIPT-vNNN.md --why "<los patrones que aplicaron>". - Revisa hasta tener 0 errores:
python3 skills/script/scripts/script_check.py brief/SCRIPT-vNNN.md --title "<título>" --name "<herramienta>" --proof brief/PROOF-vNNN.md. Lee cada advertencia y sugerencia; una sugerencia que mantengas recibe una oración de razón debajo de---. Si cambias el guion para pasar la revisión, graba el pase nuevamente: la tarjeta necesita el registro del archivo exacto. - Tarjeta:
crewcut card propose --episode <id> --step script --kind script --title "Guion, versión N" --file brief/SCRIPT-vNNN.md --body "<palabras>, aproximadamente <min> min, revisión: 0 errores", luegocrewcut card wait. La tarjeta muestra "Humanizado" con lo que cambió; sin el registro es rechazada y dice qué ejecutar. - Después del sí:
crewcut prompter <id>imprime el enlace del teléfono y un código QR. Informa al usuario en un mensaje: el enlace, cuántas partes, aproximadamente cuánto dura. El teleprompter muestra solo el texto arriba de---.
Pase de Humanizer
Todo borrador de guion pasa por Humanizer (blader/humanizer, MIT) antes de que el usuario lo vea: tanto videos largos como Shorts. Crewcut descarga su versión más reciente al inicio; en Claude Code es la habilidad humanizer:humanizer (ejecútala como cualquier habilidad), con Codex su texto está en tu prompt. crewcut skills status muestra la versión.
- Modo "Incrustado", con la voz del usuario. Primero lee cada archivo en
brand/voice/: las palabras habladas del usuario de sus videos. Entrégalas a Humanizer como muestra de voz. Sin muestras: modo simple; la tarjeta lo dice. - Qué buscar más: contrastes "no X sino Y"; líneas de cierre que no añaden nada nuevo; dichos que suenan profundos; una preparación escenificada antes del punto ("aquí está la cosa"); listas de tres; significado inflado y lenguaje publicitario.
- Qué se mantiene: las propias palabras y giros del usuario (los de
brand/voice/yvoice.md) incluso cuando Humanizer los alisaría; cada número, nombre, afirmación y la promesa del título. El pase cambia cómo suena, nunca lo que dice. - Qué está fuera de alcance: hacer que el texto pase detectores de IA. Humanizer edita para personas, y nosotros también.
Lo que la revisión no puede ver
Si un ejemplo se vuelve demasiado amplio, si una parte se sale del hilo, si una prueba encaja con la promesa, si la voz suena como el usuario. Eso es trabajo de lectura en los pasos 2 y 3.
Planeado
- Hoja de referencia para el director y dos tomas por parte (primera libre de la hoja de referencia, luego del guion; la edición toma la mejor toma): formato en
references/forms.md; el verificador y la mezcla de tomas (zettel.pyen el estudio) aún no están portados. - Guion contra grabación: comparar el guion aprobado con la transcripción para aprender las palabras reales del usuario (estas transcripciones pueden convertirse en nuevas muestras de voz).
- Una lista de verificación de frases por idioma (palabras de relleno, frases de venta) como datos en
voice.md.
Fuentes
-
Humanizer de blader, https://github.com/blader/humanizer (MIT), basado en los "Signos de escritura AI" de Wikipedia. Usado como habilidad, descargado al inicio; su texto no es parte de este repositorio.
-
Vexian en el podcast de Grant Owen, "The Crazy Genius Who Solved The Youtube Algorithm": https://www.youtube.com/watch?v=41HMFGbENj4. Tomado: el gancho son los primeros segundos, cada bloque es una pequeña historia, la prueba más fuerte llega al final, la línea de suscripción con independencia, la oferta al final del video.
-
Manual de producción de MrBeast (público desde 2024), resumen: https://simonwillison.net/2024/Sep/15/how-to-succeed-in-mrbeast-production/ Tomado: el primer minuto entrega lo que el título y la miniatura prometieron.
-
Narración en videos cortos de fundadores: Farza (https://www.youtube.com/@farzatv), Chris Raroque (https://www.youtube.com/@raroque), Roy Lee (https://www.youtube.com/@im_roy_lee), Riley Brown (https://www.youtube.com/@rileybrownai), Varun Mayya (https://www.youtube.com/@VarunMayya), Codie Sanchez (https://www.youtube.com/@CodieSanchezCT). Tomado: primera persona, el giro, números reales desiguales.