CommunityRedacción y edicióngithub.com

Livin21/scripting-explainer-shorts

Úsalo al escribir o verificar la narración de un vídeo educativo corto (menos de 60 segundos) sobre cómo funciona algo, al elegir o verificar un gancho, cuando una fuente no se abre o se contradice a sí misma, o al escribir etiquetas en pantalla, descripciones o texto web que afirme hechos sobre un episodio.

¿Qué es scripting-explainer-shorts?

Esta habilidad está diseñada para garantizar la precisión fáctica en vídeos explicativos cortos (menos de 60 segundos). El proceso comienza verificando el gancho del vídeo con una fuente primaria; si falla, se reescribe; si se sostiene con matices, se ajusta; y si solo es verificable en algunos casos, se atribuye la fuente. Luego se investigan los puntos clave, abriendo cada fuente y citando la línea de respaldo, siguiendo una jerarquía de fuentes (organismos de normalización, gobiernos, documentación del fabricante, universidades y divulgadores reputados). La habilidad también maneja problemas comunes como páginas que no se abren, fuentes que se contradicen o inferencias no explícitas. Finalmente, se escribe la narración siguiendo una estructura específica (gancho, revelación, tres puntos clave, giro y cierre), se ajusta al presupuesto de palabras (calculado a partir de la velocidad de habla de la voz), y se documenta todo en `sources.md` con una fila por afirmación. Es útil para escritores de guiones, verificadores de hechos y creadores de contenido educativo que buscan rigor sin sacrificar el ritmo narrativo.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Livin21/behind-the-things-skills/tree/HEAD/skills/scripting-explainer-shorts

Installed? Explore more Redacción y edición skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

Preguntar en tu IA favorita

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

Documentación

Guiones para vídeos explicativos cortos

Resumen

Un vídeo explicativo solo es tan bueno como su afirmación más débil. Cada frase verídica y cada número en pantalla necesita una fuente que realmente hayas abierto. Un gancho que suena genial suele ser la línea menos cierta del borrador, así que verifícalo primero y reescríbelo si falla.

Proceso

  1. Verifica el gancho primero. Encuentra una fuente primaria (un organismo de normalización, fabricante, agencia gubernamental, universidad o código fuente publicado) que lo afirme. Luego:

    • Falla: reescríbelo según lo que dice la fuente. "Las rayas no son el número" se convirtió en "el código de barras no sabe el precio"; "una mota de metal radiactivo" se convirtió en "algo radiactivo" (es un óxido, demasiado pequeño para verlo).
    • Se sostiene con un matiz: mantenlo, ajusta las palabras para que coincidan con la fuente y transmite el matiz en un latido ("no cocina de adentro hacia afuera" → las ondas calientan aproximadamente una pulgada de profundidad).
    • Solo es verificable para algunos casos: mantenlo general, atribuye cada número específico a su fuente ("El valor predeterminado de Android…", "Windows…") y registra la brecha como verificado parcialmente.
  2. Investiga los latidos. Abre cada fuente en lugar de confiar en un fragmento de búsqueda y cita la línea de respaldo. Elige la fuente más sólida que afirme la afirmación:

    RangoFuenteEjemplo
    1Organismos de normalización, especificaciones, código fuente publicadoEMVCo, página del catálogo ISO/IEC, NFC Forum, GS1, AOSP
    2Agencias gubernamentales, reguladores, bancos centralesNRC, EPA, FDA, USDA, Reserva Federal, BCE
    3Documentación del propio fabricanteVisa, Mastercard, hojas de datos de NXP, Microsoft Learn
    4Universidades, libros de texto, artículos revisados por paresapuntes de cursos universitarios, artículos de conferencias
    5Divulgadores y prensa reputadossolo cuando 1–4 no lo afirman

    Nunca cites un espejo o un rehospedaje (copias de IPFS o Wikipedia, re-subidas de PDF), una granja de contenidos, un blog SEO o material de marketing de un proveedor. Si solo se abre un espejo, encuentra la página original o una copia archivada de la misma. Wikipedia (o una copia de ella) puede llevarte a una fuente: sigue la referencia del artículo, ábrela y cítala.

    • Una página no se abre: prueba con otro recuperador, luego con una copia archivada. Si usas un archivo, etiquétalo. Si no se carga nada, matiza la línea o elimínala.
    • La fuente se contradice a sí misma o contradice la física: expresa la cifra correcta sin rodeos ("aproximadamente cinco pulgadas") y muestra el cálculo en sources.md. Anota la cifra de la fuente bajo "Simplificado a propósito". Ejemplo: c ÷ 2450 MHz = 12.2 cm ≈ 5 pulgadas, no el redondeo del USDA de "4 pulgadas".
    • Una inferencia (cierta por razonamiento, pero ninguna fuente lo dice en una línea): márcala como inferencia en sources.md.
  3. Escribe la narración (estructura a continuación).

  4. Ajusta el presupuesto. El límite es 54 × (las palabras por segundo de la voz), tomado de CHANNEL.md del proyecto; son aproximadamente 140 palabras para una voz de 2.6 palabras por segundo. El cierre hablado está incluido. Cuenta con wc -w; una palabra con guion cuenta como una.

  5. Tabla de escenas y empaquetado (ver la plantilla en templates.md).

  6. Escribe sources.md con la plantilla: una fila por afirmación, incluyendo cada número mostrado en pantalla en etiquetas o lecturas, luego "Simplificado a propósito" y "Verificado parcialmente".

Estructura de la narración

  1. Gancho (0–3 s): un hecho sorprendente y verdadero, dicho sobre el objeto, que está completamente dibujado en el primer fotograma.
  2. La revelación: abre el objeto y muestra lo que hay dentro. Si la "cosa" es abstracta (un icono, una señal), revela el dispositivo que lo produce, como la radio del teléfono para las barras de Wi-Fi. Elige la vista dibujada para que la revelación exponga el interior y haz que el verbo coincida con el movimiento ("levanta la tapa").
  3. Tres latidos: qué hay dentro → cómo funciona → lo que nadie espera.
  4. Línea de giro: el hecho que la gente repite a un amigo.
  5. Cierre: la línea fija del canal.

Escribe para el oído: frases cortas y deletrea los números como se hablan. Añade notas de voz para palabras arriesgadas, que se convierten en reescrituras en el mensaje de TTS.

Todo otro texto

Las etiquetas en pantalla, descripciones de YouTube, subtítulos y páginas del sitio solo pueden afirmar afirmaciones que ya están en sources.md. Agregar un hecho "pequeño" al escribir el texto es cómo se envían errores.

Errores comunes

ErrorSolución
Mantener un gancho pegadizo que es "básicamente cierto"Reescríbelo según lo que dice la fuente
Repetir el error de redondeo de una fuenteVerifica contra la física o una segunda fuente; muestra el cálculo
Etiquetas con números sin fuenteAgrega una fila de fuente para cada figura en pantalla
148 palabras para una voz lentaUsa el ritmo medido de la voz; el límite es 54 × ritmo
Descartar en silencio una fuente que no se abreMatiza o elimina la línea; regístrala como verificado parcialmente
Citar un blog de proveedor o un espejo de WikipediaSube en la tabla: la especificación, el regulador, el fabricante

Skills relacionados