Communitygithub.com

PetarKukric/CLAUDE_SKILLS

Convierte un Reel de Instagram de referencia en un guion para tu propio Reel, ajustado a tu voz y reutilizando contenido de tu boletín informativo. Toma una URL de Reel o enlace de Notion, usa Apify para extraer el video, lo envía a Gemini 2.5 Flash para obtener transcripción completa + gancho + análisis de estructura, y luego escribe un nuevo guion aplicando los mismos patrones a tu tema del boletín.

¿Qué es CLAUDE_SKILLS?

Esta habilidad para agentes de IA (como Claude Code, Cursor o Codex) automatiza el proceso de crear guiones para Reels de Instagram basados en referencias de alto rendimiento. El usuario proporciona la URL de un Reel (o un enlace de Notion que la contenga) y un tema de su boletín informativo. La habilidad utiliza Apify para descargar el video y Gemini 2.5 Flash para analizar su estructura, gancho, patrones de lenguaje y transcripción. Luego, genera un guion nuevo adaptado al estilo de comunicación del usuario (basado en archivos `about-me.md` y `voice.md`), incluyendo un gancho efectivo, un cuerpo conversacional en inglés británico y una llamada a la acción. El proceso incluye un bucle de control de calidad con una puntuación mínima de 95/100. Las credenciales necesarias son `APIFY_API_TOKEN` y `GOOGLE_AI_API_KEY`; las etapas se pueden omitir si se proporciona video o transcripción ya disponibles.

Compatible con✓Claude Code✓Codex CLI~Cursor✓Gemini CLI
npx skills add https://github.com/PetarKukric/CLAUDE_SKILLS/tree/HEAD/cache/social-media-skills/social-media-skills/1.1.0/skills/reels-scripting

Preguntar en tu IA favorita

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

Documentación

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 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.md y 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 ejecuta voice-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ónicos about-me.md, voice.md o newsletter-voice.md en 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_TOKEN variable de entorno (extracción de Instagram)
  • GOOGLE_AI_API_KEY variable de entorno (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 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:

  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/videos 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 a outputs/reels/<slug>/downloads/{username}_{shortCode}.mp4.
  4. 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:

  1. Lea el .mp4 descargado como base64.
  2. Llame a genAI.getGenerativeModel({ model: 'gemini-2.5-flash' }).
  3. 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.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 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.

Individual skills in this repo

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

Skills relacionados