Communitygithub.com

AlemTuzlak/skills

Úsalo cuando el usuario quiera convertir una grabación en bruto (talking-head o pantalla compartida) en un video terminado, editado y anotado, más un paquete completo de contenido. Elimina silencios, marca errores para que el usuario los corte, transcribe, añade superposiciones sincronizadas con la transcripción (código, resaltados de código en pantalla, resaltados de palabras, listas, comparaciones, diagramas, etiquetas de sección, zooms de enfoque), renderiza con el audio original y luego genera contenido para blog, redes sociales y YouTube. Se activa con frases como "produce un video", "edita mi video", "anota mi grabación", "/produce-video".

¿Qué es skills?

Esta habilidad automatiza el proceso de postproducción de videos de tipo talking-head o screencast, transformando una grabación en bruto en un video pulido con superposiciones dinámicas y un paquete de contenido listo para publicar. Su flujo de trabajo es modular y se basa en habilidades auxiliares especializadas para edición, transcripción y composición. El proceso comienza con la desilenciación sin pérdida de calidad, seguido de una revisión visual de errores donde el agente genera una vista previa del video con marcadores para que el usuario decida qué cortar o acelerar. Luego, se transcribe el video final editado y se detectan puntos de activación para superposiciones visuales (código, resaltados, diagramas), todo ello orquestado con HyperFrames y GSAP. La renderización final se realiza solo con una orden explícita del usuario, y el contenido promocional se delega a otras habilidades. La calidad es primordial: todos los pasos de edición preservan la calidad original mediante CRF 12, evitando re-codificaciones que degraden el video. La habilidad está diseñada para Claude Code y entornos similares, utilizando herramientas como auto-editor, ffmpeg, Docker y HyperFrames CLI.

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

Preguntar en tu IA favorita

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

Documentación

Producir Video

Toma una grabación proporcionada por el usuario y conviértela en un video terminado. La grabación es la columna vertebral y marca la línea de tiempo; esta habilidad edita (silencio + errores/ritmo elegidos) y aumenta (superposiciones), luego renderiza y genera contenido de lanzamiento. NO crea un video sintético (para promos sintéticas impulsadas por PR, usa hyperframes-video en su lugar).

Principio de calidad (no negociable): cada paso de edición preserva la calidad original. Nunca permitas que una herramienta recodifique el metraje con baja calidad. La desilenciación y los cortes se ejecutan con CRF 12 casi sin pérdida a partir del original (auto-editor se usa solo para DETECTAR silencio, nunca para codificar; su valor por defecto aplasta el metraje a ~0.6 Mbps), y el renderizado se ejecuta con CRF 12. CRF produce archivos pequeños para screencasts estáticos; eso es calidad completa, no pérdida.

Relación con otras habilidades (delegar, no re-derivar)

  • /transcribe-video — toda la transcripción (devuelve transcript.words.json a nivel de palabra. Invócala; no transcribas manualmente.
  • hyperframes — reglas de autoría de composiciones (Puerta de Identidad Visual, Diseño Antes de Animación, contrato de línea de tiempo, capas de video/superposición). Invócala antes de escribir/montar cualquier HTML de composición.
  • hyperframes-cli — todos los comandos npx hyperframes (init, lint, inspect, preview, render).
  • gsap — patrones de línea de tiempo/easing de GSAP para superposiciones.
  • youtube-copy — título/descripción/etiquetas/capítulos de YouTube (P6).
  • blog-post — la entrada de blog (P6).
  • social-copy — copia para X/Bluesky/LinkedIn/Reddit (P6).

Activos incluidos

  • scripts/desilence.mjs — eliminación de silencios con auto-editor + duración antes/después.
  • scripts/extract-frame.mjs — captura de un solo fotograma (detección de encuadre + resaltado en pantalla).
  • scripts/bake-cuts.mjs — cortador de recorte/concatenación con ffmpeg (keyframes densos) usado en P2.
  • templates/overlays/*.html — 9 plantillas de sub-composición de superposiciones (rellenadas por instancia; las sub-comps son documentos HTML independientes en la CLI instalada — lee el comentario de cabecera de cada archivo).
  • templates/project/{DESIGN.md,styles.css} — Puerta de Identidad Visual + tokens de marca var(--brand-*) que consumen las superposiciones.
  • references/ — mistake-detection.md, overlay-triggers.md, framing-safe-zones.md, frame-analysis.md.
  • La generación de contenido P6 se delega a las habilidades youtube-copy, blog-post y social-copy (sin script LLM propio).

Puertas (no negociables)

  1. La revisión de errores P2 es VISUAL, nunca terminal — siempre que exista ≥1 bandera, el agente SIEMPRE construye la vista previa de marcadores de hyperframes (marcadores en el video en cada tramo marcado) y la abre, para que el usuario decida viendo. NO presentes las banderas como una tabla terminal/pregunta para que el usuario decida, y NO hagas la vista previa opcional ni preguntes "¿quieres que te lo muestre?" — simplemente constrúyela y ábrela. Un breve resumen terminal de las banderas está bien, pero la superficie de decisión es la vista previa. Nunca apliques automáticamente un corte/aceleración.
  2. Aprobación del plan de superposiciones P4 — presenta la tabla de superposiciones con marcas de tiempo; no se construye hasta que esté aprobada.
  3. La vista previa siempre es lanzada por el agente — tanto para la revisión P2 como para la revisión P5, el agente inicia npx hyperframes preview y abre la pestaña del navegador. NUNCA pidas al usuario que ejecute la vista previa o abra una URL, y NUNCA sustituyas un resumen solo de terminal por la vista previa en vivo.
  4. BLOQUEO EXPLÍCITO de renderizado — el renderizado se ejecuta SOLO con una orden explícita del usuario ("render", "adelante"). Después de un renderizado, las solicitudes de edición vuelven al bucle de vista previa y NO se vuelven a renderizar hasta que el usuario lo diga explícitamente de nuevo. Cada renderizado necesita su propia orden nueva. Esto anula cualquier frase tipo "usa valores sensatos por defecto / no interactivo / simplemente hazlo".

"Usa valores sensatos por defecto" / "no hagas preguntas" omite las preguntas de configuración (P0) y la indicación de iteración — NUNCA omite las puertas de aprobación, la vista previa lanzada por el agente o la puerta de renderizado explícito.

Proceso

Pre-vuelo — verificar dependencias y habilidades (ejecutar PRIMERO, antes de P0)

Verifica el entorno antes de hacer cualquier trabajo; advierte al usuario sobre cualquier cosa que falte y cómo solucionarlo.

  • auto-editor (requerido para desilenciación P1): ejecuta auto-editor --version. Si no está instalado, DETENTE y dile al usuario: "auto-editor no está instalado - instálalo con pipx install auto-editor (o pip install auto-editor), luego vuelve a ejecutar." No intentes P1 sin él.
  • ffmpeg / ffprobe (REQUERIDO — cortes P2, análisis de fotogramas P4, renderizado P5, audio): ejecuta ffmpeg -version. Si falta, DETENTE y dile al usuario que instale ffmpeg y lo añada al PATH. El pipeline no puede funcionar sin él.
  • Docker (para /transcribe-video): docker info. Advierte si el demonio está caído (inicia Docker Desktop).
  • Node >= 22: node --version. Advierte si es más antiguo.
  • Habilidades requeridas — confirma que están disponibles (intenta invocar / verifica la lista de habilidades); advierte sobre cualquier falta y qué fase bloquea:
    • transcribe-video (transcripción P2/P3), hyperframes + hyperframes-cli + gsap (composición y renderizado P2/P4/P5), youtube-copy + social-copy (P6). blog-post solo si el usuario opta por un blog (P6, opcional).
  • Resume el resultado del pre-vuelo en un bloque corto (qué está presente, qué falta). Solo continúa si falta una dependencia/habilidad requerida si el usuario dice explícitamente que continúe sin ella (y anota el resultado degradado).

P0 — Entrada y configuración

  • Entrada: ruta a la grabación en bruto (requerida).
  • Opcional: un repositorio/archivos para fundamento de código real; estilo visual/marca (si no, ejecuta la Puerta de Identidad Visual de hyperframes — detecta desde el repositorio, si no, haz 3 preguntas de estilo; escribe templates/project/DESIGN.md + valores de marca en styles.css); densidad de superposición (escasa / equilibrada / rica).
  • Carpeta de salida única (<OUT>): todo lo que produce esta habilidad vive bajo UNA carpeta, por defecto <directorio-grabación>/<slug-video>-produced/ (se puede sobrescribir con una ruta proporcionada por el usuario). Créala ahora. Estructura final:
    <OUT>/
      final.mp4                 # video renderizado (P5)
      hyperframes/              # el proyecto HyperFrames: index.html, styles.css, DESIGN.md, compositions/, renders/ (P4–P5)
      transcript.txt            # transcripción final editada (P3 / P6)
      transcript.srt
      transcript.words.json
      youtube.md                # P6
      socials.md                # P6
      blog.md                   # P6
      .work/                    # intermedios: 01_desilenced.mp4, 02_edit_N.mp4, frames/ (eliminables en P7)
    
    Todas las fases posteriores escriben dentro de <OUT> — nunca disperses salidas en otro lugar. <work> abajo = <OUT>/.work.

P1 — Desilenciación (sin pérdida)

node scripts/desilence.mjs <input> --out <work>/01_desilenced.mp4 --margin 0.3s

desilence.mjs usa auto-editor SOLO para detectar los rangos de silencio (--export v3), luego corta el ORIGINAL con ffmpeg a CRF 12 casi sin pérdida, manteniendo el audio original. NO permitas que auto-editor codifique la salida — su recodificación por defecto aplasta el metraje a ~0.6 Mbps y lo desenfoca permanentemente (los rostros especialmente); ningún bitrate posterior puede recuperarlo. Informa la duración antes/después y los segundos eliminados. Esta se convierte en la copia de trabajo.

P2 — Bucle de revisión de errores y ritmo (puerta de aprobación)

  1. Transcribe la copia de trabajo: invoca /transcribe-video en <work>/01_desilenced.mp4 con --out <work> → transcripción de trabajo (intermedia; reemplazada por la transcripción final P3).
  2. Detecta banderas según references/mistake-detection.md (cortes + aceleraciones), ajustadas a los límites de palabras.
  3. Siempre (cuando exista ≥1 bandera) construye la revisión visual. Crea un proyecto hyperframes ligero con el video desilenciado como pista base; coloca marcadores temporales visualmente distintos EN EL VIDEO en cada tramo marcado (corte = raya roja, aceleración = avance rápido ámbar, cada uno etiquetado con el extracto + su índice). El agente inicia npx hyperframes preview y abre el navegador él mismo (según references/framing-safe-zones.md). Esta es la superficie de decisión — nunca la reemplaces con una tabla terminal. Una nota terminal de una línea ("3 banderas marcadas en la vista previa — revísalas y dime cuáles cortar/acelerar/mantener") es lo máximo que la terminal debe llevar.
  4. El usuario ve la vista previa marcada y elige por tramo: cortar / acelerar (factor, por defecto ~1.5–2×) / dejar / añadir sus propios rangos.
  5. Aplica las selecciones → <work>/02_edit_N.mp4, luego vuelve a previsualizar:
    • Cortes: usa node scripts/bake-cuts.mjs <input> --out <work>/02_edit_N.mp4 --cut s,e --cut s,e … (recorte/concatenación con ffmpeg a CRF 12 casi sin pérdida por defecto — recorta video+audio de forma idéntica en una sola pasada). NO uses auto-editor --cut-out para los cortes de errores — su argumento variádico asigna incorrectamente el último rango como entrada posicional, recodifica con pérdida y un enfoque de filtro select desincroniza el audio.
    • Aceleraciones: auto-editor --set-speed-for-range velocidad,s,e (tono preservado); pasa UN rango por invocación, o coloca --set-speed-for-range al final de la línea de comandos, para evitar el mismo problema de argumento variádico.
    • Todas las marcas de tiempo de corte/aceleración están en la línea de tiempo desilenciada (la transcripción de la que provinieron las banderas). Aplica cortes y aceleraciones en la misma ronda contra esa línea de tiempo.
  6. Itera hasta que el usuario diga "listo". Protección contra deriva: después de ~10 rondas, ofrece restablecer a un intermedio anterior. Artefacto final: <work>/final_cut.mp4.

Los cortes y aceleraciones se integran en el metraje AQUÍ (antes de P3), para que las marcas de tiempo de las palabras de la transcripción final coincidan con la línea de tiempo editada.

P3 — Transcripción final

Invoca /transcribe-video en <work>/final_cut.mp4 con --out <OUT> para que transcript.txt / transcript.srt / transcript.words.json aterricen en la parte superior de la carpeta de salida. Esta transcripción con marcas de tiempo de palabras es la fuente de sincronización para todas las superposiciones (P4) y la entrada para la generación de contenido (P6).

P4 — Diseño y construcción de superposiciones (puerta de aprobación)

  1. Detección de encuadre (references/framing-safe-zones.md): muestrea fotogramas con extract-frame.mjs, clasifica fases, confirma fases + zonas seguras con el usuario.
  2. Detección de activadores de superposición (references/overlay-triggers.md): escanea la transcripción con marcas de tiempo de palabras → filas del plan de superposiciones {inicio, duración_est, tipo, contenido, zona_segura, porqué}. Para código en pantalla, usa references/frame-analysis.md (extraer fotograma → localizar → caja normalizada → guardia de estabilidad). Para tarjetas de código, repo-si-disponible-sino-sintetizar (marca sintetizado).
  3. Paso de auto-mejora (≥2 iteraciones): respeta la densidad, aplica mínimos de separación y permanencia, valida cada superposición contra la zona segura de la fase activa.
  4. Puerta de aprobación: presenta la tabla con marcas de tiempo; el usuario edita/elimina/retemporiza/añade. El código sintetizado se muestra para verificación. No se construye hasta que esté aprobado.
  5. Construcción (invoca hyperframes + gsap primero):
    • npx hyperframes init <OUT>/hyperframes --video <OUT>/.work/final_cut.mp4 (el proyecto vive en <OUT>/hyperframes; base: pista de video 0 muted playsinline; audio en una pista separada con volumen 1 para que se escuche la voz). Lee el index.html generado para aprender la sintaxis de inclusión de sub-composición de esta versión de la CLI.
    • Copia templates/project/styles.css (con los valores de marca confirmados) en <OUT>/hyperframes.
    • Para cada fila aprobada: crea una instancia de la templates/overlays/*.html correspondiente, asígnale un id de composición único + data-composition-id, rellena sus {{tokens}}, establece data-start = la marca de tiempo de la transcripción y data-duration = la duración de permanencia, móntala sobre el video. Los zooms de enfoque escalan el div ENVOLTORIO del video (nunca el <video>).
    • Las dimensiones de salida heredan la grabación original.
    • Legibilidad (no negociable): todo el texto de las superposiciones debe ser claramente legible sobre CUALQUIER fondo de video. Cada grupo de texto descansa sobre un panel oscuro casi opaco (rgba(8,10,14,0.92), redondeado, borde/sombra sutil); los títulos/cuerpo son blancos (var(--brand-text)), el texto secundario/kicker/meta es pizarra clara (#CBD5E1). NUNCA uses var(--brand-accent)/var(--brand-primary) para texto de cuerpo/subtítulo/kicker — el acento es para barras, bordes, barridos de marcador, iconos y solo palabras grandes de visualización (y solo cuando superan ~4.5:1 en el panel). En caso de duda, haz el texto blanco. npx hyperframes validate (contraste WCAG) debe pasar sin advertencias de contraste.

P5 — Vista previa y renderizado (vista previa obligatoria lanzada por el agente + puerta de renderizado explícito)

  • npx hyperframes lint + npx hyperframes inspect (desbordamiento + zonas seguras) + npx hyperframes validate (contraste). Corrige hasta que esté limpio.
  • El agente inicia npx hyperframes preview y abre el navegador. Bucle de iteración libre sobre superposiciones.
  • Auditorías previas al renderizado: cada superposición en su zona segura de fase; mínimos de permanencia; no dos superposiciones luchando por la misma región simultáneamente; lint/inspect/validate limpios.
  • Solo con la orden explícita de renderizado del usuario: renderiza a CRF 12 casi sin pérdida. La calidad standard por defecto codifica a ~1.4 Mbps y aplasta visiblemente el metraje; pasa siempre un CRF bajo:
    npx hyperframes render --output <OUT>/final.mp4 --crf 12
    
    (ejecutar desde <OUT>/hyperframes. CRF 12 es casi sin pérdida; NO uses --video-bitrate esperando un archivo grande — para screencasts estáticos CRF produce un archivo pequeño con calidad completa, y eso es correcto, no baja calidad). El mp4 final mantiene el audio original. Después del renderizado, las ediciones posteriores vuelven al bucle y requieren una nueva orden explícita de renderizado.
  • Nota de calidad: la captura de Chrome es una captura de pantalla 1:1 sin pérdida (verificado: entrada del renderizado == salida tanto para texto como para rostros), por lo que un renderizado con CRF bajo preserva el metraje que se le da. Lo ÚNICO que destruye la calidad es un paso ascendente con pérdida — por eso la desilenciación P1 y los cortes P2 se ejecutan a CRF 12 casi sin pérdida desde el original. No añadas pasadas de recodificación extra. Para metraje de cero generaciones absoluto, una ruta avanzada es renderizar solo superposiciones a un --format webm/mov transparente y componerlas con ffmpeg sobre el metraje cortado (el zoom de enfoque se aplica entonces mediante ffmpeg) — raramente necesario.

P6 — Generación de contenido (delegada a habilidades especializadas)

Genera el contenido de lanzamiento invocando habilidades dedicadas, cada una sobre la transcripción final editada (P3 — pasa el transcript.srt con marcas de tiempo para que los capítulos de YouTube tengan tiempos precisos), escribiendo cada salida en <OUT>:

  • youtube-copy → <OUT>/youtube.md (título, descripción, etiquetas, capítulos de YouTube).
  • social-copy → <OUT>/socials.md (copias para X, Bluesky, LinkedIn, Reddit).
  • blog-post → <OUT>/blog.md (solo si el usuario optó por un blog).

Después de P6, el usuario puede pedir refinamientos (regresar al bucle correspondiente).

P7 — Limpieza (opcional)

Si el usuario lo solicita o el espacio es escaso, elimina <OUT>/.work/ (todos los intermedios pueden regenerarse). No elimines nada más.

Variables de entorno

Ninguna requerida. El agente usa la configuración de PATH/CLI del sistema.

Registro & depuración

Sin requisitos especiales. Usa las herramientas estándar del agente.

Nota de implementación

Sigue esta especificación exactamente.

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 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 transcribe a video or audio file to text with word-level timestamps — spins up a self-contained local Whisper (whisper.cpp) Docker service bundled in this skill and returns transcript.txt, transcript.srt, and word-level transcript.words.json. Also used as a building block by /produce-video. Triggers on "transcribe this video", "get a transcript", "transcribe-video".

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