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
AskUserQuestiondescriben las preguntas, no una API requerida: usa una herramienta de preguntas disponible dentro de sus límites, o pregunta en el chat. Reutiliza las respuestas y el material fuente ya proporcionado. - Trabaja en el proyecto seleccionado por el usuario. Lee sus archivos
about-me.md,voice.mdy otros archivos de marca relevantes antes de realizar un trabajo personalizado. Confirma el autor previsto si los archivos entran en conflicto o contienen valores predeterminados iniciales. Pregunta por información faltante o ejecutavoice-builder; nunca heredes la identidad del mantenedor, sus cuentas o archivos privados. - Resuelve las
references/empaquetadas en relación con esta carpeta de habilidad. Para una actualización explícitamente solicitada del perfil, lee y actualiza los archivos canónicosabout-me.md,voice.mdonewsletter-voice.mden su lugar, preservando hechos y reglas del usuario no relacionados. Los consumidores deben volver a leer esos archivos canónicos. Usa un nuevo nombre de archivo solo para nuevos entregables que colisionen 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/fuentes disponibles cuando sea necesario. Si una fuente o integración no está disponible, nombra la capacidad faltante y ofrece 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. La redacción, el guardado y la revisión no autorizan la publicación, el envío de mensajes o el cambio de 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 con Apify + Gemini necesita:
APIFY_API_TOKENvariable de entorno (extracción de Instagram)GOOGLE_AI_API_KEYvariable de entorno (análisis de video con Gemini 2.5 Flash)- Node.js 18+ y los paquetes
apify-clienty@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 dejan esa etapa pendiente. Explica qué falta; no modifiques la configuración de la cuenta ni sustituyas un proveedor en silencio.
Un video proporcionado puede omitir Apify. Una transcripción/análisis proporcionado puede omitir 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 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 destacado 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 oración.
Espera el tema. Lee los archivos 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 script auxiliar existente adecuado si está presente; de lo contrario, escribe allí un pequeño script Node.js específico para la tarea que:
- Use
apify-clienty la ruta existenteapify/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 dedeepScrapeonumComments. Verifica que el proveedor admita la recopilación solo de publicaciones/videos antes de llamarlo; de lo contrario, solicita una carga de video. No adivines entradas alternativas del actor. - Extraiga
videoUrldel elemento devuelto. - Descargue el video a
outputs/reels/<slug>/downloads/{username}_{shortCode}.mp4. - Guarde los datos de extracción sin procesar en
outputs/reels/<slug>/reel_data_{shortCode}.json.
Ejecuta el script. Confirma el tamaño del archivo y los metadatos (vistas, me gusta, recuento agregado de comentarios si está disponible, primeros 200 caracteres del pie de foto) antes de continuar.
Un solo Reel es una referencia, no un Reel destacado verificado. Llámalo destacado 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 Node (o ejecuta una segunda pasada) que:
- Lea el
.mp4descargado como base64. - Llame a
genAI.getGenerativeModel({ model: 'gemini-2.5-flash' }). - Envíe el video con este indicación exacta:
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 habladas
- Recuento de palabras del gancho
- ¿Qué hace que detenga el desplazamiento?
## Patrones de lenguaje
- Longitud promedio de oración
- Relación tú/tu vs yo/me
- Transiciones entre puntos
- ¿Dónde están los minimizadores como '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 para 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 interrupción del 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. Oraciones cortas. Sin guiones largos (
em dashes), sin punto y coma. - Usa "tú" y "solo" de forma conversacional ("simplemente agregas...").
- Nunca fusiones tres o más fragmentos entrecortados. Combínalos en una oración fluida.
- Nunca establezcas la conclusión. Deja que los hechos hablen por sí mismos.
- Usa un CTA de comentario solo si el usuario tiene un entregable real y una automatización de trabajo confirmada. De lo contrario, usa una acción relevante a continuación que no haga una promesa de entrega.
Disparador de comentarios (solo cuando sea compatible)
- Solo una palabra en mayúsculas (SCRIPT, WIKI, PROMPTS, VIDEO).
- Debe relacionarse directamente con lo que se promete.
- Sin comillas, sin "abajo", sin puntuación final.
CTA
- "Comenta [PALABRA] y te enviaré [cosa específica]"
- Corto. Sin relleno de "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]
## Objetivo de duración
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)
[Acción siguiente exacta, con promesa de comentario solo cuando la entrega esté confirmada]
---
## Pie de foto
[Refleja el guion, formateado para Instagram]
## Disparador de comentarios (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 del discurso (15), consistencia del pie de foto/CTA (10). Cita evidencia para cada puntuación. Corrige violaciones reales y vuelve a puntuar, hasta tres pasadas. El umbral es 95/100; si no se resuelve, informa un borrador con los bloqueadores específicos en lugar de inflar la puntuación o afirmar que está listo. Mide una lectura en voz alta cuando esté disponible; de lo contrario, etiqueta la duración como estimada. En Codex, no se requiere Claude para esta revisión.
Violaciones comunes a verificar:
- Abre con "Yo"
- Fragmentos entrecortados de tres o más
- Establece la conclusión
- Disparador de comentarios 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 trabajo de producción disponible. Esta habilidad pública no incluye un avatar, edición ni canal de publicación.
Reglas
- Nunca te saltes el umbral de control de calidad de 95/100.
- Siempre lee
voice.mdyabout-me.mdantes de escribir. La coincidencia de voz no es negociable. - Nunca inventes métricas del Reel de referencia. Usa solo metadatos verificados proporcionados o obtenidos, y marca las métricas ausentes como no disponibles.
- Inglés británico. Sin guiones largos (
em dashes). Sin punto y coma. - Cada guion incluye el pie de foto correspondiente; incluye un disparador de comentarios solo cuando la entrega prometida funcione.
- Si falla el acceso a la referencia, informa la etapa fallida y ofrece 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.