Обучително видео
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
- Guion (el texto de las réplicas y el plan de las diapositivas/pantallas).
- Coste — la tabla de
cost.py. Las muestras pequeñas (hasta 3–4 réplicas) no requieren aprobación, la locución completa sí. - Muestra de voz — las primeras 3 réplicas (
narrate.py --sample 3); la persona las escucha. - Visión — 1–2 diapositivas terminadas o fotogramas de la grabación, antes del renderizado completo.
Paso a paso
- 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 quedoctor.pyda para ese sistema (brew / winget); para el renderizadonpm cien${CLAUDE_PLUGIN_ROOT}, si Claude Code no lo ha hecho, ynpx 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 loginyGOOGLE_CLOUD_PROJECT);GEMINI_API_KEYen el entorno vale para todos los proyectos — solo para CI.
- 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.mden él significa que el producto está preparado para vídeo). - Hay PDF, y
doctor.pydice "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 dedoctor.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).
- 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 (
- 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>/(~/Documentsen 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"}—projectindica qué clave paga la voz; para "por código" además"product": "<repo>"y"role": "<rol>";script.json— el guion (formato enscripts/lines.py);audio/,timeline.json,final/se crean con los scripts;sources/— copia o extractos de los materiales de los que se escribió (extract.pylos desglosa), ysources/facts.md— los hechos con su fuente.
- 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. - Coste.
lines.py <carpeta>, luegocost.py <carpeta>; muestra la tabla. → aprobación 2. - Muestra de voz.
narrate.py <carpeta> --sample 3; dale a la persona las rutas a los tres.wav(o reprodúcelos: Macopen <archivo>, Windowsstart "" "<archivo>"). Si el tono no es bueno — cambiavoiceenvideo.json(pruebas de voces:tts.py --probe --voice <nombre>) y repite. → aprobación 3. - Visión. Según el modo: 1–2 diapositivas (
reference/materials.md) o fotograma de la grabación (reference/code.md). → aprobación 4. - Voz completa.
narrate.py <carpeta>. Al final imprime un informe; cada líneaREDO <id>: …→narrate.py <carpeta> --only <id> …, hasta que no hayaREDO(consultareference/voice.mdpara las excepciones). - Imagen. Según el modo — renderizado de las diapositivas o grabación de las pantallas; escribe
timeline.jsonyfinal/<nombre>.mp4. - Subtítulos. Traduce tú mismo
textde cada réplica para cada idioma adicional ensubs/<idioma>.json({"<id>": "traducción"}): el mismo tono corporativo, números con dígitos, nombres como están en los materiales. Luegosrt.py <carpeta> <nombre>. - 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. - 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).