guionización-de-reels

Guionización de Reels

Entorno de ejecución en Codex y Claude

• Usa esta habilidad en Codex o Claude con las herramientas realmente disponibles en la tarea actual. Los ejemplos de AskUserQuestion describen las preguntas, no una API obligatoria: usa una herramienta de preguntas disponible dentro de sus límites, o pregunta en el chat. Reutiliza las respuestas y el material fuente ya proporcionados.
• Trabaja en el proyecto seleccionado por el usuario. Lee su about-me.md, voice.md y los archivos de marca relevantes antes del trabajo personalizado. Confirma el autor previsto si los archivos entran en conflicto o contienen valores predeterminados de inicio. Pide los datos faltantes o ejecuta voice-builder; nunca heredes la identidad, cuentas o archivos privados del mantenedor.
• Resuelve los references/ empaquetados con respecto a esta carpeta de habilidad. Para una actualización de perfil solicitada explícitamente, lee y actualiza el about-me.md, voice.md o newsletter-voice.md canónicos en su lugar, conservando hechos y reglas de usuario no relacionados. Los consumidores deben volver a leer esos archivos canónicos. Usa un nombre de archivo nuevo solo para nuevos entregables que colisionarían con archivos existentes no relacionados. La instalación por sí sola nunca inicia una entrevista ni escribe archivos. No escribas aprendizajes persistentes a menos que se solicite.
• Usa primero la evidencia proporcionada. Verifica afirmaciones externas a través de herramientas de búsqueda/fuente disponibles cuando sea necesario. Si una fuente o integración no está disponible, nombra la capacidad faltante y ofrece la entrada de texto/exportación proporcionada. Nunca inventes hechos, experiencia en primera persona, métricas o una ejecución exitosa de una herramienta.
• Conecta solo los servicios necesarios para la ruta elegida a través de la cuenta existente del usuario. Nunca imprimas credenciales ni sobrescribas conexiones. Redactar, guardar y revisar no autorizan publicar, enviar mensajes ni cambiar cuentas.

CRÍTICO: Inicio automático al cargar

Cuando esta habilidad se active, ve directamente al Paso 1. No resumas.

Prerrequisitos

La ruta completa de análisis de video Apify + Gemini necesita:

• Variable de entorno APIFY_API_TOKEN (extracción de Instagram)
• Variable de entorno GOOGLE_AI_API_KEY (análisis de video con Gemini 2.5 Flash)
• Node.js 18+ y los paquetes apify-client y @google/generative-ai

Verifica solo las capacidades necesarias para la ruta elegida. Para la extracción de URL y el análisis de video con Gemini, verifica que las credenciales existentes del usuario estén presentes sin imprimirlas, luego verifica que el proveedor y el modelo estén disponibles. La falta de credenciales, paquetes, un video privado o un modelo no disponible deja esa etapa pendiente. Explica qué falta; no modifiques la configuración de la cuenta ni sustituyas silenciosamente a un proveedor.

Un video proporcionado puede saltarse Apify. Una transcripción/análisis proporcionado puede saltarse los Pasos 3 y 4 y respaldar un guion basado en transcripción etiquetada en el Paso 5, pero no es un resultado de análisis de video de Gemini. Reutiliza los paquetes instalados; consulta la documentación oficial actual del SDK y del actor antes de generar un script auxiliar, y obtén la aprobación del usuario antes de incurrir en costos del proveedor.

Paso 1. Obtén la referencia

Pregunta:

Pega la URL del Reel de referencia o el enlace de Notion. Este es el Reel atípico del que quieres aplicar ingeniería inversa a su formato.

Espera la URL.

Si el usuario pega un enlace de Notion, léelo a través de un conector de Notion autorizado disponible, localiza la URL del Reel de Instagram en la página y extráela. Si no se encuentra ninguna URL de Reel en la página de Notion, pide al usuario que pegue la URL del Reel directamente.

Paso 2. Obtén el tema del boletín

Pregunta:

¿Cuál es el tema de tu boletín que quieres reutilizar en este Reel? Pega la sección relevante del boletín, o escribe la idea central en una frase.

Espera el tema. Lee newsletter-voice.md, voice.md y about-me.md del proyecto si existen, para que el guion coincida con la voz del usuario.

Paso 3. Extrae y descarga el Reel

Usa una nueva carpeta outputs/reels/<slug>/ en el proyecto seleccionado. Reutiliza un helper existente adecuado si está presente; de lo contrario, escribe allí un pequeño script de Node.js específico para la tarea que:

1. Use apify-client y la ruta existente apify/instagram-reel-scraper, después de verificar su esquema documentado actual, para el único Reel solicitado. Nunca extraigas comentarios, respuestas o hilos de comentarios, incluso a través de deepScrape o numComments. Verifica que el proveedor admita la recopilación solo de publicaciones/video antes de llamarlo; de lo contrario, solicita una carga de video. No adivines entradas alternativas del actor.
2. Extraiga videoUrl del elemento devuelto.
3. Descargue el video en outputs/reels/<slug>/downloads/{username}_{shortCode}.mp4.
4. Guarde los datos sin procesar de la extracción en outputs/reels/<slug>/reel_data_{shortCode}.json.

Ejecuta el script. Confirma el tamaño del archivo y los metadatos (vistas, me gusta, recuento de comentarios agregado si está disponible, primeros 200 caracteres del pie de foto) antes de continuar.

Un solo Reel es una referencia, no un atípico verificado. Llámalo atípico solo cuando los datos de comparación proporcionados o solicitados explícitamente establezcan su rendimiento en relación con las publicaciones recientes del mismo creador; cita la muestra, la ventana y los múltiples. No inventes esa línea base.

Paso 4. Analiza con Gemini 2.5 Flash

Extiende el script de Node (o ejecuta una segunda pasada) que:

1. Lea el .mp4 descargado como base64.
2. Llame a genAI.getGenerativeModel({ model: 'gemini-2.5-flash' }).
3. Envíe el video con este mensaje exacto:

Estoy estudiando este Reel para escribir mi propio guion en un estilo similar para mi audiencia de [AUDIENCIA DE about-me.md].

## Transcripción completa
- Transcribe CADA palabra con marcas de tiempo

## Gancho
- Primeras palabras exactas dichas
- Recuento de palabras del gancho
- ¿Qué hace que detenga el desplazamiento?

## Patrones de lenguaje
- Longitud media de la frase
- Proporción tú/tu vs yo/me
- Transiciones entre puntos
- ¿Dónde están los minimizadores 'solo'?

## Estructura
- Duración total
- Desglose de secciones con tiempos
- ¿Cuál es el momento antes/después?
- ¿Cuál es el CTA?

## Una idea clave
- La técnica más importante que aprender de este Reel

Guarda el análisis en outputs/reels/<slug>/analysis_reference_{shortCode}.md.

Paso 5. Escribe el nuevo guion del Reel

Usando el análisis del Paso 4, el tema del boletín del Paso 2 y los archivos de voz del usuario, escribe un nuevo guion de Reel en outputs/reels/<slug>/reel-[slug].md.

Aplica estas reglas (no negociables):

Gancho

• Nunca abras con "Yo". Usa "esto", "tú", un hecho o una mención de nombre.
• Formatos probados: "Esto cambió... para siempre" / giro negativo ("X es inútil a menos que...") / declaración de capacidad.
• El gancho crea curiosidad o interrumpe el patrón en 3 segundos.
• Refleja el recuento de palabras y la estructura del gancho del análisis de referencia.

Cuerpo

• Inglés británico. Frases cortas. Sin guiones largos, sin punto y coma.
• Usa "tú" y "solo" de forma conversacional ("tú solo metes...").
• Nunca combines tres o más fragmentos entrecortados. Combínalos en una sola frase fluida.
• Nunca expreses la conclusión. Deja que los hechos hablen por sí solos.
• Usa un CTA de comentario solo si el usuario tiene un entregable real y una automatización en funcionamiento confirmada. De lo contrario, usa una siguiente acción relevante que no prometa entrega.

Disparador de comentario (solo cuando sea compatible)

• Solo una palabra en mayúsculas (GUION, WIKI, PROMPTS, VIDEO).
• Debe relacionarse directamente con lo que se promete.
• Sin comillas, sin "abajo", sin puntuación final.

CTA

• "Comenta [PALABRA] y te envío [cosa específica]"
• Corto. Sin el relleno "el enlace a mi completo".

Duración y estructura

• Apunta a 30 a 45 segundos en total.
• Máximo 2 puntos clave, no 3.
• El pie de foto refleja el guion. Actualiza ambos juntos.

Estructura del archivo de guion

# Reel: [título]

## Análisis de referencia
- URL: [url del reel]
- Vistas: [número]
- Técnica clave: [del análisis de Gemini]

## Duración objetivo
30-45 segundos

## Gancho (0-3s)
[Palabras exactas]

## Punto 1 ([inicio]-[fin]s)
[Palabras exactas]

## Punto 2 ([inicio]-[fin]s)
[Palabras exactas]

## CTA ([inicio]-[fin]s)
[Próxima acción, con una promesa de comentario solo cuando la entrega esté confirmada]

---

## Pie de foto
[Refleja el guion, formateado para Instagram]

## Disparador de comentario (solo si está configurado)
[PALABRA o no aplica]

## Entregable (solo si se prometió)
[El recurso real disponible o no aplica]

---

## Notas visuales
[Cortes, ideas de B-roll, superposiciones de texto]

Paso 6. Bucle de control de calidad

Revisa en el asistente en ejecución: precisión de la fuente (30), voz del usuario (25), gancho y estructura (20), duración y claridad al hablar (15), consistencia del pie de foto/CTA (10). Cita evidencia para cada puntuación. Corrige las infracciones reales y vuelve a puntuar, hasta tres pasadas. El umbral es 95/100; si no se resuelve, informa de un borrador con los bloqueadores específicos en lugar de inflar la puntuación o afirmar que está listo. Mide el tiempo de una lectura en voz alta cuando esté disponible; de lo contrario, etiqueta la duración como estimada. Claude no es necesario para esta revisión en Codex.

Infracciones comunes a verificar:

• Abre con "Yo"
• Fragmentos entrecortados de tres o más
• Expresa la conclusión
• Disparador de comentario de varias palabras o estilizado
• Duración superior a 45 segundos al leer en voz alta
• 3 puntos en lugar de 2
• El pie de foto no refleja el guion

Paso 7. Entrega el guion

Entrega el guion revisado y el pie de foto correspondiente en el proyecto, con la fuente de referencia, el método de análisis y cualquier verificación no resuelta. El usuario puede grabarlo o solicitar explícitamente su propio flujo de producción disponible. Esta habilidad pública no incluye un avatar, edición o pipeline de publicación.

Reglas

• Nunca te saltes el umbral de control de calidad de 95/100.
• Lee siempre voice.md y about-me.md antes de escribir. La coincidencia de voz no es negociable.
• Nunca inventes métricas del Reel de referencia. Usa solo metadatos verificados proporcionados u obtenidos, y marca las métricas ausentes como no disponibles.
• Inglés británico. Sin guiones largos. Sin punto y coma.
• Cada guion incluye el pie de foto correspondiente; incluye un disparador de comentario solo cuando la entrega prometida funcione.
• Si falla el acceso a la referencia, informa de la etapa fallida y ofrece la entrada de video/transcripción proporcionada. No fabriques análisis de video.
• Gemini 2.5 Flash es el modelo. No lo sustituyas sin la aprobación del usuario.