Communitygithub.com

gdoteof/explainers

Ejecuta el pipeline conversación → investigación → guión → voz → video en el repositorio explainers (~/claude/explainers). Entrevista al propietario para encontrar el argumento de un video, investiga para crear una hoja de hechos con fuentes, escribe un guión donde cada compás está etiquetado como hecho/estimación/opinión/especulación/línea, lo verifica, lo narra con la voz local, dibuja las escenas en Skia (manim para gráficos), renderiza y escribe la descripción. Úsalo cuando el usuario quiera discutir ideas para un video, quiera crear o modificar un video explicativo, redactar o verificar un guión, o mencione el pipeline de explainers o el anfitrión de Footnote.

¿Qué es explainers?

Este skill automatiza el flujo de producción de videos explicativos desde la conversación inicial hasta el renderizado final, siguiendo el pipeline del repositorio `gdoteof/explainers`. Funciona en cualquier terminal con Python y `uv run`, y está diseñado para creadores de contenido que quieren transformar ideas en videos bien estructurados y basados en hechos. El proceso incluye: entrevistar al propietario para identificar tesis sólidas, investigar con fuentes verificables, redactar guiones con beats etiquetados (fact, estimate, view, opinion, speculation, line), verificar la consistencia de fuentes, narrar con voz sintética o grabada, generar escenas visuales con Skia y manim, y renderizar el video final. Las etapas clave tienen puntos de control donde el usuario aprueba avances. Es particularmente útil para videos de análisis profundo, donde la precisión factual y la claridad narrativa son críticas. El lenguaje de programación principal es Python, con dependencias como Skia, manim y otras librerías científicas.

Compatible con✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/gdoteof/explainers/tree/HEAD/.claude/skills/explainer-video

Preguntar en tu IA favorita

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

Documentación

Video explicativo

Trabaja desde la raíz del repositorio con uv run. README.md tiene los comandos y formatos de archivo; EDITORIAL.md es el estándar. Este es el orden de trabajo y dónde están los puntos de control del usuario.

0. La conversación, donde comienza un video

Los videos surgen de lo que el propietario piensa, puesto a prueba, no de una lista de temas. Antes de cualquier investigación, entrévalo.

  • Una o dos preguntas a la vez, en conversación sencilla y breves: el propietario responde por dictado, y cinco a la vez eran demasiadas para responder o mantener claras. A lo largo de las rondas, mezcla los tipos: preguntas abiertas ("¿qué protege cada lado?"), cuestionarios que responden antes de buscar la respuesta ("¿qué porcentaje dirías?"), pruebas de acero ("presenta el caso del otro lado de manera que ellos lo firmarían"), y cebos: la objeción más fuerte a lo que acaban de decir, expuesta sin rodeos. Sigue la respuesta que te sorprendió, no la siguiente pregunta de una lista.
  • Las suposiciones incorrectas del propietario pueden aparecer en pantalla: él ha aceptado eso. Pero un número es solo su suposición si lo ofreció como tal. Un número dentro de un ejemplo ("digamos que gastan el 70% en facturas...") es una ilustración: regístralo como tal, nunca lo puntúes ni lo muestres como suposición, y pregunta cuando no esté claro cuál era.
  • Escucha la afirmación debajo de la respuesta: una tesis que podría ser errónea, una distinción que sigue haciendo, una historia propia. Esos son videos. Un tema ("aborto") no es una idea; "los dos lados están respondiendo preguntas diferentes" sí lo es.
  • Conserva sus palabras. Guarda las respuestas textuales y con fecha en notes/<tema>.md, que git ignora: las notas son crudas y privadas, y el guión es la forma publicada. Marca tus propios resúmenes como tuyos.
  • Clasifica lo que dijo según lo que necesitará el guión. Lo que se puede verificar se convierte en investigación, luego en compases de fact, estimate o view. Lo que es suyo se convierte en opinion o speculation. Precisen las palabras cargadas antes de que avancen ("ingeniería": ¿por quién y cómo lo sabríamos?), y diles claramente cuando las fuentes no respalden algo que creen.
  • Detente cuando haya una tesis, tres o cuatro movimientos que la sostengan y la objeción más fuerte a ella. Reproduce eso en unas pocas líneas y obtén un sí antes de investigar.

El propietario quiere saber cómo funcionan las cosas ahora. De dónde viene algo es una breve digresión dentro de un video, no el video en sí.

1. Investigación, antes de cualquier guión

  • Establece la pregunta que responde el video en una oración, y las tres o cuatro cosas que un espectador debería poder decir después.
  • Construye una hoja de hechos: una afirmación por línea, cada una con una fuente que fue obtenida y leída en esta sesión y el pasaje que la respalda. Mantén las fuentes en videos/NOMBRE/sources.toml desde el primer día (una carpeta con solo ese archivo es un video en investigación o en pausa) y las afirmaciones en notes/NOMBRE.md. Investigar en un subagente está bien, pero indícale que devuelva citas textuales y que marque lo que no pudo respaldar; nunca aceptes una URL que no haya abierto.
  • Para un tema controvertido, recopila el caso de cada lado desde sus defensores más fuertes y anota qué desacuerdos son sobre hechos y cuáles sobre valores.
  • Escribe lo que las fuentes NO respaldan. Las versiones populares de una historia suelen ser más ordenadas que la evidencia.

2. Guión (punto de control: el usuario lo aprueba)

  • python -m explainers.new NOMBRE (rellena alrededor de un sources.toml que ya existe), luego script.md.
  • Un video dura de 12 a 25 minutos: aproximadamente de 2,100 a 4,400 palabras al ritmo de lectura del propietario (unas 175 palabras por minuto con las pausas). Divídelo en secciones que el espectador pueda sentir cambiar, cada una con su propia pregunta.
  • Una idea por compás, un compás por respiración: de 15 a 40 palabras. Escribe para el oído: oraciones cortas, la palabra importante al final, números redondeados a lo que un oyente pueda retener, sin corchetes ni abreviaturas.
  • Comienza con la pregunta o la sorpresa, no con un saludo. Cada sección debe dejar al espectador queriendo la siguiente.
  • Etiqueta según lo que promete la oración, no según lo seguro que te sientas. Divide un compás que mezcle tipos. Un guión que es principalmente fact y view con unos pocos compases claramente marcados como opinion es el objetivo; check imprime la división.
  • No escribas la opinion del canal sobre una pregunta controvertida tú mismo. Deja un espacio marcado, o redacta uno y di claramente que es un borrador para que el usuario lo acepte, cambie o elimine.
  • Pon una nota > debajo de cada sección diciendo qué hay en pantalla. Cada compás necesita una imagen que cambie al menos cada cinco segundos más o menos.
  • python -m explainers.check videos/NOMBRE --urls debe pasar. Muestra al usuario el guión con la división y la lista de fuentes.

3. Voz (punto de control: el usuario la graba)

  • Borrador con la voz sintética: python -m explainers.narrate videos/NOMBRE. Corrige las palabras que supuso en say.txt. Añade pause a un compás cuando su imagen necesite tiempo para asentarse. Las imágenes se pueden construir y el guión se puede ajustar en este borrador.
  • Cuando la redacción esté establecida, el usuario la graba en su propia terminal: python -m explainers.record videos/NOMBRE muestra cada compás, lo graba y verifica la toma por nivel y por las palabras del guión. --room graba la habitación vacía una vez, para los espacios. Luego narrate de nuevo: usa una toma donde haya una nueva. Las imágenes permanecen en sus palabras, ya que las señales se buscan por palabra, pero los compases cambian de longitud: ejecuta sweep y mira una hoja de contactos antes de renderizar.
  • El usuario no tiene que leer palabra por palabra. Cuando una toma se desvía del guión, record muestra la diferencia y, si la conserva, reescribe el compás en script.md con lo que dijo. Así que haz commit del guión antes de que grabe, y después lee el git diff del mismo: ordena la ortografía y puntuación de las nuevas palabras (eso no hace que una toma quede obsoleta), y por cada fact, estimate o view cambiado, lee la cita de la fuente contra las nuevas palabras. Si ya no las respalda, dile al usuario: el compás se lee de nuevo o se reetiqueta, no se deja así.
  • Reformular tú mismo un compás grabado le cuesta al usuario una nueva lectura. Agrupa esos cambios y pregunta primero.
  • --audition VOICE ... compara voces sintéticas para el borrador; la línea voice: del guión elige una.

4. Imágenes

  • Comienza desde el video.py de la plantilla y reemplázalo escena por escena. Una escena por sección es el grano habitual; corta entre ellas con theme.scenes.
  • Un video ocurre en un set (explainers/sets.py): hasta ahora un aula con una pantalla de proyector, que es lo que el propietario pidió. Dibuja un gráfico, una tarjeta o una figura como diapositiva, una imagen de 1920x1080, y entrégala al set: la misma diapositiva está en la pantalla en el plano general y llena el encuadre cuando la cámara se acerca (sets.shots para los movimientos). Acércate cuando la diapositiva deba leerse, aléjate cuando el anfitrión tenga algo que hacer, y baja el proyector (on) cuando el anfitrión se adelante con una opinión. Pon el título de la sección en la pizarra (chalk), y dale a la etiqueta un plate para que se lea sobre la sala. Las notas > de un guión dicen "Plano general" o "Proyector". Vendrán otros sets: mantén una diapositiva libre de la sala.
  • Cuelga cada movimiento de una señal: N.at(compás, palabra). Nunca escribas un tiempo en segundos.
  • El anfitrión es pequeño y a un lado mientras se explica algo, y grande cuando habla por sí mismo (la apertura, una opinión, el cierre). Mira y señala lo que se está discutiendo.
  • Los gráficos, diagramas y cualquier cosa matemática van en un manim Insert. Todo lo demás es Skia.
  • Los lados de un argumento son theme.SIDE_A / theme.SIDE_B. Un conjunto de datos que dibuja un gráfico se guarda en la carpeta data/ del video con su origen y fecha.
  • Bucle: preview una sección, mira la hoja, arregla, repite; sweep antes de cada renderizado.

5. Renderizado y entrega (punto de control: el usuario lo ve)

  • python -m explainers.render videos/NOMBRE --fresh, luego python -m explainers.describe videos/NOMBRE.
  • Informa qué está verificado y qué no, cualquier compás cuya etiqueta fue una decisión subjetiva, y cualquier cosa que la voz diga de manera extraña.

Skills relacionados