Communitygithub.com

calesthio/generative-media-skills

Producción de videos explicativos independiente del proveedor para agentes de IA, ideal para crear videos educativos, de productos, conceptos, sin fines de lucro/servicio público, onboarding, capacitación, animados, multimedia y cortos para redes sociales. Úsalo cuando un agente deba convertir un tema, resumen, corpus de investigación, producto, proceso, política, conjunto de datos o idea compleja en un video explicativo fáctico, accesible, narrado, subtitulado, guionizado y listo para generación de medios, con revisión de afirmaciones, localización, ritmo, variantes y control de calidad.

¿Qué es generative-media-skills?

Esta habilidad permite a un agente de IA producir videos explicativos completos de forma independiente al proveedor, centrándose en la precisión factual y la accesibilidad. Comienza definiendo un objetivo de aprendizaje o decisión medible para la audiencia, luego construye una matriz de afirmaciones para documentar y verificar cada declaración del video. Descompone conceptos complejos en átomos explicables, estructura el guion según el caso de uso (educación, producto, capacitación, etc.) y crea un storyboard detallado con información de tiempo, ritmo de aprendizaje, narración, elementos visuales y notas de accesibilidad. La habilidad maneja variantes para diferentes formatos (cortos para redes, capacitación, servicio público) e incluye reglas estrictas sobre el uso de analogías, la generación de gráficos y datos, y el movimiento visual para no engañar ni sobrecargar al espectador. Es compatible con cualquier entorno que ofrezca herramientas de generación, edición, composición, subtitulado y revisión, y es especialmente útil para desarrolladores que construyen agentes para automatizar la producción de contenido educativo, de marketing o de capacitación con altos estándares de calidad y cumplimiento normativo.

Compatible con~Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/calesthio/generative-media-skills/tree/HEAD/skills/production/content-formats/explainer-video-production

Preguntar en tu IA favorita

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

Documentación

Producción de videos explicativos

Produce un video explicativo solo después de definir qué debe entender, creer, decidir o hacer la audiencia de manera diferente después de verlo. Trata el video como un artefacto de aprendizaje y decisión, no como una secuencia de escenas bonitas.

Esta habilidad es independiente del proveedor. Utiliza las herramientas de generación, edición, composición, subtitulado y revisión disponibles en el entorno anfitrión, pero mantiene intactos la lógica explicativa, la disciplina factual, la accesibilidad y los estándares de control de calidad entre proveedores.

No negociables

  • Comienza desde la audiencia, sus conocimientos previos y un objetivo de aprendizaje o decisión medible.
  • Separa los hechos documentados, las inferencias respaldadas por fuentes, las heurísticas de producción y las invenciones creativas.
  • Mantén un registro de afirmaciones para afirmaciones factuales, comerciales, comparativas, de salud, seguridad, legales, financieras, científicas y de servicio público.
  • Escala las afirmaciones de alto riesgo al cliente, experto en la materia, revisor legal/de cumplimiento, revisor médico, revisor financiero o propietario de la política. No proporciones asesoramiento legal, médico o financiero.
  • Incorpora la accesibilidad desde el principio en el guion, storyboard, subtítulos, audio, visuales de datos y variantes de entrega. La adaptación posterior es más débil y costosa.
  • Vuelve a verificar los datos volátiles del proveedor/plataforma en el momento de la producción: relaciones de aspecto sociales, longitudes máximas, áreas seguras, comportamiento de subtítulos, entradas del modelo, límites del modelo, precios, disponibilidad regional, reglas de divulgación y términos de derechos/licencias.
  • Nunca le pidas a un modelo de generación de imágenes o video que invente evidencia, renderice gráficos precisos, preserve declaraciones legales/médicas/científicas exactas o cree texto fino legible. Utiliza diseño/composición determinista para hechos, citas, subtítulos, tablas, texto de interfaz de usuario, etiquetas y gráficos.

Recepción: definir el contrato de aprendizaje

Antes de escribir o generar, responde:

  • Audiencia: ¿Para quién es, qué saben ya, qué malinterpretan, qué lenguaje/registro usan y qué necesidades de accesibilidad/localización se conocen?
  • Objetivo: ¿Qué frase única debería poder decir, hacer o decidir el espectador después de verlo?
  • Caso de uso: educación, producto, onboarding, capacitación, servicio público, recaudación de fondos, política, habilitación de ventas, concienciación social, gestión de cambios internos o concepto técnico.
  • Evidencia de éxito: respuesta de prueba, finalización de demostración, reducción de preguntas de soporte, registro, comprensión de políticas, cambio de comportamiento, aprobación de las partes interesadas o compartir/guardar.
  • Restricciones: duración, plataforma, marca, fuentes requeridas, afirmaciones que deben incluirse/evitarse, imágenes restringidas, voz, subtítulos, idiomas, aprobadores de revisión, presupuesto y disponibilidad de herramientas.
  • Nivel de riesgo:
    • Bajo: concepto general, orientación interna, explicación creativa no sensible.
    • Medio: beneficios del producto, guía de comportamiento sin fines de lucro/servicio público, afirmaciones de datos, requisitos de empleo/capacitación.
    • Alto: salud, seguridad, asuntos legales, financieros, productos regulados, niños, persuasión política, guía de crisis, publicidad comparativa, estadísticas públicas con implicaciones políticas.

Escribe el objetivo como un resultado observable, no un tema vago:

  • Débil: "Explicar los créditos de carbono."
  • Fuerte: "Después de 90 segundos, un comprador primerizo puede diferenciar entre reducir emisiones y comprar créditos, y sabe que debe buscar la verificación del proyecto antes de confiar en una afirmación."

Investigación y disciplina de citas

Crea una matriz de afirmaciones antes de escribir el guion. La matriz evita que el pulido persuasivo supere la evidencia.

CampoUso
AfirmaciónLa declaración o implicación exacta que el video puede hacer.
Tipo de afirmaciónDefinición, estadística, causal, comparativa, rendimiento del producto, testimonial, seguridad, recomendación de comportamiento, pronóstico, opinión, metáfora o CTA.
FuenteSe prefiere la fuente primaria; incluye título, URL, fecha de publicación/actualización y fecha de acceso.
Solidez de la evidenciaOficial/primaria, revisada por pares, informe técnico, prueba reproducible, secundaria de buena reputación, proporcionada por el cliente, anecdótica o creativa.
Manejo en pantallaCita, línea de fuente, solo voz, copia legal/divulgación, excluida de la versión final o requiere revisión de un experto.
RiesgoBajo/medio/alto y por qué.
PropietarioAgente, cliente, SME, legal/cumplimiento, médico, financiero, accesibilidad, localización.

Utiliza fuentes primarias cuando sea posible: documentación oficial, estándares, guía regulatoria, estadísticas gubernamentales, investigación revisada por pares, documentos del producto, evidencia aprobada por el cliente o materiales de origen inspeccionados directamente. Utiliza fuentes secundarias solo cuando las fuentes primarias no estén disponibles o para antecedentes, y etiquétalas como tales.

Para videos explicativos comerciales o de productos, las afirmaciones de rendimiento objetivo necesitan fundamentación. La guía comercial de la FTC dice que las empresas deben respaldar las afirmaciones publicitarias con pruebas sólidas, especialmente las relacionadas con la salud; las Guías de Testimonios de la FTC también requieren que las conexiones materiales en los testimonios se divulguen de manera clara y conspicua. Trátalos como desencadenantes de cumplimiento, no como sugerencias de redacción. Vuelve a verificar la guía actual de la FTC y la jurisdicción aplicable en el momento de la producción.

Para medios generados por IA y activos de stock/medios, registra la procedencia: modelo/proveedor, prompt, semilla si está disponible, licencia del activo fuente, estado de autorización/consentimiento, historial de ediciones y si el material es generado por IA. La guía de la Oficina de Derechos de Autor de EE. UU. dice que el registro de derechos de autor de obras que contienen material generado por IA depende de la autoría humana y la divulgación de contenido generado por IA más que de minimis; las reglas de derechos son volátiles y dependen de la jurisdicción, así que escala las preguntas de registro, propiedad, imagen y datos de entrenamiento al asesor legal.

Descomponer el concepto antes de escribir

Divide la idea en átomos explicables:

  1. Términos: vocabulario que la audiencia necesita antes de que la explicación funcione.
  2. Partes: componentes, actores, entradas, salidas, restricciones.
  3. Mecanismo: qué cambia, en qué orden y por qué.
  4. Contraste: qué no es esto; concepto erróneo común o alternativa falsa.
  5. Ejemplo: caso concreto, escenario o minidemo.
  6. Consecuencia: por qué es importante; qué sucede si se ignora.
  7. Acción: qué debe hacer el espectador a continuación.

Elige el conjunto mínimo necesario para el objetivo. Si el concepto tiene demasiados átomos para la duración, reduce la promesa en lugar de comprimir todo.

Patrones de descomposición útiles:

  • Explicador de definición: término -> contraste -> ejemplo -> uso.
  • Explicador de mecanismo: entrada -> transformación -> salida -> bucle de retroalimentación.
  • Explicador de producto: problema -> solución actual -> mecanismo del producto -> prueba -> siguiente paso.
  • Explicador de servicio público: situación -> riesgo -> acción recomendada -> excepción -> dónde obtener ayuda.
  • Explicador de capacitación: objetivo de la tarea -> requisitos previos -> pasos -> verificación -> ruta de recuperación.
  • Explicador de datos: pregunta -> conjunto de datos/fuente -> patrón -> advertencia -> implicación.

Arquitectura del guion

Utiliza la estructura que se ajuste al objetivo; no fuerces cada video explicativo al mismo embudo.

Estructura central para la mayoría de los videos explicativos de 60-180 segundos:

  1. Gancho: nombra la tensión o pregunta práctica.
  2. Promesa: diles a los espectadores qué entenderán o podrán hacer.
  3. Mapa: previsualiza las dos a cuatro piezas de la explicación.
  4. Construcción: explica una idea por ritmo, cada ritmo resolviendo una pregunta.
  5. Ejemplo/demo: muestra el concepto funcionando en un caso concreto.
  6. Advertencia o límite: evita la exageración y aborda un concepto erróneo común.
  7. Acción: siguiente paso, resumen, tarea práctica o solicitud de decisión.

Variante corta para redes sociales, 15-45 segundos:

  • 0-3s: interrupción de patrón o problema específico.
  • 3-8s: promesa y consecuencias.
  • Medio: un mecanismo o un antes/después, no un plan de estudios completo.
  • Final: línea memorable, CTA o resumen de "guarda esto".

Variante de capacitación/onboarding:

  • Indica la tarea y la condición de éxito.
  • Demuestra los pasos en orden.
  • Agrega puntos de control y recuperación de errores.
  • Termina con dónde encontrar ayuda o cómo verificar la finalización.

Variante de servicio público/sin fines de lucro:

  • Usa lenguaje sencillo y evita la vergüenza.
  • Haz que la acción recomendada sea concreta.
  • Muestra a quién aplica la recomendación y quién necesita orientación diferente.
  • Cita fuentes oficiales y escala las afirmaciones de salud/seguridad/legales.

Escribir narración para la comprensión

La narración debe sonar como una guía capaz, no como un documento técnico leído en voz alta.

  • Usa palabras cotidianas a menos que sea necesario un término técnico; define los términos necesarios antes de usarlos.
  • Pon una idea en cada oración.
  • Mantén las cláusulas lo suficientemente cortas para la locución y los subtítulos.
  • Usa señalamientos: "Primero", "La diferencia clave", "Aquí está el truco", "Ahora observa qué cambia".
  • Repite los términos críticos de manera consistente; no cambies sinónimos para conceptos que el espectador aún está aprendiendo.
  • Pon los números en contexto: compara, convierte, muestra la escala o di por qué el número es importante.
  • Lee el guion en voz alta. Si la voz tropieza, el espectador también lo hará.

Para la locución guionada, planea aproximadamente 130-160 palabras en español habladas por minuto para videos explicativos tranquilos, más lento para técnicos, traducidos, dirigidos a niños o con sensibilidad de accesibilidad. Trátalo como una heurística; el ritmo real depende del idioma, el hablante, la audiencia, los elementos visuales y las necesidades de pausa.

Usar analogías sin mentir

Las analogías ayudan cuando mapean la estructura, no solo el estado de ánimo.

Antes de usar una analogía, escribe:

  • Qué mapea: "A es como B porque ambos..."
  • Qué no mapea: "A diferencia de B, A no..."
  • Dónde parar: el punto exacto después del cual la analogía se vuelve engañosa.

Ejemplo: "Una bomba de calor es como mover agua cuesta arriba con una bomba: gastas energía para mover el calor en lugar de crearlo. Pero a diferencia del agua, el calor fluye naturalmente de lugares más cálidos a más fríos, por lo que el dispositivo usa un ciclo de refrigerante para moverlo en la otra dirección."

Evita las analogías en dominios de alto riesgo si la simplificación pudiera cambiar el comportamiento, la dosis, la seguridad, la elegibilidad, la interpretación legal o la toma de decisiones financieras. Utiliza una explicación causal simple en su lugar.

Storyboard como diseño de información

Crea un storyboard para cada escena con estas columnas:

ColumnaContenido requerido
TiempoInicio/fin, duración e intención de ritmo.
Ritmo de aprendizajeLo que el espectador aprende o ahora puede hacer.
NarraciónLocución o diálogo exacto.
VisualDiagrama, acción del personaje, captura de pantalla, interfaz de usuario del producto, gráfico de datos, metraje en vivo, sistema de iconos o toma de medios generados.
MovimientoQué cambia en la pantalla y por qué ese movimiento ayuda a la comprensión.
Texto/subtítuloEtiquetas en pantalla, línea de fuente, divulgación, tercio inferior o sin texto.
EvidenciaID de afirmaciones de la matriz de afirmaciones.
AccesibilidadNota de subtítulo, necesidad de descripción de audio, riesgo de contraste, codificación solo con color, riesgo de parpadeo/movimiento, nota de transcripción.
Notas de activo/promptLo que debe ser determinista vs. lo que puede ser generado.

Si una escena no tiene ritmo de aprendizaje, elimínala o conviértela en una transición que dure solo el tiempo necesario.

Gramática visual para escenas explicativas

Empareja la forma visual con el trabajo cognitivo:

  • Definición: tarjeta de término, objeto etiquetado, lado a lado "es/no es".
  • Proceso: flujo, línea de tiempo, secuencia numerada, cinta transportadora, máquina de estados.
  • Causa/efecto: antes/después, cadena causal, bucle de retroalimentación, pantalla dividida.
  • Sistema: mapa de actores, entradas, salidas, dependencias, límites.
  • Escala: comparación familiar, barras proporcionales, contenedores anidados, mapa recuadro.
  • Datos: gráfico con una conclusión, tendencia resaltada, línea de fuente, advertencia.
  • Producto: interfaz de usuario real o superficie del producto, contexto del problema, función en uso, estado del resultado.
  • Capacitación: ruta del cursor, control resaltado, lista de verificación, estado de éxito/error.
  • Social/emocional: escenario humano, testimonio con divulgación, metáfora de personaje.

Mantén el lenguaje visual consistente: un color para "problema", uno para "solución", uno para "advertencia", uno para "prueba". No cambies los significados a mitad del video.

Evita el literalismo decorativo. Un icono de nube detrás de cada mención de "nube" rara vez explica algo. Usa imágenes para mostrar relaciones, secuencia, magnitud, cambio y excepciones.

Diagramas, gráficos y llamadas de datos

Usa gráficos y diagramas solo cuando respondan una pregunta mejor que la narración.

Reglas de datos y diagramas:

  • Indica la conclusión en palabras antes o junto con el gráfico.
  • Usa el gráfico más simple que preserve la verdad. Prefiere gráficos de barras para comparaciones de categorías, gráficos de líneas para tendencias a lo largo del tiempo, líneas de tiempo para secuencias y diagramas anotados para mecanismos.
  • No uses gráficos circulares/donut para muchas categorías, pequeñas diferencias o comparaciones precisas.
  • Etiqueta directamente cuando sea posible; reduce la búsqueda de leyendas.
  • No codifiques el significado solo con el color. Agrega etiquetas, posición, forma, patrón o texto.
  • Para entrega web o interactiva, proporciona alternativas accesibles. W3C WAI trata los gráficos, diagramas de flujo, diagramas y mapas como imágenes complejas cuando contienen información sustancial, que requieren alternativas de texto cortas y largas. La guía USWDS señala que el contenido de gráficos SVG puede ser difícil para los lectores de pantalla y recomienda tablas accesibles para lectores de pantalla más resúmenes de texto plano de tendencias/estadísticas, mientras advierte que las tablas solas pueden no ser suficientes para conjuntos de datos complejos.
  • En la entrega solo de video, haz que la narración y los subtítulos transmitan la conclusión clave del gráfico, y proporciona una transcripción o notas complementarias cuando el gráfico sea esencial.
  • Genera gráficos de forma determinista a partir de datos verificados. No le pidas a un modelo de imagen generativa que cree un gráfico factual.

Dirección del movimiento

El movimiento debe explicar el cambio.

Usa el movimiento para:

  • revelar secuencia;
  • conectar causa y efecto;
  • mostrar transiciones de estado;
  • comparar antes/después;
  • guiar la atención;
  • ritmar la carga cognitiva;
  • crear énfasis emocional después de que el espectador entienda el punto.

Evita el movimiento que compite con la explicación:

  • movimiento de fondo constante debajo de texto denso;
  • movimientos de cámara rápidos durante información nueva;
  • cambios simultáneos en múltiples regiones;
  • transiciones que implican causalidad donde no existe;
  • comportamiento falso de interfaz de usuario que difiere del producto;
  • parpadeo más de tres veces en un segundo o parpadeos cerca de umbrales conocidos; WCAG incluye un requisito de "tres parpadeos o por debajo del umbral" para contenido web.

Usa pausas. Una pausa de medio segundo después de una revelación clave a menudo enseña más que un movimiento constante.

Individual skills in this repo

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

calesthio/brand-launch-film-production

Provider-independent production workflow for AI agents creating brand launch films, product reveal videos, manifesto films, campaign hero films, website hero videos, investor/customer launch assets, and social cutdowns. Use when planning, scripting, generating, editing, reviewing, or delivering launch films that must align strategy, claims, brand voice, visual direction, product proof, accessibility, compliance, and multi-platform delivery.

calesthio/character-design-continuity

Provider-independent character design and continuity direction for generated media. Use when an agent must create, preserve, revise, or QA a recurring character across AI-generated images, video clips, avatars, animation, comics, ads, product mascots, serialized social posts, or multi-shot campaigns; especially when building character bibles, reference packs, prompts, expression/pose ranges, costume/hair/makeup/prop continuity, identity and likeness safeguards, iteration plans, handoff notes, or continuity reviews.

calesthio/generative-media-skills

Provider-independent localization and dubbing production direction for AI agents producing translated videos, dubbed ads, social clips, explainers, avatar videos, documentaries, training media, and multi-market campaigns. Use when planning or reviewing subtitle-versus-dub strategy, translation adaptation, glossary/style-guide setup, casting or voice matching, lip-sync or phrase-sync direction, synthetic dubbing boundaries, captions/subtitles handoff, accessibility, platform delivery, client review, or localization QA.

calesthio/generative-media-skills

Provider-independent cinematic trailer production for AI agents creating movie-style trailers, teaser trailers, launch trailers, game trailers, documentary trailers, series promos, and high-impact generated-media previews. Use for trailer strategy, structure, shot planning, voiceover/title-card copy, music and sound-design direction, generated-video prompt translation, edit pacing, platform/runtime choices, delivery handoff, rights/claims caveats, and trailer QA.

calesthio/generative-media-skills

Use this skill to plan, direct, finish, and QA provider-independent mono or stereo 180-degree, 360-degree, spherical, spatial, wide-FOV, and immersive video. It covers format choice, capture rigs, stitching, nadir and seam management, stereoscopic comfort, attention direction, stabilization, ambisonic and spatial audio, titles, captions, accessibility, edit, color, VFX, projection metadata, Vision Pro, YouTube, headset delivery, device QA, and privacy, location, and likeness rights. Do not use it for interactive XR apps, volumetric/world-model generation, game-engine experiences, or provider-specific video generation prompts.

calesthio/generative-media-skills

Provider-independent production workflow for AI agents creating music videos, lyric videos, visualizers, performance/narrative/dance videos, social cutdowns, album or single launch assets, and generated-media clips synchronized to songs. Use when planning, directing, prompting, editing, reviewing, or delivering video content built around a recorded song, artist performance, lyrics, beat timing, choreography, platform variants, music rights, likeness consent, accessibility, or synthetic-media disclosure.

calesthio/generative-media-skills

Provider-independent captions and media accessibility direction for AI agents producing or finishing generated videos, ads, social clips, explainers, avatar videos, documentaries, podcasts/video recuts, training media, and localized content. Use when planning, authoring, reviewing, localizing, burning in, exporting, or QAing captions, subtitles, SDH, transcripts, audio description, flashing/motion safety, caption readability, or accessible media handoff files.

calesthio/generative-media-skills

Provider-independent dialogue editing and ADR direction for AI agents producing generated videos, films, ads, avatar clips, explainers, localization/dubbing, podcasts, recuts, and social content. Use for dialogue prep, repair, room tone, take comping, sync, ADR cueing, dubbing direction, pronunciation, de-essing, plosives, mouth clicks, voice continuity, synthetic voice consent boundaries, captions/transcripts handoff, mix handoff, loudness, intelligibility, accessibility, and QA.

calesthio/motion-graphics-direction

Provider-independent motion graphics direction for AI agents producing title sequences, lower thirds, explainer graphics, product UI overlays, social ads, kinetic typography, diagrams, data callouts, brand films, and video post. Use when planning, prompting, storyboarding, specifying, implementing, reviewing, or QAing motion graphics across live footage, generated video, UI capture, data visualization, brand systems, typography, accessibility, claim integrity, runtime handoff, and iteration.

Skills relacionados