Samix2026/yt-ar-script

¿Qué hace yt-ar-script?

Una idea se convierte en un guion que el espectador termina de ver.

Dos herramientas en esta carpeta y ambas funcionan realmente. Úsalas. No juzgues la apertura con los ojos.

python3 hookscore.py hooks.txt              # Ordena tus opciones
python3 hookscore.py --hook "una línea"      # Mide una sola apertura

Antes de escribir

1. Lee ~/.claude/youtube-ar/voice.md si existe. Este archivo contiene la voz del usuario: cómo habla frente a la cámara, su dialecto, las palabras que no usa, a quién se dirige, y qué no afirma. Si no existe, pide tres de sus videos, léelos o transcríbelos, deduce la voz y escribe el archivo. Un guion con una voz que no es la suya es peor que no tener guion, porque lo leerá con su propia voz.
2. Escribe en el dialecto que está en el archivo de voz. No mezcles árabe clásico formal con coloquial en la misma oración a menos que ese sea su estilo.
3. No inventes números, resultados ni fuentes. Si un número fortalecería la oración y no lo tienes, pregunta por él o escribe la oración sin él. En los ejemplos de hooks.json, los números entre corchetes son lugares sin valor.

Estructura

Los primeros 15 segundos son todo el trabajo. Deben hacer tres cosas o el video se pierde: confirmar el clic que prometió el título, abrir una pregunta que el espectador no pueda cerrar, y demostrar que la respuesta existe.

1. La apertura. Escribe cinco de las veintiuna fórmulas, pásalas por hookscore.py, conserva las dos mejores, y preséntaselas al usuario con sus puntuaciones. Nunca entregues una sola apertura.
2. El giro (0:15 a 0:45). Di qué hará el video en una oración y comienza a hacerlo. Sin introducción del canal, sin "antes de empezar", sin saludos largos, sin pedir suscripción. Estas son las causas más comunes de abandono a los 0:30.
3. El cuerpo. Una idea por cada pulso. Marca cada pulso con lo que aparece en pantalla, no solo lo que se dice. Un rostro que habla sin nada que mirar es un podcast.
4. El premio. Entrega explícitamente lo que prometió la apertura y di que lo estás entregando: aquí está la tabla, la encuentras en la descripción.
5. El cierre. Una sola solicitud. No tres.

Lo que entregas

• Las dos mejores aperturas con su tabla de puntuación para cada una
• El guion pulso a pulso, con [en pantalla: ...] en cada pulso
• Estimación de duración basada en 130 palabras por minuto para el habla árabe hablada
• Una línea que nombre la fórmula de apertura ganadora y por qué se ajusta a esta idea

Límites de la herramienta

hookscore.py es inferencial y no está calibrado para rendimiento real en su versión árabe. Distingue bien entre una apertura cuidadosamente escrita y una que comienza con saludos y bienvenidas, pero no predice vistas. Si contradice tu intuición y conocimiento de tu audiencia, la intuición gana. La fórmula que menciona es un juicio sobre palabras, no sobre la razón del éxito.

Lengua y almacenamiento

• Todas las salidas en el idioma del usuario. Si escribe en árabe, la explicación, las tablas y la lista de revisión son todas en árabe, no solo el guion.
• Si el archivo de voz o ~/.claude/youtube-ar/brand.md especifica un directorio de trabajo, guarda las salidas allí como archivos y no las dejes solo en la conversación.

Puerta de salida

Nada de esto se publica. Esta habilidad escribe mientras tú publicas. Cada salida termina con un bloque que el usuario copia, y la última línea de cada ejecución es la pregunta: ¿Lo publicamos o lo editamos?