Communitygithub.com

vaprigliano1/ai-reels-creator

Produce o retoma vídeos narrados para un canal configurado por el propietario, con investigación, guion, audio ElevenLabs, lip-sync HeyGen, material de apoyo, subtítulos, aprobación y MP4 final. Úsalo para producción completa o onboarding, no para publicar posts.

¿Qué es ai-reels-creator?

Esta habilidad (skill) automatiza la producción completa de videos narrados para un canal de YouTube o similar, integrando investigación, guion, síntesis de voz ElevenLabs, lip-sync con HeyGen, búsqueda de material audiovisual, subtítulos y renderizado final en MP4. Está diseñada para Claude Code (y agentes compatibles) y requiere que el propietario tenga sus propias cuentas de API con créditos. El flujo es altamente controlado: primero se realiza un onboarding obligatorio para definir el contexto del canal, luego se investiga, redacta y aprueba paso a paso el guion, la locución, el lip-sync, las fuentes visuales y el render. Cada etapa exige autorización explícita del usuario antes de incurrir en costos de API, y se verifica la integridad de los archivos mediante hashes SHA-256. La habilidad también soporta retomar procesos interrumpidos sin regenerar artefactos aprobados, protege las credenciales en el archivo .env local y prohíbe compartir avatares, voces o secretos entre canales. No publica en redes sociales ni programa publicaciones; se enfoca exclusivamente en la producción del video final.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/vaprigliano1/ai-reels-creator/tree/HEAD/skills/channel-video

Preguntar en tu IA favorita

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

Documentación

Video del Canal

Este método no trae identidad de canal, credenciales, modelos ni personas predefinidas. Lee el AGENTS.md del proyecto. En el proyecto instalado, los helpers están en .agent/skills/channel-video/scripts/.

Onboarding obligatorio

Si el contexto/perfil aún no están aprobados, lee references/onboarding.md y guía la conversación antes de generar contenido pago. Crea el contexto del canal a partir de las respuestas, propón preferencias configurables y solicita aprobación. No inferir aprobación a partir de campos rellenados. El propietario necesita sus propias cuentas de HeyGen y ElevenLabs, su voz ElevenLabs y su avatar HeyGen, con acceso de API y créditos.

Ningún ID o secreto debe copiarse de otro canal, entorno global o conversación. El .env debe ser el del workspace actual; no hay búsqueda automática de credenciales fuera de él.

Flujo

  1. Lee channel_context.md y channel_profile.json. Identifica pedido suelto, dossier, texto publicado o guion listo. Reutiliza tema existente o crea videos/<tema>/.
  2. Para guion nuevo, lee references/editorial.md. Investigación profunda para pedido superficial; investigación de brechas para dossier denso. El tema no tiene por qué ser viaje, hotel, founder o negocio. Ajusta la narrativa y la duración al material, sin repetir datos para alcanzar un tiempo fijo.
  3. Guarda guion, fuentes, leyenda del post y diálogos. Si ya hay guion aprobado, consérvalo. Inicializa job.json con scripts/init_job.py; revisa dependencias/configuración con doctor.py.
  4. Verifica el model_id real, idioma, límites y soporte de etiquetas en la documentación/cuenta del propietario. Mantén etiquetas compatibles si él las quiere; no pronunciar etiquetas en un modelo incompatible. La API no debe recibir un nombre de modelo comercial inventado como ID. Haz dry-run y explica caracteres/configuración/costo estimado sin imprimir credenciales.
  5. Solicita autorización para la prueba corta paga y genera con elevenlabs_audio.py --smoke-test --allow-paid. Muestra el audio real, sin alegar haber escuchado lo que no escuchaste. La aprobación de la prueba no aprueba automáticamente la locución completa.
  6. Tras la autorización, genera la locución completa y solicita aprobación explícita del archivo. Registra SHA-256 con approve_audio.py. No usar grabación de celular como audio de producción sin solicitud del propietario.
  7. Tras la autorización del lip-sync, ejecuta heygen_video.py --allow-paid con el mismo MP3 aprobado. HeyGen recibe audio_asset_id; no sintetiza el guion nuevamente. Valida transparencia, identidad, gestos y recorte del busto.
  8. Transcribe la locución aprobada con transcribe.py --allow-paid. Los timestamps reales determinan B-roll, overlays y subtítulos. Verifica nombres, números e idioma; audio nuevo exige nuevo lip-sync.
  9. Lee references/media.md. Busca material coherente por fragmento, registra procedencia e intervalo exacto en asset_manifest.json, y genera página de revisión con contact_sheet.py. No descargar archivos finales antes de las decisiones. Importa el JSON exportado con import_approvals.py, verificando el hash del manifiesto; decisión ausente continúa pendiente.
  10. Descarga fuentes directas aprobadas con download_media.py o herramientas autorizadas del entorno. Las URLs de página no son URLs de vídeo. No eludir DRM, acceso privado o términos de uso. Registra créditos, cambios y permisos por separado.
  11. Lee references/render-plan.md y operations.md. Arma un plan con material aprobado, intervalos medidos, avatar y subtítulos. render.py usa FFmpeg y tipografía rasterizada, sin requerir otro editor. Overlays oficiales o retratos recortados son opcionales y dependen del estilo del canal. No rediseñar logotipos ni fabricar fotos documentales.
  12. Lee references/qa.md, ejecuta qa.py y realiza inspección visual real. La comprobación técnica no certifica estética, pronunciación, estabilidad ni derechos. Entrega preview para aprobación. Consolida el MP4 vigente en video final/ con save_final.py, sin re-codificar y preservando el historial.

Reanudación y seguridad

  • Lee estados/artefactos antes de ejecutar. No generar de nuevo lo que existe y tiene hash válido.
  • Secretos solo del .env explícitamente indicado. Nunca en payloads persistidos, logs, HTML, manifiestos o paquete compartible.
  • Sin reintento pago automático. Resultado incierto exige inspección y nueva autorización; IDs externos registrados deben usarse para reanudar polling.
  • No transferir un avatar/voz a otro canal por conveniencia. Creación/clonación requiere alcance y derechos propios, no forma parte del onboarding automático.
  • No alterar el contexto aprobado, cambiar el modelo o recortar el guion silenciosamente. Pedir decisión cuando esto cambie materialmente la producción.
  • La portada y la leyenda pueden producirse como artefactos separados cuando se soliciten; conectar redes sociales, publicar o programar requiere integración/autorización propia.

Los scripts no sustituyen la investigación, dirección y validación humana. Los valores por defecto del diseño son ajustables; las invariantes de audio aprobado, costeo, procedencia y protección de secretos no son preferencias estéticas.

Skills relacionados