Communitygithub.com

AlemTuzlak/skills

Úsalo cuando el usuario quiera transcribir un archivo de video o audio a texto con marcas de tiempo a nivel de palabra: inicia un servicio local autónomo de Whisper (whisper.cpp) en Docker incluido en esta habilidad y devuelve transcript.txt, transcript.srt y transcript.words.json con marcas a nivel de palabra. También se usa como componente básico de /produce-video. Se activa con frases como "transcribe este video", "obtén una transcripción", "transcribir-video".

¿Qué es skills?

Esta habilidad permite transcribir localmente cualquier archivo de video o audio utilizando un servicio whisper.cpp empaquetado, sin necesidad de proyectos externos ni APIs en la nube. Es especialmente útil para obtener transcripciones con marcas de tiempo a nivel de palabra, esenciales para superposiciones sincronizadas, subtítulos y edición de video. Funciona como un bloque de construcción para la habilidad `/produce-video`. El proceso está completamente automatizado mediante un runner que gestiona Docker: comprueba que Docker y ffmpeg estén disponibles, construye la imagen del servicio si es necesario, inicia el contenedor, extrae el audio en formato WAV mono a 16 kHz y lo envía al servicio de transcripción. Los resultados se guardan en tres archivos: texto plano, subtítulos SRT y un JSON con palabras y sus marcas de tiempo. El contenedor se mantiene activo para reutilización en caliente, y el runner falla de forma clara si falta Docker o ffmpeg. Soporta opciones como idioma, tarea (transcribir o traducir) y desactivación de marcas de tiempo por palabra.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/AlemTuzlak/skills/tree/HEAD/skills/transcribe-video

Preguntar en tu IA favorita

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

Documentación

Transcribir Video

Transcribe cualquier archivo de video/audio localmente usando un servicio whisper.cpp empaquetado. Sin proyectos externos ni API en la nube. Devuelve marcas de tiempo a nivel de palabra (necesarias para superposiciones/subtítulos sincronizados).

Cuándo usarlo

  • "Transcribe este clip / video / audio", "dame una transcripción con marcas de tiempo".
  • Como paso secundario de /produce-video.

Cómo se ejecuta

Todo está gestionado por el runner empaquetado: nunca le pidas al usuario que maneje Docker:

node scripts/transcribe.mjs <ruta-al-video-o-audio> [--out <dir>] [--port 9111] [--language es] [--no-word-ts] [--task transcribe|translate]
node scripts/transcribe.mjs --stop      # detener el contenedor activo

El runner:

  1. Verifica que el demonio de Docker sea accesible (falla con indicaciones claras si no lo es).
  2. Construye la imagen transcribe-video-whisper desde assets/whisper-service/ si falta (la primera compilación es lenta: compila whisper.cpp e incluye el modelo ggml-base.en.bin).
  3. Inicia el contenedor transcribe-video-whisper (puerto del host 9111 → contenedor 9001); lo reutiliza si ya está en ejecución, o lo inicia con docker start si está detenido.
  4. Espera a que GET /healthz responda correctamente.
  5. Extrae un WAV mono de 16 kHz de la entrada con ffmpeg local (whisper.cpp solo decodifica WAV), luego lo envía mediante POST a /transcribe con word_ts=true.
  6. Escribe transcript.txt, transcript.srt, transcript.words.json en --out (por defecto: el directorio del archivo de entrada) e imprime una línea de resultado JSON en stdout.

Salidas

  • transcript.txt — texto plano.
  • transcript.srt — texto de subtítulos.
  • transcript.words.json — [{ "word", "start", "end" }], en segundos, ordenados por tiempo. Es la fuente de sincronización para superposiciones/subtítulos.

Línea de resultado en stdout (para llamadas programáticas como /produce-video):

{ "ok": true, "outDir": "...", "wordCount": 38, "segmentCount": 2, "files": { "txt": "transcript.txt", "srt": "transcript.srt", "words": "transcript.words.json" } }

Requisitos

  • Docker es OBLIGATORIO — el servicio Whisper se ejecuta en un contenedor, por lo que Docker Desktop debe estar instalado Y en ejecución. El runner lo verifica primero y falla con indicaciones de instalación/inicio si Docker falta o su demonio está caído; no hay alternativa sin Docker.
  • ffmpeg es OBLIGATORIO (se usa para extraer un WAV mono de 16 kHz para Whisper) — el runner lo verifica al inicio y falla si no está en PATH.
  • Node ≥ 22.

Notas

  • El contenedor se deja en ejecución (--restart unless-stopped) para reutilización en caliente; se detiene con --stop.
  • Si se solicitan marcas de tiempo por palabra pero no se reciben, el runner falla de forma clara (la sincronización de superposiciones depende de ellas).
  • Consulta references/ para el ciclo de vida de Docker, la forma de la API y la procedencia de los archivos incluidos.

Individual skills in this repo

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

AlemTuzlak/skills

Use when the user wants to write a blog post about a feature, product change, PR, git diff, or any technical topic - accepts marketing briefs, PRs, git refs, codebase paths, or freeform descriptions as input

AlemTuzlak/skills

Use when the user wants to generate a changelog, release notes, or document what changed between versions, tags, or PRs

AlemTuzlak/skills

Use when writing, editing, or organizing documentation, when planning what docs a feature needs, and whenever planning or implementing a new feature or change in a repo (docs ship with the code). Also use when tempted to write docs without showing the discovered readers to the user, without asking for tone, or without loading simple-english and i-have-adhd. Triggers on "write docs for X", "document this feature", "add a guide", "update the docs", "reorganize the docs", "plan feature X", "implement X", or /docs.

AlemTuzlak/skills

Use when a bug is in play: a test fails, CI is red, an API returns the wrong result, a stack trace appears, or the user says it is broken or fix this. Don't use for a new feature with no failure, for types-only work, or for docs.

AlemTuzlak/skills

Use when the user invokes /i-have-adhd, says they have ADHD, or asks for ADHD-friendly output. Also used as a required writing filter by the docs skill. Don't use for marketing copy or after the user says "stop adhd mode" or "normal mode".

AlemTuzlak/skills

Use when a settled change must be turned into an ordered stack of small blocks before anyone implements. Don't use for unsettled intent, typos, comments, formatting, docs-only work, or writing the implementation itself.

AlemTuzlak/skills

Use when the user wants to write a product update email, feature announcement newsletter, or digest email for users or subscribers

AlemTuzlak/skills

Use when the user wants to turn a raw talking-head / screen-share recording into a finished, edited, annotated video plus a full content package. Removes silences, flags mistakes for the user to cut, transcribes, adds transcript-synced overlays (code, on-screen code highlights, word highlights, lists, comparisons, diagrams, section labels, punch-in zooms), renders with original audio, then generates blog/socials/YouTube content. Triggers on "produce a video", "edit my video", "annotate my recording", "/produce-video".

AlemTuzlak/skills

Use when the user runs /prove-it or says prove it, prove the changes, show me in the browser, or asks to prove a UI or API change. Don't use only because the agent is about to say done, for types-only work, or for docs with no behavior to prove.

AlemTuzlak/skills

Use when the user wants to write, draft, or author an RFC (Request for Comments) / technical design doc for a feature, change, or architectural decision. Interactively interviews the user, grounds the proposal in the actual codebase, presents 2-3 concrete API/code-snippet approaches to choose from, then writes a review-ready RFC. Triggers on "write an RFC", "draft an RFC", "RFC for X", "design doc for X", or /rfc.

AlemTuzlak/skills

Use when the user wants to deeply learn a new topic from scratch. Runs a pre-interview (current knowledge, end-goal proficiency, depth, practice load, background, scope), researches online (articles, niche-influencer blogs, canonical docs, subtopic landscape), then produces a structured markdown course with mandatory visual diagrams, evidence-based learning-science features (retrieval practice, spaced callbacks, worked-example fading, concept ledger, jargon gate, analogy hygiene), and a self-contained interactive HTML mini-course. Triggers on /teach-me, "teach me about X", "I want to learn X", "deep dive on X", "create a course on X", "study X with me".

AlemTuzlak/skills

Use when the change intent is already settled and the agent must map what a behavior change touches before an implementation plan or any code. Use for new features, bug fixes, and refactors that move a boundary. Don't use for typos, comments, formatting, lockfile-only diffs, docs with no code, or while the user is still deciding what they want.

AlemTuzlak/skills

Use when the user wants to write a video script for a product demo, feature walkthrough, launch video, or social media video about a feature or product change

AlemTuzlak/skills

Use when the user wants YouTube metadata for a video — a click-worthy title, an SEO/above-the-fold description, tags, and timestamped chapters. Accepts a transcript (ideally timestamped SRT), a topic, a PR, or a freeform description. Used standalone and by /produce-video. Triggers on "youtube title", "youtube description", "youtube chapters", "youtube tags", "youtube metadata", "youtube-copy".

Skills relacionados