Communitygithub.com

training-video

Muestra al agente cómo planificar, construir o editar un 'vídeo de formación' para que el resultado concreto sea un copión o guion utilizable. El procedimiento avanza a través de Обучително видео, Четири одобрения — без тях не харчиш пари и време, Ход. Úsalo cuando un nuevo encargo requiera esta especialidad.

¿Qué es training-video?

Este skill transforma al agente en un productor de vídeos de formación corporativos, guiándolo paso a paso desde la planificación hasta la entrega final. Es útil para desarrolladores y equipos de producto que necesitan crear contenido instructivo profesional para usuarios o colegas, sin requerir conocimientos técnicos de edición de vídeo. El skill soporta dos modos principales: basado en materiales (documentación, PDFs) y basado en código (grabación de aplicación). Funciona en macOS y Windows, utilizando scripts en Python para narración y Node.js para renderizado de diapositivas y grabación de pantalla. El proceso se divide en cuatro aprobaciones obligatorias (guion, coste, muestra de voz y visión) que garantizan que no se invierta tiempo ni dinero sin consenso. Además, gestiona claves API de Gemini por proyecto, asegurando que los costes de voz se imputen correctamente y que las claves nunca se expongan en el chat.

Compatible con✓Claude Code~Codex CLI~Cursor✓Gemini CLI
npx skills add https://github.com/erida-ai/training-video/tree/HEAD/skills/training-video

Preguntar en tu IA favorita

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

Documentación

Обучително видео

La voz guía, la imagen la sigue: primero guion y sonido, luego diapositivas o grabación, sincronizados con la duración de cada réplica.

Con quién hablas. La persona puede no ser técnica: habla en búlgaro (o en el idioma en que te escriba), con palabras simples, sin comandos ni rutas, a menos que pregunte. Los pasos técnicos los haces tú. Pregunta solo por las decisiones que le corresponden: contenido, audiencia, idioma, estilo visual, aprobaciones.

Los scripts están en ${CLAUDE_SKILL_DIR}/scripts/ y se ejecutan con python3 -B ${CLAUDE_SKILL_DIR}/scripts/<script>.py … — en Windows en lugar de python3 usa el comando que doctor.py indica en la línea "Comando Python" (python o py -3); las diapositivas y el renderizado — node ${CLAUDE_SKILL_DIR}/deck/render.cjs …; la grabación de la aplicación — ${CLAUDE_SKILL_DIR}/screencast/. Los temas están en ${CLAUDE_PLUGIN_ROOT}/themes/. Funciona en macOS y Windows (en Bash y en PowerShell): los comandos se mantienen simples — sin tuberías, && ni redirecciones.

El proyecto es la carpeta en la que trabajas (repositorio de producto o carpeta de documentos). Cada proyecto tiene su propia clave Gemini, que reside solo en el ordenador de la persona (Keychain / Credential Manager); el marcador del proyecto es .training-video/project.json (id y nombre, sin secretos).

Cuatro aprobaciones — sin ellas no gastas dinero ni tiempo

  1. Guion (el texto de las réplicas y el plan de las diapositivas/pantallas).
  2. Coste — la tabla de cost.py. Las muestras pequeñas (hasta 3–4 réplicas) no requieren aprobación, la locución completa sí.
  3. Muestra de voz — las primeras 3 réplicas (narrate.py --sample 3); la persona las escucha.
  4. Visión — 1–2 diapositivas terminadas o fotogramas de la grabación, antes del renderizado completo.

Paso a paso

  1. Entorno y clave — cada vez que ejecutes, antes que nada.
    • doctor.py <proyecto>. Lo que falte, arréglalo con permiso de la persona usando el comando que doctor.py da para ese sistema (brew / winget); para el renderizado npm ci en ${CLAUDE_PLUGIN_ROOT}, si Claude Code no lo ha hecho, y npx playwright install chromium.
    • Clave del proyecto: key.py check <proyecto>.
      • OK → continúas.
      • NO HAY PROYECTO → dile a la persona que la carpeta recibirá un pequeño archivo .training-video/project.json (nombre y número del proyecto, sin secretos — puede ir a git) y pregúntale por el nombre del proyecto (sugiere el nombre de la carpeta). Luego el asistente.
      • NO HAY CLAVE → si indica que hay una clave común antigua, pregunta "¿Utilizo su clave Gemini actual también para este proyecto?" (sí → key.py setup <proyecto> --use-legacy). Si no, el asistente.
      • RECHAZADA → el asistente con --replace.
    • El asistente: primero explica con palabras sencillas lo que viene: "Se abrirá la página de Google AI Studio — cree una clave (Create API key) en la cuenta que pagará la voz de este proyecto, y cópiela. Luego aparecerá una ventana para pegarla; la clave queda solo en este ordenador." Ejecuta key.py setup <proyecto> [--name "<nombre>"] — abre la página y la ventana, verifica la clave con Gemini y la guarda. Nunca pidas la clave en el chat ni la escribas en ningún lado; si la persona la pega en el chat, dile que la borre de Google AI Studio y cree una nueva.
    • Las personas técnicas pueden usar Vertex (gcloud auth application-default login y GOOGLE_CLOUD_PROJECT); GEMINI_API_KEY en el entorno vale para todos los proyectos — solo para CI.
  2. Recepción — oriéntate solo, pregunta solo lo que no esté claro.
    • Qué hay: archivos/carpeta en el chat o en el disco, enlace de Google Drive (a través del conector de Google Drive vinculado, si existe), enlaces web, repositorio git de un producto (.training-video/profile.md en él significa que el producto está preparado para vídeo).
    • Hay PDF, y doctor.py dice "poppler (PDF): no" → pregunta con una sola cuestión: "Para extraer el texto y las imágenes de los PDFs necesito un programa pequeño (poppler, unos 35 MB). ¿Lo instalo?" Si "sí" — el comando de doctor.py (brew / winget); si "no" — lee los PDFs directamente, sin imágenes de ellos.
    • Modo: por materiales → reference/materials.md; por código (grabación de aplicación) → reference/code.md. Si hay ambos, pregunta cuál es el vídeo.
    • Por código — para qué rol. El vídeo es para un rol de la aplicación (operador, gerente, administrador…): la grabación inicia sesión como ese rol y muestra solo sus pantallas. Los roles se toman del perfil del producto o del código (reference/code.md, "Roles — desde el código") y pregunta con respuestas preparadas — las etiquetas, como las dice la aplicación. No escribas guion antes de que pase la inspección como ese rol (survey.cjs).
    • Pregunta en lote (con preguntas de respuestas preparadas): para quién es el vídeo y qué deben saber hacer después; idioma de la voz (por defecto búlgaro); idiomas de subtítulos; duración (por defecto 3–8 min.); tema (themes/, por defecto "Neutral"; si los materiales tienen su propia marca — sugiere un tema de ellos); dónde guardar el resultado (carpeta en Drive o en el ordenador).
  3. Carpeta del vídeo — fuera del plugin y fuera del repositorio del producto, por defecto en "Documentos" de la persona: <Documentos>/Vídeos de formación/<nombre-corto>-<fecha>/ (~/Documents en Mac; en Windows %USERPROFILE%\Documents, puede estar en OneDrive):
    • video.json — {"name": "<nombre de archivo de salida>", "project": "<ruta absoluta al proyecto>", "lang": "bg", "voice": "Charon", "subtitles": ["bg", "en"], "theme": "neutral", "mode": "materials|code"} — project indica qué clave paga la voz; para "por código" además "product": "<repo>" y "role": "<rol>";
    • script.json — el guion (formato en scripts/lines.py); audio/, timeline.json, final/ se crean con los scripts;
    • sources/ — copia o extractos de los materiales de los que se escribió (extract.py los desglosa), y sources/facts.md — los hechos con su fuente.
  4. Guion. Las reglas para el texto están en reference/script.md (tono, duración, say, hechos). Muéstraselo a la persona como texto legible (por capítulos), no como JSON. Las correcciones — hasta que diga "bien". → aprobación 1.
  5. Coste. lines.py <carpeta>, luego cost.py <carpeta>; muestra la tabla. → aprobación 2.
  6. Muestra de voz. narrate.py <carpeta> --sample 3; dale a la persona las rutas a los tres .wav (o reprodúcelos: Mac open <archivo>, Windows start "" "<archivo>"). Si el tono no es bueno — cambia voice en video.json (pruebas de voces: tts.py --probe --voice <nombre>) y repite. → aprobación 3.
  7. Visión. Según el modo: 1–2 diapositivas (reference/materials.md) o fotograma de la grabación (reference/code.md). → aprobación 4.
  8. Voz completa. narrate.py <carpeta>. Al final imprime un informe; cada línea REDO <id>: … → narrate.py <carpeta> --only <id> …, hasta que no haya REDO (consulta reference/voice.md para las excepciones).
  9. Imagen. Según el modo — renderizado de las diapositivas o grabación de las pantallas; escribe timeline.json y final/<nombre>.mp4.
  10. Subtítulos. Traduce tú mismo text de cada réplica para cada idioma adicional en subs/<idioma>.json ({"<id>": "traducción"}): el mismo tono corporativo, números con dígitos, nombres como están en los materiales. Luego srt.py <carpeta> <nombre>.
  11. Verificación — reference/voice.md, "Verificación final". No digas "listo" antes de que pasen todos los puntos; lo que no haya pasado, dilo directamente.
  12. Entrega. Si la persona indicó una carpeta en Google Drive y hay un conector de Drive vinculado — súbelo con él; si no — la ruta a final/. Di brevemente: duración, idiomas, coste, qué queda sin verificar.

Tono — siempre

Profesional, corporativo, para colegas adultos — incluso cuando el producto es para niños. No infantil, no publicitario, no "explicación para principiantes". En detalle: reference/script.md. La voz no cambia entre réplicas: una sola voice, un solo estilo, una sola temperatura para todo el vídeo (reference/voice.md).

Skills relacionados