Communitygithub.com

Subtítulos Incrustados (Embedded Captions)

Añade subtítulos o leyendas a un video existente de una sola persona hablando sin editar el metraje original. Útil para subtítulos literales, subtítulos cinemáticos incrustados detrás del sujeto, subtítulos con efectos visuales (VFX), o una identidad con nombre del catálogo de 35 estilos.

¿Qué es Subtítulos Incrustados (Embedded Captions)?

Este skill de agente de IA traduce clips de una sola persona hablando en piezas pulidas con subtítulos incrustados (embebidos) usando un flujo de trabajo local de extremo a extremo. Soporta tres modos: **Estándar** (por defecto), que construye una barra de subtítulos literales en el tercio inferior de la pantalla y un momento cumbre incrustado detrás del sujeto; **Cinematográfico** (solo incrustados); y **Tema**, que combina bloques de diseño precompilados (como 'ordnance', 'terminal', 'neonsign') para looks de nivel VFX. El flujo de trabajo gestiona la transcripción, el enmascaramiento del sujeto y la composición de video automáticamente, prohibiendo modificar el metraje original. La elección del estilo visual se realiza desde un catálogo de 35 identidades, y el agente recomienda una al usuario antes de avanzar. Diseñado para plataformas como HyperOS y compatible con Claude Code, Cursor, Codex, entre otros.

Compatible con✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Elis3omndz/Claude_Skills/tree/HEAD/.claude/skills/embedded-captions

Preguntar en tu IA favorita

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

Documentación

Instalación de plugins: Antes de ejecutar comandos de configuración o actualización, siga las reglas de ejecución de plugins cuando este skill esté dentro de un plugin de HyperFrames. Las instalaciones independientes mantienen las instrucciones de actualización a continuación.

Primero, mantenga este skill actualizado — confirme con el usuario antes de ejecutar: npx hyperframes skills update embedded-captions. Es una operación rápida sin efectos cuando todo está al día; de lo contrario, actualiza este skill junto con los skills del dominio central de los que depende antes de usarlos.

Subtítulos Incrustados

Un único catálogo, elegido de antemano (CATALOG.md — 35 identidades; los motores detrás son detalles de implementación). Estándar (por defecto) construye una barra limpia de subtítulos literales (franja inferior que lleva la mayor parte del texto) + un clímax incrustado compuesto dentro de la escena detrás del sujeto en el punto álgido. Cinematográfico es puramente incrustado — sin barra, cada subtítulo compuesto detrás del sujeto (tipografía principal, acumulación, oclusión como efecto). Tema es una constitución temática completa — paradigma del cuerpo × pieza principal × efectos frontales × reacción de placa, compuesta a partir de registros (themes/README.md): ordnance terminal neonsign stardust stomp. La mayoría de videos explicativos / voz en off usan Estándar; el incrustado es el pico escaso y ganado — incrustar cada palabra es el error común; Tema es para solicitudes de nivel VFX ("炸", "特效", "como hecho en AE").


Requisitos previos de ejecución

Las instalaciones de plugin usan la CLI empaquetada con versiones fijadas en el manifiesto para enmascaramiento, transcripción y renderizado; no se necesita clonar el repositorio. Las ayudas de previsualización local y medición de subtítulos también necesitan Sharp, Puppeteer (con su navegador Chromium) y GSAP. Instálelos en el proyecto de subtítulos, no dentro del plugin de solo lectura:

npm install --prefix <proyecto> --save-dev --save-exact [email protected] [email protected] [email protected]

Mantenga el archivo de bloqueo del proyecto. Si estas dependencias ya existen, use sus versiones bloqueadas en lugar de sobrescribirlas. Bash y FFmpeg/ffprobe deben estar en PATH. El enmascaramiento y la transcripción pueden descargar sus propios modelos en el primer uso.

El renderizado espera a que la CLI termine correctamente antes de componer. El antiguo watchdog HF_TIMEOUT_S ya no se usa: un archivo parcial grande no es prueba de que el renderizado haya terminado. Un argumento explícito de checkout integrado o HYPERFRAMES_ROOT selecciona la CLI del contribuidor en lugar del pin del plugin. Cancele un renderizado estancado normalmente a través de la CLI/terminal; la ayuda de subtítulos no fuerza la terminación ni recupera un renderizado a partir de una instantánea del proceso.

Flujo operativo (resumen)

Enrutado a través de /hyperframes, la capa de intención confirma solo la entrada (qué clip) y anuncia la elección de identidad como una pregunta diferida — la lista corta necesita el clip analizado, por lo que se mantiene en el paso 1 a continuación; las preguntas de forma de ejecución de la capa no aplican (el metraje no está tocado, no hay guion gráfico que revisar). Un BRIEF.md, cuando está presente, contiene la entrada confirmada y cualquier nota del usuario — léalo primero.

El texto de trabajo a continuación es largo; el pipeline en sí es corto — y todo lo determinista se calcula o compila, nunca se escribe a mano:

  1. Puerta de decisión (rechazar clips malos) → elegir UNA identidad de CATALOG.md (35 identidades; motor/compilador derivado por búsqueda — nunca preguntar por modo/categoría)
  2. hyperframes init (omitirlo si el directorio del proyecto ya existe con el video dentro — matte.cjs/transcribe.cjs adoptan cualquier video en el directorio como source.mp4) → bash scripts/prepare.sh <proyecto> (enmascarado ∥ transcripción ∥ envolvente de audio en paralelo, luego zonas seguras v2 con paleta de escena/óptica/iluminación — un comando, nada olvidado)
  3. escribir un pequeño JSON de opciones creativas (leer safe-zones.json primero): Cinematográfico → cinematic.json → make-cinematic.cjs (deriva plan.json y lo compila); Tema → theme.json → make-theme.cjs (paradigmas de barra/panel/poema/toma de control; anchor es el valor predeterminado de barra discreta)
  4. Control de calidad visual: node scripts/preview-frames.cjs <proyecto> → previsualizaciones compuestas fieles en ~2s/fotograma (sin renderizar). Consulte § Control de calidad visual antes de pagar por un renderizado.
  5. render-and-composite.sh → compuertas (tiempo / oclusión+principal / desbordamiento / entrega) → final.mp4

Reglas importantes que la gente pasa por alto:

  • barra (predeterminado) + incrustado (promoción). drop (relleno, no mostrado) / barra (subtítulo literal en el tercio inferior, al frente, lleva la mayor parte del texto) / incrustado (una palabra cumbre compuesta detrás del sujeto). El modo estándar hace ambas, incrustando solo el(los) pico(s). Consulte § Modelo de subtítulos.
  • El video se entrega SIN TOCAR (Estándar/Cinematográfico; el presupuesto de PLACA del modo Tema es la única excepción sancionada — beats de reacción registrados (atenuación de carga, golpe, sacudida, granulado) definidos por ADN del tema y aplicados DESPUÉS de la composición del enmascarado para que sujeto+texto+placa se muevan como un solo fotograma) — los subtítulos son lo único que se añade; el enmascarado solo permite que el sujeto ocluya la pista incrustada. Nunca gradúe/recoloree/añada líneas de escaneo al metraje.
  • Dos manuales: barra → references/barra.md (breve), arte incrustado → references/composition-craft.md (extenso, solo incrustado). Consulte según sea necesario.

Modelo de subtítulos — barra + incrustado

Cada frase hablada es una de tres cosas:

Qué esCómo se muestra
droprelleno — em/eh, tartamudeos, autocorreccionesno se muestra
barrael predeterminado — contenido hablado ordinario (literal)subtítulo limpio en el tercio inferior, al frente, legible. Una palabra destacada puede tener un resaltado emphasis en línea (color de acento / destello de palabra activa) — permanece en la barra.
incrustadoun pico promocionado — el latido del titularuna palabra grande compuesta detrás del sujeto (oclusión por enmascarado), entrada + salida diseñadas

La barra lleva la mayor parte del texto; el incrustado es el pico escaso y ganado. La escasez es por latido/bloque, no por clip: ≤1 principal por bloque (pensamiento), nunca dos cocobertura, ≥ un latido de aire entre ventanas principales (el compilador advierte por debajo de 0.6s). Un clip corto → normalmente 1–2; un video explicativo largo → ~uno por sección. Entre varios principales, el más grande escrito es el APEX (solo él recibe el bloqueo completo incrustado + ajuste de ancho); los más pequeños son picos MENORES que viajan en su columna como líneas de énfasis sobredimensionadas (fg, movimiento amortiguado) — no todo latido necesita el escaparate del enmascarado, que es exactamente lo que mantiene el ápice como un evento. Incrustar cada palabra sigue siendo el error común.

Las identidades de superficie de barra construyen exactamente esto (barra = barra.html, incrustado = el clímax en index.html). Las identidades de flujo de columna eliminan la barra y hacen todo al estilo incrustado — recomiéndelas solo para solicitudes de ambiente sobre literalidad, nunca para videos explicativos / voz en off donde las palabras deben leerse (CATALOG.md codifica esto por identidad).


Paso 0 — elegir UNA identidad del CATÁLOGO

Un front-end, tres motores detrás. El usuario elige una IDENTIDAD de CATALOG.md (35 entradas: 10 clásicas + 25 temáticas); el motor, compilador y archivo de escritura se derivan por búsqueda de la fila del catálogo. Nunca presente "Estándar vs Cinematográfico vs Tema" como una pregunta — esos son nombres de backend (un producto tiene una UX incluso con varios motores). El catálogo codifica todo lo que necesita el enrutamiento: superficie de lectura, voz, recomendación para, necesidades de escena, notas de adyacencia para los pares realmente cercanos (loud↔ordnance, neon↔neonsign, cream↔stardust).

La elección de identidad es una puerta de preferencia (../hyperframes/references/brief-contract.md § 1): en modo autónomo ("sorpréndeme" / "decide por mí"), elija de su lista corta usted mismo y mencione el motivo en una línea en lugar de preguntar.

Procedimiento: analizar el clip → lista corta de 2–3 identidades del catálogo → recomendar UNA con un motivo de una línea → el usuario elige (modo autónomo: usted elige, indicando el motivo) → escribir el archivo de esa identidad. Las identidades están bloqueadas por motor (sin combinaciones cruzadas; abrir una es un evento de validación — consulte dna/README.md).

Siempre presente su recomendación y deje que el usuario elija antes de escribir. No tome un valor predeterminado en silencio.

(La tabla completa de identidades está en CATALOG.md — fuente única de verdad para el enrutamiento. Los documentos del motor a continuación describen el contrato de escritura de cada backend.)

CATALOG.md es todo el espacio de respuesta aquí: este flujo de trabajo no busca en el registro de componentes de HyperFrames. Los flujos de trabajo de composición ejecutan npx hyperframes catalog antes de escribir un look con nombre; este no debe hacerlo. Sus motores son compiladores bloqueados que consumen cinematic.json / theme.json y emiten la composición ellos mismos, por lo que un elemento del registro — los bloques caption-* incluidos — no tiene nada donde montarse. Un bloque de registro estiliza texto en un lienzo diseñado; este skill quema subtítulos en el metraje de alguien a través de un enmascarado. Cuando ninguna identidad se ajusta a la solicitud, dígalo y elija la más cercana, en lugar de buscar fuera del catálogo.

Heurística de recomendación: use las "Heurísticas de lista corta" en CATALOG.md — son a nivel de identidad (por ejemplo, "炸" lista corta ordnance/stomp/terminal/loud y elige por QUÉ debería explotar), nunca a nivel de categoría. No está seguro → anchor.

  • Cinematográfico → escribir cinematic.json para una plantilla bloqueada, compilada por make-cinematic.cjs.
  • Tema → leer themes/README.md, escribir theme.json, ejecutar scripts/render-theme.sh (compila + renderiza + reacción de placa → final_fx.mp4).

Puerta de decisión — EJECUTAR PRIMERO

Analice el video y clasifique la escena antes de cualquier modo.

ffprobe <video.mp4>                    # especificaciones
ffmpeg -ss <t> -i <video.mp4> -vframes 1 sample.png   # al 20/50/80%

Lea las muestras. Rechace si:

  • Múltiples hablantes / cortes duros (renderice cada toma por separado, o rechace)
  • Sin sujeto humano (este skill es para persona hablando)
  • Menos de 3 segundos, sin habla, o rostro nunca claramente visible — transcribe.cjs advierte cuando el audio está casi en silencio (Whisper alucina palabras como "Gracias." en silencio); hágalo caso y rechace en lugar de subtitular palabras fabricadas
  • La fuente ya tiene subtítulos / leyendas / gráficos de texto pesados quemados — añadir un segundo sistema de subtítulos genera conflicto y el metraje se entrega sin tocar (sin cubrir/inpaint). El texto quemado a menudo aparece solo a mitad del clip: tome una hoja de contactos a 1fps (ffmpeg -i in.mp4 -vf "fps=1,scale=160:-1,tile=10x5" sheet.png), no confíe en 3 fotogramas puntuales.
  • La transcripción es basura — el habla no nativa/con acento fuerte puede transcribirse como galimatías con confianza. Lea transcript.json críticamente antes de escribir; si no se interpreta como lenguaje, intente WHISPER_MODEL=medium una vez, de lo contrario rechace (una barra literal de palabras fabricadas es peor que ningún subtítulo).
  • Cámara en mano agitada con movimiento rápido (el enmascarado parpadea)

Pruebas previas al vuelo (no cuestan nada, previenen los peores fallos)

  1. Prueba de corte de toma. Muestree fotogramas al 20%, 50%, 80%. Si aparece un sujeto/escena diferente, recorte el clip antes del corte.
  2. Prueba de letterbox / pillarbox. ¿Barras negras en el primer fotograma? Calcule el rectángulo de contenido seguro y restrinja la colocación de subtítulos dentro de él.
  3. Prueba de luminancia. Muestree la luminancia promedio de la región de subtítulos — menos de 60 → el texto claro se lee tal cual, 60-180 → añada la cortina de glifo, 180+ → texto opaco + cortina (nunca texto claro desnudo). Las plantillas cinematográficas son crema+pantalla y BLOQUEADAS — use esta prueba para elegir una identidad adecuada (escenas brillantes → ink, o el tema anchor de barra opaca), nunca para recolorear una.
  4. Recomendación de identidad por tono (usted recomienda; el usuario elige — consulte Paso 0 + CATALOG.md). video explicativo / entrevista / palabras que deben leerse → identidades de superficie de barra/panel; poético / social / "cinematográfico" → identidades de flujo de columna por registro; "炸 / 特效 / VFX" / mundos con nombre → identidades temáticas. Cuando no esté seguro → anchor (las palabras se leen, la escena segura) — pero presente una lista corta y deje que el usuario elija.

Pipeline — 5 pasos

1. hyperframes init <proyecto> --non-interactive --video <video.mp4> --skill=embedded-captions
2. bash scripts/prepare.sh <proyecto>       # enmascarado ∥ transcripción (paralelo) → zonas seguras. Un comando.
                                           #   → frames_fg/ transcript.json safe-zones.json
3. [PASO DEL AGENTE — el único paso creativo] escribir un pequeño JSON; consulte a continuación según el modo
   Cinematográfico: escribir cinematic.json → node scripts/make-cinematic.cjs <proyecto>
   Tema:     escribir theme.json → bash scripts/render-theme.sh <proyecto>   (compila + renderiza + fx de placa)
4. node scripts/preview-frames.cjs <proyecto>   # ~2s/fotograma previsualizaciones compuestas → § Control de calidad visual (ANTES del renderizado)
5. bash scripts/render-and-composite.sh <proyecto>  # compuertas → final.mp4 + instantánea history/
   (Modo Tema: SALTAR pasos 3b/5 — render-theme.sh ya ejecuta compilar + render-and-composite
    + _postfx.sh; el entregable es final_fx.mp4, final.mp4 es previo a reacción de placa)

El init del paso 1 verifica los skills instalados contra los últimos en GitHub y actualiza el conjunto global si alguno está desactualizado.

El paso 3 difiere según el modo:

Paso 3 — Modo cinematográfico (solo incrustado)

  1. Leer safe-zones.json primero. Los planos de narración van en zones.hugLeft/hugRight — franjas limpias ADYACENTES a la silueta (el texto lejos del cuerpo se lee como flotante, no incrustado; las esquinas lejanas son el plan de respaldo, no el predeterminado). El héroe por defecto va a heroAnchor/heroBands.best (centrado EN el sujeto, ~30–55% ocluido). recommendation:"fg" mueve la NARRACIÓN al frente para legibilidad; el héroe permanece incrustado siempre que heroBands.feasible — héroe-fg es el último recurso.
  2. El ADN es la identidad que eligió en el Paso 0

Individual skills in this repo

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

Elis3omndz/Claude_Skills

Author or edit a custom HyperFrames composition when no specialized workflow fits, or when BRIEF.md sets flow: companion. Use for longer or multi-scene pieces, brand and sizzle reels, montages, static loops, static title cards, footage remixes, and freeform builds. Use motion-graphics instead for a short unnarrated motion-first unit, including an animated title. Route fresh creation through hyperframes before using this skill.

Elis3omndz/Claude_Skills

All animation knowledge for HyperFrames — atomic motion rules, multi-phase scene blueprints, scene transitions, broader motion-design techniques, AND the seven runtime adapters (GSAP default, plus Lottie, Three.js, Anime.js, CSS keyframes, Web Animations API, TypeGPU). Use for any motion or animation task: pick 2-4 rules and compose, or load a blueprint, or look up runtime-specific API (e.g. GSAP eases / Lottie player / Three.js mixer). Also covers auditing an existing composition's choreography (animation map) and 24 named text-animation effects. HyperFrames-native: single paused timeline, seek-safe, deterministic.

Elis3omndz/Claude_Skills

Use when audio already placed in a HyperFrames composition needs to be mixed: fade-in/fade-out, crossfade, track gain or volume, volume automation, ducking, a music bed that fights a voiceover (voiceover carve), effects on a track (EQ, compressor, limiter, gate, saturation, delay, reverb, chorus, phaser, bitcrush), automation envelopes drawn on a track's volume or any effect parameter, or one submix bus carrying a chain, a fader and an automation clock for several tracks at once (`<hf-audio-group>`). Don't use for sourcing or generating audio — finding BGM, SFX, or making a voiceover is `/media-use`. Don't use for clip timing or track layout, which is `/hyperframes-core`.

Elis3omndz/Claude_Skills

The HyperFrames composition contract — build one renderable project. Use for composition structure, the `data-*` timing attributes, `class="clip"`, tracks, sub-compositions, variables, framework-owned media playback, deterministic-render rules, and validation. Read before writing composition HTML.

Elis3omndz/Claude_Skills

Non-animation creative direction for HyperFrames videos. Use for design spec (frame.md / design.md) handling, palettes, typography, narration, beat planning, audio-reactive visuals, composition patterns, and brand / style decisions. For atomic motion patterns and scene blueprints, use `hyperframes-animation`.

Elis3omndz/Claude_Skills

Use when a HyperFrames composition needs a punch-in, punch-out, zoom, reframe, Ken Burns treatment, camera move, visual match/whip handoff, or other seek-safe 2D/3D keyframes; also for GSAP, CSS keyframes, Anime.js, WAAPI, FLIP, paths, masks, SVG morph/draw, text trails, 3D depth, or `hyperframes keyframes` diagnostics. Don't use for broad scene strategy, brand design, media sourcing, captions, or general video planning.

Elis3omndz/Claude_Skills

Use when working with a person on a HyperFrames project in Studio: first, whether their message asks for a change at all (questions, loose ideas and "don't change anything" get an answer and a plan, not an edit); for a new film, the plan, storyboard and build order that the HyperFrames launch films follow; and how the timeline should be laid out so it reads well (one caption track, one element kind per track, every scene a sub-composition) and where captions and key content may sit (safe zones). Don't use for how to perform an individual edit (split, trim, retime, volume, copy, swap): that is `creator-editing-recipes.md` in `/hyperframes-core`.

Elis3omndz/Claude_Skills

A short, design-led motion graphic where motion is the message — kinetic typography, stat count-up, chart/data-viz hit, logo sting / brand lockup, lower-third / callout / social overlay, animated map (highlight regions, connect places, zoom to a location), animated tweet / news-article / headline, webpage / UI animation (scroll, cursor, callouts), or fusing a real image's geometry into a chart. Usually under 10s (up to ~30s), no narration or live-action subject; renders to MP4 or transparent overlay. Longer / narrated / multi-scene → /general-video. Unclear → /hyperframes.

Elis3omndz/Claude_Skills

Turn a music track (an audio file, a video to pull audio from, or a track generated from a mood brief) into a beat-synced video — lyric video, slideshow, or kinetic promo. The music drives all pacing; any user-supplied images/videos are cut onto the same beat grid, and a complete video needs zero assets. Narrated pieces → the input-matched workflow (see /hyperframes). Unclear → /hyperframes.

Elis3omndz/Claude_Skills

Turn a product or marketing URL, pasted script, or brief into a product launch / promo video — SaaS promos, feature reveals, product demos, app and company launches. Use when the user wants to market, launch, promote, or reveal a product; the default for any commercial URL. Site tours / showcases of a website route here too — the brief carries the show-it-as-is intent. Unclear → /hyperframes.

Elis3omndz/Claude_Skills

Turn a GitHub pull request (a PR URL, owner/repo#N, or 'this PR' in a checked-out repo) into a code-change explainer video — changelog, feature reveal, fix, or refactor walkthrough built from the diff, commits, and files: the input is a code change, not a website. Not a product promo (/product-launch-video) or a no-PR topic explainer (/faceless-explainer). Unclear → /hyperframes.

Skills relacionados