Communitygithub.com

Generador de Cursos: Videos Explicativos Manuscritos

Crea videos explicativos narrados con dibujos a mano alzada y cursos de múltiples conferencias (pizarra negra, garabatos neón trazados trazo a trazo, escritura a mano aproximada, voz en off ~1.2x) a partir de un tema, un libro/PDF o una investigación. Úsalo cuando te pidan un video explicativo, una conferencia en video o un curso, o convertir un libro, PDF o notas en conferencias.

¿Qué es Generador de Cursos: Videos Explicativos Manuscritos?

Esta habilidad para agentes de IA permite generar cursos completos en formato de video explicativo manuscrito, similar al estilo de un instructor que dibuja con marcadores neón sobre una iPad negra. El proceso comienza con la investigación, continúa con la especificación de cada conferencia en un archivo `spec.js`, y automáticamente extrae el texto, genera voz sintética (TTS), crea animaciones de dibujo sincronizadas con la narración, y produce videos MP4 con subtítulos incrustados y archivos SRT. El estilo visual es no negociable: fondo negro, trazos con fuentes manuscritas y líneas irregulares (rough.js), colores neón con roles específicos (blanco para principal, verde para positivo, rojo para problemas, etc.), y un ritmo de narración cercano a 1.2x. Cada conferencia sigue una estructura pedagógica estricta: gancho inicial, marco conceptual (LAYERS), secciones con analogías, recapitulación y avance. La habilidad incluye herramientas para construir, probar (QA) y renderizar cada conferencia, utilizando colas para lotes grandes. Es compatible con cualquier proveedor de TTS que ofrezca una API compatible con OpenAI (configurable mediante variables de entorno). Los entregables son archivos ZIP con los videos y subtítulos numerados y con nombre descriptivo.

Compatible con✓Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/olatzbeitia-me/Agent-skills/tree/HEAD/course-generator-handwritten

Preguntar en tu IA favorita

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

Documentación

¿Qué hace Generador de Cursos: Videos Explicativos Manuscritos?

Salida: uno o más MP4 1920x1080 30fps H.264+AAC con subtítulos incrustados más archivos .srt, con estilo de alguien enseñando en un iPad negro con marcadores neón (estilo Caleb Eom). Cada conferencia se escribe como un spec.js compacto (narración + visuales juntos); el motor lo diseña, temporiza cada dibujo con la palabra hablada y lo renderiza.

research → spec.js por conferencia → build.sh (extraer → TTS → scenes.js) → qa.sh (fotogramas fijos) → arreglar → render_lecture.sh → zip + entregar

Reglas de estilo (no negociables)

  1. Ritmo ≈ 1.2x, nunca más rápido. Voces API: recortar silencios, luego ATEMPO=1.05 (voz expresiva) a 1.12 (voz lenta). 0.2s de pausa entre beats. 1.25x+ suena apresurado.
  2. Aspecto hecho a mano. Fuente Reenie Beanie con vibración por letra; líneas rough.js (roughness ≥1.4) más una ondulación SVG de turbulencia. Solo las tarjetas de evidencia "impresas" (tablas, números reales) son sans-serif limpias.
  3. Fondo negro, roles neón: w principal, g bueno/funciona, p problema/advertencia, v concepto, o acciones/analogías, y resaltados/números, b secundario, gr citas/comentarios.

Estructura pedagógica (cada conferencia)

  1. Gancho (20–40s): una situación relatable, luego un hecho sorprendente, luego una pregunta. Luego un beat de título que anticipa el marco.
  2. Marco (LAYERS, 3–7 elementos): la columna vertebral. Cada sección muestra una copia pequeña en la esquina superior derecha con su capa entre corchetes.
  3. Secciones: 1–3 beats cada una. Una idea y un visual por beat. Nombra las fuentes en voz alta y en gris en pantalla.
  4. Intuición: al menos una analogía por sección para cualquier cosa abstracta ("un detector de humo, no un cuerpo de bomberos"). Explica la jerga en palabras llanas inmediatamente.
  5. Recapitulación y lo que sigue: el marco, líneas marcadas, luego el título de la siguiente conferencia, para que un curso se encadene.

Voz: un compañero explicando mientras toma un café. Frases cortas, "Entonces,", "Y aquí está la cosa.", "¿Recuerdas la X?". Escribe los números como deben ser dichos ("veinte veintiséis", "uno punto siete segundos"). Evita símbolos en say.

Modo principiante (cuando se pida hacerlo comprensible para recién llegados): complementa la fuente con tu propia investigación web, agrega una analogía por concepto y reduce la densidad de ideas (~500–650 palabras por conferencia de 3–4 min).

Precisión

Busca en web cada número, fecha y nombre. Prefiere fuentes primarias. Mantén juntos los números de un mismo experimento. Etiqueta afirmaciones de proveedores ("números del proveedor: verificar"). Nunca inventes un ejemplo que un libro no haya dado; cita el propio del libro. Entrega una lista de Fuentes.

Configuración

Trabaja en ~/course, una copia de la carpeta engine/ de esta habilidad, para que los archivos de audio y video queden fuera de la carpeta de habilidades. Omite la copia si ~/course ya existe.

cp -r <carpeta de esta habilidad>/engine ~/course && cd ~/course   # ej. ~/.claude/skills/course-generator-handwritten/engine
npm i && npm run browsers        # Playwright + Chromium (necesita Node 20+)
pip install --break-system-packages soundfile numpy
cp .env.example .env             # completa TTS_* en .env (nunca lo subas)

ffmpeg debe estar instalado. Las carpetas de las conferencias (~/course/L02_Architecture/spec.js) están junto a los scripts; se puede llamar a los scripts desde cualquier directorio.

TTS es conectable (tts.py): cualquier POST /audio/speech compatible con OpenAI que devuelva response_format: "pcm" (24 kHz s16le). Configura TTS_URL, TTS_API_KEY, TTS_MODEL y TTS_VOICE mediante variables de entorno o .env. Elige una voz probando 2–3 voces en un beat y eligiendo la más expresiva (mayor variación de tono), no la primera. El audio se cachea por beat con un archivo de texto auxiliar, así que solo los beats editados se vuelven a vocalizar. Nunca codifiques claves o nombres de modelo en archivos subidos.

Escribir una conferencia: <Dir>/spec.js

const LECT = { label: 'Lecture 2 · behind the scenes', title: 'The Seven-Layer Architecture' };
const LAYERS = ['Channels + triggers', 'Gateway', 'Durable orchestrator', 'Agent loop'];
say({ hook: "…", title: "…", recap: "…", outro: "Next, …" });          // registro para beats de introducción/recapitulación
intro('S01_Intro', 'hook', 'title', [ items… ]);
section('S02_Gateway', 1 /*índice de capa*/, 'v' /*color*/, [
  { b: 'ga1', t: 'The front door', cite: 'Source, 2026', say: "Narration…", v: [ items… ] },
]);
recap('S06_Recap', 'recap', 'outro', ['line', 'line'], 'Next lecture title');

Cada beat tiene su propio panel y la cámara se desplaza entre paneles. El diseño escala automáticamente para ajustarse.

Elementos [type, ...args, opts?]:

tipoargs
big / textstr, colour, size
notestr, colour (comentario con flecha)
analogynull, str, 'o' (enmarcado "piensa en ello como…")
list`[lines], colour, {num
coltitle, colour, [lines] (usar dentro de row)
row[[item],[item]…], {vs, gap} (lado a lado)
flow[labels], [colours] (cajas con flechas)
stack[labels], {rh,size,w,cols,step}
tokens[words], colour, {step, cols} (ajuste de línea)
bars / hbars`[[label, value, colour, valueLabel]…], {h
eqstr, colour (número de titular subrayado)
cardtitle, rows[][], {w, hi:[rowIdx], hit:[time]} (tabla impresa; la fila 0 es el encabezado)
chart[[[x,y]…], colour, label]…], {h, xl, yl}
timeline / grid / gpus / people / downconsulta dsl.js

Opciones de temporización (último objeto): at: 'word' inicia el elemento cuando se pronuncia esa palabra (occ: 2 para la segunda aparición); times: [[beat, frac, 'f'], …] establece la temporización por partes como una fracción del beat; step escalona las partes. Los inicios se limitan para que el dibujo termine ≥2.6s antes de que termine el beat. Las claves de opciones permitidas están en la lista blanca de dsl.js (OPTK); una clave desconocida se trata como datos, así que agrega nuevas claves allí.

Construir, QA, renderizar

./build.sh L02_Architecture            # beats.json, TTS, scenes.js; imprime minutos de voz
./qa.sh L02_Architecture               # fotogramas fijos al final del beat en mosaico en L02_Architecture/qa/sheet*.jpg
./render_lecture.sh L02_Architecture "02 - The Seven-Layer Architecture"   # 2 carriles en paralelo → out/*.mp4 + .srt

Ejecuta QA en cada conferencia antes de renderizar y mira cada mosaico. Corrige:

  • etiquetas que desbordan las cajas (el motor reduce fuentes, pero las etiquetas largas aún necesitan acortarse);
  • un resaltado de tarjeta en la fila equivocada (cuenta el encabezado como fila 0);
  • contenido que sale del marco;
  • una palabra at que no existe (WORDMISS en el registro).

Para muchas conferencias, usa una cola: una bandera READY por directorio, un render a la vez, re-renderiza cuando scenes.js sea más reciente que el MP4. En la nube, las conferencias terminadas tardan entre 3 y 4 minutos cada una en renderizar. Los trabajos en segundo plano deben rastrearse con un arnés (no nohup en una VM que pueda dormirse).

Entregar

Comprime out/*.mp4 + *.srt con nombres de archivo numerados y etiquetados ("00 - Title.mp4"). En la respuesta proporciona una tabla de duración, una línea sobre el enfoque y Fuentes.

Ejemplos

examples/agents-L00-spec.js (conferencia conceptual) y examples/inference-B4-spec.js (conferencia con mucha evidencia) son especificaciones completas renderizadas para copiar.

Individual skills in this repo

This repo contains 4 individual skills — each has its own dedicated page.

field-marketing-event-strategy

Builds a researched, pipeline-led event strategy for a named company across named regions, covering which hosted events, trade shows, conferences and webinars to run or skip, why, and how to execute them (contracts, on-site, follow-up) with concrete pre- and post-event plays with sales. Use whenever the user names a company and asks which events it should attend, sponsor or host, or wants a field marketing plan, an event calendar or event budget for a region, trade show or conference selection, a webinar programme, or event follow-up with sales, even if they never say "strategy" or "field marketing".

gtm-automation-architect

Senior go-to-market automation architect and GTM engineer. Plans the vision, maps what goes where, designs, builds, tests and optimises GTM automation stacks and agentic workflows across Clay, Cargo, Outreach, HubSpot Breeze, Salesforce, n8n, Make, Zapier, Crossbeam, event platforms and AI agents. Use whenever the user wants to remove manual work from events, partner communications, product marketing, outbound, inbound routing or enrichment; decide which tool should own which job; design or debug a Clay table, Cargo play, Outreach Agent Studio workflow or n8n agent; build an automation roadmap for a company or growing programme; estimate or cut credit, Actions or execution spend; or test whether a workflow meets the business expectation — even if they never say "GTM engineering" or name a tool.

marketing-performance-audit

Audit a named company's marketing and demand generation from public evidence (ad libraries, organic social, website, search, press, reviews, events, job ads) and turn it into strategy for a given role and industry. Use whenever the user asks what a company is doing in marketing, wants a competitor teardown, is preparing an agency pitch, or is researching a company's marketing before an interview, even if they never say "audit".

martech-stack-audit

Audits a company's website to identify the marketing, sales and data tools behind it (advertising pixels, tag managers, analytics, marketing automation and email, CRM and lead-capture forms, chat, personalisation and A/B testing, reviews and loyalty, e-commerce, payments and subscriptions, consent management, CMS, hosting and CDN) and reports every tool with the evidence it was found in and a confidence rating of confirmed, likely or inferred. Use whenever the user gives a website URL or company domain and asks what tools, tech stack, martech, tracking, pixels, platforms or software it uses, wants a BuiltWith- or Wappalyzer-style lookup, or is researching a prospect, competitor, client or prospective employer's marketing set-up, even if they never say "audit".

Skills relacionados