kingsizestrj/SKILLS

Vídeos realistas con IA de Voltec con el personaje de la marca (ElevenLabs + HyperFrames)

Producción y edición de cualquier vídeo realista con IA de Voltec protagonizado por el personaje de la marca (Reels, Stories o anuncio 9:16, en cualquier campaña, temporada, tema o escenario): persona de IA en lugar real → snapshot aprobado → Veo 3.1 image-to-video → narración con voz clonada → edición HyperFrames con subtítulos, CTA y QR. Aquí están el flujo, las reglas, los fijos de Voltec y los slots que cambian en cada vídeo. Los cuerpos JSON, prompts completos y comandos largos están en references/.

Caso de referencia probado: el Reels "Verão Conectado" (15/10/2026; 20,5 s, 1080x1920, 24 fps; entregado en la v5). Sus valores aparecen como "ej.: Verão Conectado" y nunca son estándar: lo que es de la campaña es slot (§1b), y el ejemplo rellenado está en el §7.2.

• [Voltec] marca lo que es fijo de Voltec con el personaje o del área atendida (Grussaí y región). "Ej.: Verão Conectado" marca valor solo de la campaña de referencia. El resto vale para cualquier anuncio con IA.
• Nivel de evidencia, igual que en las references: [vivido] ocurrió en la sesión y fue comprobado; [aplicado] provino de la investigación o de las críticas y entró en las tomas aprobadas; [investigación] solo de la investigación; [no probado] derivado de las reglas, sin ninguna generación (§8).
• $SKILL = carpeta de este SKILL.md; $PROJ = carpeta del proyecto del vídeo. Las variables de shell no pasan de una llamada de Bash a otra: repite el preámbulo de la sección 5 en cada llamada.
• Prompts de generación en inglés. Textos al cliente, narración y subtítulos en portugués.
• La clave de la API está en ~/.config/elevenlabs/env (chmod 600) y scripts/el.py la lee sin imprimir. Nunca uses echo, cat, env, curl -v o set -x con ella, ni la escribas en archivo, prompt o mensaje.
• No oyes audio: compruébalo con STT (texto y audio_event), espectrograma del fragmento y ebur128, y lista en la página de la puerta los instantes para que el cliente escuche.

1. Cuándo usar

• [Voltec] Cualquier vídeo realista con IA de Voltec protagonizado por el personaje de la marca, que necesita parecer filmado de verdad por alguien: Reels, Stories o anuncio; cualquier campaña, temporada o tema (promoción estacional, institucional, consejo de Wi-Fi, soporte, inauguración, Black Friday); escenario real del área atendida (Grussaí, Atafona, Chapéu do Sol, São João da Barra; lo que sirve de escenario: §7.1) o interno (casa, tienda, coche). Escenario, ropa o formato que nunca fue generado: §8.
• Generación por la API de ElevenLabs: imagen (snapshot), vídeo (Veo 3.1; Seedance por la API solo con liberación, o manual en la app), narración con voz clonada, SFX y STT.
• Edición en HyperFrames: cortes por cuadro, mezcla, tarjetas, subtítulos sincronizados, CTA y QR.
• Ajuste en un vídeo de IA ya entregado: recortar toma, cambiar variación, cambiar una frase o el CTA, versión con subtítulos, refinar la identidad.
• Con ella hablando a cámara ("con ella hablando", "ella habla", "ella explicando"): modo hablando, en references/modo-falando.md. Veo 3.1 genera la toma con el habla y sts.py cambia la voz a la Radassa. [vivido: prueba de 13 s aprobada el 15/10/2026]
• [GENERAL] Otra marca o persona: lo que no es [Voltec] sirve, con adaptación (cambia el §7.1 y rellena los slots del §1b). Proyecto de referencia: /home/syllas/hyperframes/voltec-reels-ia/ (Verão Conectado; solo lectura).
• No sirve para motion graphics sin persona ni escena generada (ahí basta HyperFrames) ni para temas de Voltec sin vídeo (red, GenieACS, TR-069).

Estándar de calidad (exigencia de Voltec; úsalo como estándar en todo proyecto): realismo máximo; cámara creíble, como alguien filmando de verdad; ambiente real, sin cambio brusco; ninguna anomalía en el objeto de la mano; lugares reales con fotos licenciadas (o del propio cliente) mostradas al cliente; snapshot aprobado antes de cualquier vídeo; prompts detallados (movimiento, piel, captación de audio con ruidos reales); investigación de buenas prácticas antes de generar.

1b. Inicio rápido: cualquier vídeo nuevo de Voltec con el personaje

1. Lee en este orden: este SKILL.md (con el §7) → persona-e-marca-voltec.md §1–4 y §6–7 → el escenario: en Grussaí, locais-grussai.md §1, §3 (con la tabla "Outras estações") y §4; en otro lugar o escena interior, el §8 de este archivo, persona-e-marca-voltec.md §10 y locais-grussai.md §7–§10 → prompts-principios.md §1 (con el "Checklist do prompt") → solo el molde de prompts-moldes.md §2 más cercano a la escena (2.1 amiga filmando, 2.2 pose en el mismo lugar, 2.3 selfie, 2.5–2.6 vídeo; escena nueva: 2.9–2.10). El resto, solo en la fase en que se necesite. prompts-moldes.md y persona-e-marca-voltec.md superan el límite de una lectura del Read: encuentra la sección con Grep (ej.: ^### 2\.9, ^## 10) y léela con offset/limit.
2. Ya decidido (fijos de Voltec; no preguntes de nuevo): persona de la cuenta, con los assets na7keiYvPpGArmyghOpk, pUgU1HXgmdqXfP02iR8T y ZY1iDcJLhPFklahPnvkM ya en la cuenta (no subas de nuevo; persona §4) y los anclajes de rostro, piel y manos (persona §3.1–3.3); voz "Radassa 100%" 4yvYc2GSakxLWMhlsd6b, eleven_v4, 0.45/0.85, "pt", y el A/B ahora es entre 2 seeds de esta voz; pronunciación vol-TÉC ("Voltéc" en el TTS, "Voltec" en pantalla); sin joyas ni tatuajes; sin música; logo, colores, fuentes y ciudades (§7.1); las reglas de realismo, prompt y QA (§3, qa-checklist.md) y las puertas (§2). Modelo: Veo 3.1 por la API, elegido el 15/10/2026; solo vuelve a preguntar si la prueba de acceso sin costo (modelos-e-custos.md §2.2) o la revisión de catálogo de la Fase 1 cambian el panorama.
3. Slots del vídeo: pregunta siempre, antes de escribir la narración (en el chat basta). Ejemplo rellenado en el §7.2.
   • Vienen del cliente (nunca inventes): tema y formato (Reels, Stories, anuncio); narración en off (estándar) o ella hablando a cámara (references/modo-falando.md), y en ese caso el habla de cada toma; oferta, precio, condiciones y período; anuncio pago (botón "Saiba mais" + QR) o post orgánico ("link na bio"); destino del QR (el page_id=674 es la página "Verão Conectado 2026": no lo reutilices sin confirmación del cliente); si los créditos de las fotos CC BY van en el pie del post.
   • Pregunta y propón (el cliente aprueba en la puerta 1 o 2): escenario, horario y luz; duración; guion de tomas (por toma: lugar, objeto en la mano y sonido ambiente); ropa; gancho; tarjeta de la campaña; texto de la cama de SFX.
4. Rehaz por escena, temporada o escenario (nada de esto se copia del ejemplo): anclaje de ropa en el estilo de la persona §3.4 (opaca, sin estampa ni logo; tejido liso o de trama grande, porque el patrón fino tiembla); luz por el sol calculado para lugar, fecha y hora (locais-grussai.md §8; en Grussaí, la tabla "Outras estações" del §3: en invierno, sol a ~19,5° alrededor de las 15:40 y sol de tarde a ~293–304°; en la selfie a contraluz ella camina hacia el sur y el mar queda a la derecha); viento (solo el del verano fue investigado: investiga antes); sonido ambiente del lugar (en el prompt de vídeo y en la cama de SFX); fragmentos de lugar del negative_prompt (prompts-moldes.md §2.6); espacio libre en el snapshot para el gancho, en un área lisa del cuadro (el #q1 del template queda en la parte superior derecha; ej.: Verão Conectado: cielo abierto en T1); textos de la campaña en los tokens __…__ del template: gancho, título de la tarjeta en 1 o 2 partes con icono opcional (ej.: "VERÃO ☀ CONECTADO", con el sol) y oferta; texto de la cama de SFX.
5. Proyecto y página nuevos: $HOME/hyperframes/<campanha> y un Artifact nuevo. No vuelvas a publicar en la URL del Verão Conectado (§7.2).

2. Flujo en fases y puertas

Cada puerta es una página (Artifact) con A/B lado a lado y preguntas numeradas. Pide respuesta corta en el formato "T1-A, T2-A, T3-A, voz A, modelo 1"; fue lo que aceleró las decisiones.

• Página: una por proyecto, republicada en cada puerta (mismo archivo, misma URL), con la puerta actual en la parte superior y las decisiones ya tomadas abajo; campaña nueva = página nueva. Los medios van como archivos de soporte en media/: snapshots en JPG (~200 KB cada uno en la sesión), narración en MP3 y previsualización del vídeo en MP4 con poster JPG (~11 MB en la sesión; límite de 15 MB por archivo). Estructura modelo (ej.: la página del Verão Conectado): lee https://claude.ai/artifact/MivTjGgrZ9ZyhZTftP66kh (Artifact, action: "read"). Por toma: A/B, cámara, acción, sonido captado, narración, texto en pantalla y tiempo. Después: narración A/B con tabla de tiempos, caminos de modelo, lugares con crédito y una caja con el formato de respuesta.
• Registro: anota las respuestas de cada puerta en $PROJ/DECISOES.md y en la sección "Decisões" de la página.
• Unir puertas: une 1, 2 y 3 en una sola página cuando la oferta, CTA (pago × orgánico) y destino del QR ya estén respondidos. Sin esto, haz primero la puerta 1 (en el chat basta) y no generes snapshot ni narración. La narración mostrada en un storyboard antes de las respuestas es provisional: después de ellas (pronunciación, CTA, oferta), genera la narración final con la voz elegida (2 seeds, ~300 créditos cada una), antes de los vídeos. Ej.: Verão Conectado: narracao_radassa100 en el storyboard y narracao_v2_A_s1 después de las respuestas.
• Nunca se une: vídeo antes del OK de la puerta 3.

Fase 1. Investigación y plan (0 crédito)

• Investiga en paralelo (4 frentes: modelos, realismo/anti-alucinación, lugares y API; con subagentes en paralelo, si los hay). Luego escribe el guion y el plan de tomas en el formato del storyboard: por toma, lugar y hora, quién filma y cámara, acción en 2–3 tiempos, objeto, sonido captado, frase de la narración, texto en pantalla y tiempo.
• Ejecuta 2 críticas independientes antes de gastar: un subagente por enfoque; sin subagentes, una pasada separada por enfoque. Técnica = campos y límites de la API (api-elevenlabs.md §3.3), duración/1080p, costes y moderación (prompts-principios.md §4). Realismo = "Checklist do prompt" de prompts-principios.md §1 + luz y geometría (sol calculado en locais-grussai.md §8; escena interior o nocturna: §8 de este archivo). Cada una devuelve problema, toma, severidad y corrección.
• Los rankings cambian rápido: si modelos-e-custos.md tiene más de ~2 meses, consulta de nuevo. A partir del 17/11/2026, comprueba si veo-3.1-generate-001 todavía existe. Prueba el acceso a cada modelo sin gastar (§2.2 del mismo archivo).
• Cliente ya atendido: las references son la investigación. Rehaz solo el ítem anterior y lo que es nuevo en la campaña: temporada (el viento fuera del verano no fue investigado), escenario fuera del ejemplo o sin foto abierta (pide fotos al cliente, locais-grussai.md §7; lo que no fue investigado está en el §8 y en locais-grussai.md §10), ropa y objeto en la mano (persona §3.4). Mantén las 2 críticas antes de gastar.
• Puerta 1, el cliente recibe: modelo recomendado con puntuación fechada y coste previsto; guion con la narración escrita; preguntas numeradas: CTA de anuncio pago o de post orgánico, destino del QR, pronunciación de la marca, oferta y precio (vienen del cliente; nunca inventes), persona y refs (avisa si alguna ref tiene otro rostro), voz y consentimiento, música (estándar: sin), duración, tatuajes y joyas, etiqueta "Informações de IA", crédito de las fotos. [Voltec] Pregunta solo lo que la sección 1b ordena.

Fase 2. Lugares reales (0 crédito)

• Fotos con la licencia leída en la página de la foto y el lugar probado (geotag, OpenStreetMap): método en locais-grussai.md §7. Calcula el sol para la hora de la escena (locais-grussai.md §8) y comprueba el viento del lugar. Solo CC0 y CC BY van a la API; la foto NC sirve solo de referencia para escribir el prompt. Escena interior (casa, tienda, coche): fotos del propio cliente, sin placa ni letrero legible (§8).
• Puerta 2, el cliente recibe: hoja de contactos (verde = puede ir a la API; rojo = NC), créditos, el escenario único propuesto (un lugar y un horario; ej.: Verão Conectado: la terraza y la arena enfrente, en una tarde de verano) y el horario de la luz.

Fase 3. Snapshots y narración (puerta obligatoria)

• Snapshot = 1er cuadro de cada toma, en gpt-image-2.5-sunburst (9:16, 2K, high), con 2 variaciones por toma. Revisa todos con qa-checklist.md §A.
• Genera T1 A/B primero. Elige tú la mejor según qa-checklist.md §A y úsala como base: la toma siguiente en el mismo lugar es edición de ella, con la cámara en el mismo punto; lugar nuevo es imagen nueva con ella como Image 1 (ej.: Verão Conectado: T2 y T3 salieron del T1-A 5vBTv3B9FOt44Vu8jMY4 antes del storyboard). En la puerta 3, di qué tomas derivan del T1-X. Si el cliente elige el otro T1, rehaz las derivadas a partir de él (2 imágenes por toma; ej.: Verão Conectado: T2 y T3, 4 imágenes, ≈2,2 mil créditos) antes de cualquier vídeo.
• Narración completa en una request, con 2 voces o 2 seeds. La duración medida por el alignment define los cortes. Comprueba la tónica de la marca y el texto hablado (stress.py + STT).
• Puerta 3, el cliente recibe: A/B de cada toma lado a lado con la ref del rostro, reproductores de la narración A/B, las fotos de los lugares y la pregunta del modelo. Para hasta la respuesta y guarda los generation_id aprobados.

Fase 4. Vídeos, 2 variaciones por toma

• Veo 3.1, start_frame = generation_id del snapshot aprobado, 9:16, 1080p, 8 s, con audio, seeds 20260115 y 20260116. El prompt describe solo movimiento, cámara y sonido (prompts-moldes.md §2.5–2.6). El personaje no habla, excepto en el modo hablando (references/modo-falando.md §4).
• 19.391 créditos por generación, 2 por toma (ej.: Verão Conectado, 3 tomas × 2 variaciones = 116.346). En la sesión, 6 generaciones en paralelo se completaron en ~3 min (varía). El cliente no recibe nada en esta fase.

Fase 5. Selección y QA de cada variación (puerta interna)

• Hoja de contactos a 2 fps, tiras numeradas a 24 fps (boca) y a 8 fps (manos y objeto), y STT del audio nativo (qa-checklist.md §B). Anota el cuadro de cada defecto (toma Veo = 192 cuadros; cuadro = segundos × 24) y elige in/out que lo evite. Si la variación A no tiene ventana limpia, usa la B. Si ambas fallan, regenera cambiando UNA variable.
• Regenerar más allá de las 2 variaciones: dentro de la reserva de 1 ronda aprobada en la puerta 1; por encima de eso, pide OK con el motivo y el coste (19.391 por toma).
• El cliente solo recibe algo aquí si hay duda real: las 2 variaciones en bucle en la página.

Fase 6. Edición (0 crédito, fuera de la cama de SFX)

• La cama de SFX tiene un coste: presupuestado en la puerta 1.
• Edición HyperFrames: cortes precisos, mezcla de audio, inserción de tarjetas con el texto de la campaña, subtítulos sincronizados, CTA y QR validado.
• Revisión final con el cliente antes de la entrega.

3. Reglas de realismo, prompt y QA

(Contenido detallado sobre realismo, estructura de prompts y checklist de calidad; consulta qa-checklist.md para la lista completa.)

• Máximo realismo: evita anomalías en manos, objetos y fondo; la cámara debe simular un movimiento natural de filmación manual.
• Prompts detallados: incluye descripción de movimiento, iluminación, textura de piel y sonido ambiente.
• QA en cada fase: verifica cada snapshot, narración y vídeo generado antes de pasarlo a la siguiente etapa.

4. Referencias y assets

• references/: contiene archivos con prompts molde, descripciones de persona y marca, lista de lugares, principios de prompt, API de ElevenLabs, costes de modelos, guion de modo hablando y checklist de QA.
• Assets de la persona: na7keiYvPpGArmyghOpk, pUgU1HXgmdqXfP02iR8T, ZY1iDcJLhPFklahPnvkM.
• Voz clonada: 4yvYc2GSakxLWMhlsd6b (Radassa 100%, eleven_v4).

5. Variables de entorno y scripts

• $SKILL: ruta de la carpeta del skill.
• $PROJ: ruta del proyecto del vídeo.
• Scripts en scripts/: el.py (acceso a API), stress.py (verificación de pronunciación), sts.py (cambio de voz).
• La clave de API se carga desde ~/.config/elevenlabs/env.

6. Ejemplo de flujo completo (Verão Conectado)

(Detalles del proyecto de referencia: duración 20,5 s, 1080x1920, 24 fps, 3 tomas, 2 variaciones por toma, coste total ~116.346 créditos, entregado en versión 5.)

7. Configuración de marca y plantillas

7.1. Identidad visual de Voltec

• Logo: [especificaciones]
• Colores: [hex]
• Fuentes: [nombres]
• Ciudades: Grussaí, Atafona, Chapéu do Sol, São João da Barra.

7.2. Ejemplo de slots rellenados (Verão Conectado)

• Tema: promoción de verano
• Formato: Reels
• Narración: en off
• Oferta: 50% de descuento en el primer mes
• CTA: "Saiba mais" con QR
• Destino del QR: página "Verão Conectado 2026"

8. Casos no probados y escenarios nuevos

(Reglas para escenarios, ropa o formatos que nunca han sido generados; procedimiento para investigar y adaptar.)

---

Nota: Este documento se actualiza conforme se aprueban nuevas generaciones y se incorporan lecciones aprendidas.