CommunityRedacción y edicióngithub.com

script

Escribe el guion hablado de un episodio con la voz del usuario, en formato de teleprompter, una vez que el título y la prueba están fijados.

¿Qué es script?

La habilidad 'script' genera el guion hablado de un episodio de video utilizando la voz única del usuario (definida en `voice.md`) y en formato de teleprompter. Está diseñada para que el usuario lea el guion una sola vez y lo grabe, asegurando que cada oración cumpla o demuestre la promesa del título y la miniatura, sin pausas ni marcadores de posición. Soporta dos formas estructurales (test y story) dependiendo del contenido, e incluye un pase de 'Humanizer' para naturalizar el lenguaje preservando números, nombres y hechos verificados. Se utiliza mediante comandos como 'write the script' o 'teleprompter text', y verifica la corrección del guion con un script de comprobación dedicado (`script_check.py`).

Compatible con✓Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/marcopatzelt/crewcut/tree/HEAD/skills/script

Installed? Explore more Redacción y edición skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

Preguntar en tu IA favorita

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

Documentación

¿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

  1. El título y el texto de la miniatura están aprobados (brief/TITLE-vNNN.md). Sin título, no hay guion.
  2. 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.
  3. Lee voice.md (cómo habla el usuario, palabras que usar y evitar), brand/rules/script.md, y la duración en edit-style.json (length_minutes) junto con la velocidad de habla en channel.json (script.words_per_minute).
  4. 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).

  1. 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.
  2. El problema, en un caso que el espectador conozca. Explica una herramienta desconocida la primera vez que aparece.
  3. Lo que hace, en imágenes, solo lo que el espectador aún no sabe.
  4. La propia prueba, con números reales, redondeados como la gente habla. Solo pruebas de aquello para lo que está hecha la herramienta.
  5. 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.
  6. 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.
  7. 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.
  8. 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.
  9. El final. Si channel.json tiene 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 la closing_line del 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_sentences oraciones. 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

  1. Llena la estructura con los números probados.
  2. Corta: cada oración cumple o demuestra la promesa.
  3. Ponlo en la voz del usuario. Lee cada oración en tu cabeza: ¿diría esto el usuario frente a la cámara?
  4. Escribe el borrador en work/script-draft-vNNN.md con el siguiente número libre; nunca sobrescribas una versión.
  5. 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>".
  6. 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.
  7. 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", luego crewcut card wait. La tarjeta muestra "Humanizado" con lo que cambió; sin el registro es rechazada y dice qué ejecutar.
  8. 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/ y voice.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.py en 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

Individual skills in this repo

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

edit

Builds a video version from the user's recording: the speaker cut, then one edit plan with all inserts (2D scenes, 3D scenes, recordings, keywords), sound and music, built with one command (crewcut render). Use for: edit the video, build the cut, speaker cut, rough cut, insert, b-roll, 2D scene, 3D insert, counter, keyword, music bed, sound, assemble, render the preview, new plan version, short from the long video.

shorts

Makes YouTube Shorts in two modes: Clip (cut from a finished episode: candidates from the transcript and retention, a 9:16 rough cut from the original recording around the face, portrait graphics, music with clear rights, the Critic's own Short check) and Original (a Short recorded for itself: three ideas with a proof from the user's real work, the user talks freely, the Writer shortens, only the speaker is recorded, the crew brings the B-roll). Publishing: one card per Short, or the user's own standing approval for Shorts; at most two a day. Use when: \"make shorts\", \"make a short about …\", \"clip this episode\", \"short from episode N\", \"publish shorts without asking\", \"how are my shorts doing\". Not for long videos (skills/episode, skills/edit).

title

Writes and checks the YouTube title and the thumbnail text of an episode, before the script. Delivers five candidates with a hook and a reason each, one recommendation, and three variants for the A/B test; skills/title/scripts/title_check.py checks every candidate against the style pack. Use when: \"title\", \"video title\", \"YouTube title\", \"what should the video be called\", \"check this title\", \"shorten the title\", \"better title\", \"thumbnail text\". Not for the blog's search title and not for the thumbnail image.

Skills relacionados