Communitygithub.com

Win-Hao/knowledge-video

Convierte un tema en un video de conocimiento explicativo fácil de seguir, atractivo visualmente y que enganche hasta el final (texto en pantalla sobre música, al estilo que triunfó en Douyin con #Vibe知识大赏), renderizado con HyperFrames.

¿Qué es knowledge-video?

Este skill transforma cualquier tema en un video de conocimiento tipo 'explicador', optimizado para plataformas como Douyin (videos cortos con texto en pantalla y música de fondo). Sigue un flujo de trabajo flexible: investigación, redacción de guion, selección de imágenes, diseño visual y storyboard, y renderizado final con HyperFrames. Incluye herramientas auxiliares para edición de música, sincronización con el ritmo, efectos de sonido y autoverificación. El usuario puede elegir la profundidad de cada paso y recibir recomendaciones basadas en la duración de la música. Funciona con Claude Code, Cursor y otros agentes que soporten subagentes para tareas grandes. Es ideal para contenidos de ciencia, historia, 'cómo funciona' o cualquier tema que se preste a un video breve pero informativo. El skill prioriza la precisión de los hechos, la licencia de los activos y la coherencia visual con el audio.

Compatible con✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Win-Hao/knowledge-video/tree/HEAD/skills/knowledge-video

Preguntar en tu IA favorita

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

Documentación

Video de conocimiento

Convierte un tema en un video de conocimiento que la gente quiera ver hasta el final. Lo que sigue es un camino que funciona, no un procedimiento fijo: puedes fusionar, saltar o reordenar pasos, y diseñar la redacción, la estética y el movimiento para este tema por ti mismo.

Habla con el usuario en su idioma; los nombres de archivo que aparecen a continuación son valores predeterminados.

El camino aproximado

  1. Investigación → article.md: encuentra fuentes y escribe un artículo con referencias. Primero observa la forma del tema (cronología, cadena de causas, concepto, comparación, mitos, una historia), luego decide qué puntos cubrir. El usuario decide cuántos: ofrece dos o tres opciones según la duración de la música y recomienda una.
  2. Guion → script.md: reescribe el artículo como un video que la gente se desplace para ver.
  3. Imágenes → images.md o image-prompts.md: imágenes reales o indicaciones para ilustraciones generadas por IA (asume que no puedes llamar a una API de imágenes; el usuario usa su propia herramienta).
  4. Estética y storyboard → looks/, storyboard.md: muestra al usuario algunas direcciones, luego crea el storyboard con la música.
  5. Renderizado → opening-preview.mp4 → final.mp4: primero un avance corto, luego el video completo una vez que esté bien.

Por defecto, muestra al usuario el resultado de cada paso antes de continuar: una dirección equivocada es más costosa después del renderizado. Si el usuario dice "adelante, todo", continúa y anota lo que elegiste y por qué en storyboard.md.

Cada paso: completa una instrucción y luego síguela

Según la guía de instrucciones de Anthropic, mantén los antecedentes, requisitos y verificaciones en etiquetas XML separadas, con una razón para cada línea: las partes separadas no se mezclan, y saber el por qué permite que el modelo generalice a lo que no está escrito. Tú mismo llenas las etiquetas, a partir de este tema y lo que el usuario ha dicho.

  • Brief prompts/brief.md: se completa una vez al inicio, se actualiza después de cada paso. Solo una etiqueta <context>: el tema, la audiencia, la conclusión principal, duración, orientación, música, lo que le gusta y no le gusta al usuario, lo que se decidió en pasos anteriores, dónde están los archivos.

  • Instrucción de este paso prompts/<paso>.md, cuatro etiquetas:

    • <role>: qué rol asume este paso y qué le importa más a ese rol. Los roles varían según el paso; elige uno para este paso, p. ej., investigación es un editor de conocimiento (le importan más las fuentes), guion es un guionista (le importa más si los espectadores se salen), imágenes es un editor de fotografías o ilustrador, la estética es un director de arte, el storyboard es un artista de storyboard, la composición es un diseñador de movimiento (le importa más qué explica cada movimiento).
    • <task>: qué produce este paso y dónde va.
    • <style>: enfoques recomendados, cada uno con una razón; recomendaciones, no reglas: elige entre los ejemplos en references/ o diseña algo nuevo para este tema; sigue al usuario cuando haya dicho lo que quiere, y anota aquí también lo que no quiere.
    • <check>: qué verificar, elemento por elemento, antes de que el paso se considere completado; incluye los elementos "Debe cumplirse".

    Escribe <role>, <task> y <check> en cada paso; omite <style> donde no sea necesario (investigación y renderizado generalmente). Infiere lo que el usuario no ha dicho a partir del tema, y pregunta sobre lo que no estés seguro en el informe. Muestra la instrucción completada junto con el resultado del paso; si el usuario la edita, repite el paso desde la versión editada.

Quién lo sigue: los pasos que requieren intercambio con el usuario (cuántos puntos, qué estética) los haces tú mismo. Los pasos grandes y autónomos (investigación, encontrar imágenes o escribir indicaciones de imágenes, escribir la composición y renderizado) se envían a un subagente: dale solo el brief, la instrucción de este paso y las rutas de archivo, para que su contexto esté limpio y contenga solo lo que necesita este paso. No sabe lo que tú y el usuario discutieron, por lo que ambos deben estar completos. Cuando termine, lee su salida y ejecuta la autoverificación antes de mostrársela al usuario. Sin subagentes, sigue la instrucción tú mismo.

Debe cumplirse

  • Los hechos tienen fuente: cada año, nombre, número y cita se remonta a una fuente confiable (artículos académicos, instituciones, archivos, las propias palabras de la persona), enlazada en article.md; descarta lo que no puedas referenciar, etiqueta las estimaciones, di de quién es la versión si es un relato de segunda mano. Cada línea en pantalla, incluida la pregunta inicial y el final, coincide con article.md.
  • Los activos son utilizables: las imágenes, la música, los efectos de sonido y las fuentes tienen licencia para esto (verifica la página del archivo); los créditos van en credits.md.
  • No se permiten rostros de personas reales generados por IA; si el video usa ilustraciones de IA, activa la etiqueta "contenido generado por IA" de la plataforma.
  • La imagen depende solo del tiempo: fija cualquier aleatoriedad para que un fotograma se renderice igual cada vez (HyperFrames lo necesita).
  • Antes de entregar, míralo completo: texto visible y legible a tiempo, los años y números coinciden con el artículo, sonido e imagen sincronizados.

Herramientas disponibles

HyperFrames para la imagen (npx hyperframes init / docs / check / snapshot / render); si sus skills están instalados, síguelos para las composiciones. Herramientas pequeñas en scripts/, úsalas o no:

ScriptLo que hace
beats.pytempo, pulsos, líneas de compás y cambios de volumen por compás de la música
music_loops.py, cut_music.pyencuentra compases que se repiten o cortan sin problemas, construye la nueva música a partir de una lista de compases
timing.pycoloca cada pantalla del guion sobre la cuadrícula de pulsos, fija pantallas clave en compases determinados
sfx.pydescarga los efectos de sonido CC0 de Kenney, mezcla las señales de efectos de sonido en una sola pista
qa.pyhojas de contacto de cada pantalla y fotogramas alrededor de los pulsos clave

Lo que dejaron videos anteriores

Referencias, no reglas. Diseña primero para este tema; mira aquí cuando no estés seguro o cuando te encuentres con el mismo problema:

  • references/example-ai-history.md: la primera ejecución probada, la salida de cada paso y su temporización.
  • references/prompt-examples.md: dos instrucciones completadas de un video probado, para ver qué tan detalladas llegan a ser.
  • references/notes.md: observaciones sobre guion y ritmo.
  • references/images.md: verificación de licencias, redacción de indicaciones, generación por capas.
  • references/visuals.md: collage denso, momentos de cronología, tarjetas de fotos, adaptación de interfaces a pantallas generadas, qué dibujar en código.
  • references/sound.md: ediciones de música, efectos de sonido, volumen.
  • references/pitfalls.md: consulta primero cuando un renderizado falla o la imagen está desviada.

Skills relacionados