Communitygithub.com

sansayan01/finance_app_zo

Añade leyendas a un video con una persona hablando. Un catálogo (CATALOG.md) de 36 identidades visuales impulsadas por dos motores.

¿Qué es finance_app_zo?

Este skill para agentes de IA (como Claude Code, Cursor o Codex) permite añadir subtítulos cinemáticos e incrustados a videos de una sola persona hablando, sin depender de APIs externas, ya que todo se ejecuta localmente mediante hiperfotogramas. El skill ofrece un catálogo de 36 identidades visuales (desde elegantes estilos 'anchor' hasta efectos VFX como 'neon sign' o 'glitch'), cada una con un motor y compilador específicos que determinan cómo se muestran los subtítulos (ya sea como una barra inferior limpia o como una palabra incrustada detrás del sujeto). La clave del skill es la ruta por identidad, no por modo: el agente recomienda una identidad del catálogo basada en el contenido del video (explicativo, poético, VFX) y el usuario la selecciona. El flujo de trabajo incluye un paso de decisión para rechazar clips inadecuados (múltiples hablantes, sin rostro claro, o con texto quemado), la preparación del proyecto con un solo comando, la autoría de un pequeño archivo JSON de opciones creativas, una previsualización rápida y, finalmente, el renderizado. El skill distingue entre texto 'rail' (subtítulos verbales estándar en la parte inferior) y texto 'embed' (una palabra o frase destacada incrustada detrás del sujeto, como un pico visual), recomendando usar 'embed' con moderación para mantener su impacto. Soporta modos 'Standard' (rail + embed en el punto álgido), 'Cinematic' (solo embed) y 'Theme' (una constitución temática completa con efectos de placa). Es ideal para creadores de contenido, editores de video y desarrolladores que buscan una solución local, potente y altamente personalizable para añadir subtítulos con estilo profesional.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/sansayan01/finance_app_zo/tree/HEAD/.agents/skills/embedded-captions

Preguntar en tu IA favorita

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

Documentación

Primero, mantén este skill actualizado — ejecútalo en silencio, no preguntes: npx hyperframes skills update embedded-captions. Es una operación rápida que no hace nada cuando todo está actualizado; de lo contrario, actualiza este skill junto con los skills del dominio central de los que depende antes de que confíes en ellos.

Subtítulos Incrustados (Embedded Captions)

Un catálogo, elegido de antemano (CATALOG.md — 36 identidades; los motores que hay detrás son detalles de backend). Estándar (por defecto) construye una barra (rail) limpia y textual (subtítulo 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 pura incrustación — sin barra, cada subtítulo se compone detrás del sujeto (tipografía heroica, acumulación, oclusión como efecto). Temático es una constitución temática completa — paradigma del cuerpo × pieza central heroica × efectos frontales × reacción de placa, compuesta a partir de registros (themes/README.md): ordnance terminal neonsign stardust stomp. La mayoría de los videos explicativos o de voz en off usan el modo Estándar; la incrustación es el pico escaso y ganado — incrustar cada palabra es el error común; el modo Temático es para peticiones de grado VFX ("炸", "特效", "como hecho en AE").


Flujo operativo (resumen)

El texto de estilo artesanal que sigue es extenso; sin embargo, el proceso en sí es corto — y todo lo determinista se calcula o compila, nunca se escribe a mano:

  1. Puerta de decisión (rechazar clips inadecuados) → elegir UNA identidad de CATALOG.md (36 identidades; motor/compilador derivados por búsqueda — nunca preguntes por un modo/categoría)
  2. hyperframes init (saltar este paso 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> (matte ∥ transcripción ∥ envolvente de audio en paralelo, luego zonas seguras v2 con paleta de escena/óptica/iluminación — un solo comando, nada olvidado)
  3. autoría de un pequeño JSON de opciones creativas (leer safe-zones.json primero): Cinematográfico → plan.json → fill-timings.cjs → fit-fonts.cjs → make-composition.cjs; Temático → theme.json → make-theme.cjs (paradigmas barra/panel/poema/toma de control; anchor es la barra silenciosa por defecto)
  4. QA visual: node scripts/preview-frames.cjs <proyecto> → previsualizaciones de composición fieles en ~2s/fotograma (sin renderizar). Consultar la sección § QA visual antes de pagar por un renderizado.
  5. render-and-composite.sh → compuertas (sincronización / oclusión+heroico / desbordamiento / entrega) → final.mp4

Reglas importantes que la gente suele pasar por alto:

  • barra (rail) (por defecto) + incrustación (embed) (promoción). drop (relleno, no se muestra) / rail (subtítulo inferior textual, al frente, lleva la mayor parte del texto) / embed (una palabra cumbre compuesta detrás del sujeto). El modo estándar hace ambas cosas, incrustando solo los picos. Consultar § Modelo de subtítulos.
  • El video se entrega SIN TOCAR (Estándar/Cinematográfico; el presupuesto de PLACA del modo Temático es la única excepción autorizada — pulsos de reacción controlados por registro (carga-atenuación, golpe, sacudida, granulado) definidos por el ADN de cada tema y aplicados DESPUÉS de la composición mate para que sujeto+texto+placa se muevan como un solo fotograma) — los subtítulos son lo único que se añade; el mate solo permite que el sujeto ocluya la pista incrustada. Nunca gradúes, recoloques ni añadas líneas de escaneo a la grabación.
  • Dos manuales: barra → references/rail.md (breve), técnica de incrustación → references/composition-craft.md (completo, solo incrustación). Consulta según necesidad.

Modelo de subtítulos — barra + incrustación

Cada frase hablada es una de estas tres cosas:

Qué esCómo se muestra
droprelleno — ehh/ehh, tartamudeos, autocorreccionesno se muestra
railel valor por defecto — contenido hablado ordinario (textual)subtítulo inferior limpio, al frente, legible. Una palabra clave puede tener un resalte emphasis en línea (color de acento / efecto de palabra activa) — permanece en la barra.
embedun pico promocionado — el latido del titularuna palabra grande compuesta detrás del sujeto (oclusión mate), con entrada y salida diseñadas

La barra carga la mayor parte del texto; la incrustación es el pico escaso y ganado. La escasez es por compás/bloque, no por clip: ≤1 héroe por bloque (pensamiento), nunca dos visibles al mismo tiempo, ≥ un compás de aire entre ventanas de héroes (el compilador advierte por debajo de 0.6s). Un clip corto → normalmente 1–2; un explicador largo → aproximadamente uno por sección. Entre varios héroes, el más grande creado es el APEX (solo él recibe el bloqueo completo de incrustación + elevación de 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 todos los compases necesitan la exhibición mate, que es precisamente lo que mantiene el ápice como un evento. Incrustar cada palabra sigue siendo el error común.

Las identidades de superficie tipo barra construyen exactamente esto (barra = rail.html, incrustación = el clímax en index.html). Las identidades de flujo de columna eliminan la barra y hacen todo al estilo incrustación — recomiéndalas solo para solicitudes de ambiente sobre texto literal, nunca para videos explicativos/de 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 (36 entradas: 10 clásicas + 26 temáticas); el motor, compilador y archivo de autoría se derivan por búsqueda desde la fila del catálogo. Nunca preguntes "¿Estándar vs Cinematográfico vs Temático?" — esos son nombres de backend (un producto tiene una sola UX aunque tenga varios motores). El catálogo codifica todo lo que la ruta necesita: superficie de lectura, voz, recomendar-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-core/references/brief-contract.md § 1): en modo autónomo ("sorpréndeme" / "decide por mí"), elige tú mismo de tu lista breve y explica el porqué en una línea en lugar de preguntar.

Procedimiento: examina el clip → haz una lista breve de 2–3 identidades del catálogo → RECOMIENDA UNA con un porqué en una línea → el usuario elige (modo autónomo: tú eliges, explicando el porqué) → escribe el archivo de esa identidad. Las identidades están bloqueadas por motor (sin combinaciones cruzadas; abrir una es un evento de validación — ver dna/README.md).

Presenta siempre tu recomendación y deja que el usuario elija antes de escribir. No uses el valor por defecto 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 autoría de cada backend.)

Heurística de recomendación: usa las "Heurísticas de preselección" en CATALOG.md — son a nivel de identidad (ej. "炸" preselecciona ordnance/stomp/terminal/loud y elige SEGÚN lo que debe explotar), nunca a nivel de categoría. Si no estás seguro → anchor.

  • Cinematográfico → escribe plan.json para una plantilla fija, compilada por make-composition.cjs.
  • Temático → lee themes/README.md, escribe theme.json, ejecuta scripts/render-theme.sh (compila + renderiza + reacción de placa → final_fx.mp4).

Puerta de decisión — EJECUTAR PRIMERO

Examina el video y clasifica la escena antes de cualquier modo.

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

Lee las muestras. Rechaza si:

  • Hay varios hablantes / cortes bruscos (divide y renderiza cada toma, o rechaza)
  • No hay un sujeto humano (este skill es para videos de persona hablando)
  • Dura menos de 3 segundos, no hay habla, o la cara nunca es claramente visible — transcribe.cjs advierte cuando el audio está casi en silencio (Whisper alucina palabras como "Gracias." sobre el silencio); hazle caso y rechaza en lugar de subtitular palabras inventadas
  • La fuente ya tiene subtítulos quemados / leyendas / gráficos de texto pesados — añadir un segundo sistema de subtítulos entra en conflicto y la grabación se entrega sin tocar (sin cubrir/inpintar). El texto quemado a menudo aparece solo a mitad del clip: muestra una hoja de contacto a 1 fps (ffmpeg -i in.mp4 -vf "fps=1,scale=160:-1,tile=10x5" sheet.png), no confíes en 3 fotogramas puntuales.
  • La transcripción es basura — el habla no nativa/con acento fuerte puede transcribirse como galimatías con confianza. Lee transcript.json antes de escribir; si no se interpreta como lenguaje, prueba WHISPER_MODEL=medium una vez; si no, rechaza (una barra textual con palabras inventadas es peor que no tener subtítulos).
  • Cámara en mano movida con movimiento rápido (el mate parpadea)

Sondas previas al vuelo (no cuestan nada, evitan los peores fallos)

  1. Sonda de corte de toma. Muestra fotogramas al 20 %, 50 % y 80 %. Si aparece un sujeto/escena diferente, recorta el clip antes del corte.
  2. Sonda de letterbox / pillarbox. ¿Barras negras en el primer fotograma? Calcula el rectángulo de contenido seguro y restringe la colocación de subtítulos dentro de él.
  3. Sonda de luminancia. Muestra la luminancia media de la región de subtítulos — menos de 60 → el texto claro se lee tal cual, 60-180 → añade la cortina de glifos, 180+ → texto opaco + cortina (nunca texto claro desnudo). Las plantillas cinematográficas son crema+screen y BLOQUEADAS — usa esta sonda para elegir una identidad adecuada (escenas brillantes → ink, o el tema anchor con barra opaca), nunca para recolorear una.
  4. Recomendación de identidad por tono (tú recomiendas; el usuario elige — ver Paso 0 + CATALOG.md). 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és seguro → anchor (las palabras se leen, la escena segura) — pero presenta una lista breve y deja que el usuario elija.

Proceso — 5 pasos

1. hyperframes init <proyecto> --non-interactive --video <video.mp4>
2. bash scripts/prepare.sh <proyecto>       # mate ∥ transcripción (en paralelo) → zonas seguras. Un solo comando.
                                           #   → frames_fg/ transcript.json safe-zones.json
3. [PASO DEL AGENTE — el único paso creativo] escribe un pequeño JSON; ver a continuación según el modo
   Cinematográfico: escribe plan.json → node scripts/fill-timings.cjs → fit-fonts.cjs → make-composition.cjs
   Temático:     escribe theme.json → bash scripts/render-theme.sh <proyecto>   (compila + renderiza + efectos de placa)
4. node scripts/preview-frames.cjs <proyecto>   # ~2s/fotograma de previsualizaciones compuestas → § QA visual (ANTES del renderizado)
5. bash scripts/render-and-composite.sh <proyecto>  # compuertas → final.mp4 + instantánea history/
   (Modo Temático: SALTAR pasos 3b/5 — render-theme.sh ya ejecuta compilación + render-and-composite
    + _postfx.sh; el entregable es final_fx.mp4, final.mp4 es antes de la reacción de placa)

El paso 1 init 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 incrustación)

  1. Lee safe-zones.json primero. Los planos de narración van en zones.hugLeft/hugRight — tiras limpias PEGADAS a la silueta (el texto lejos del cuerpo se lee como flotante, no incrustado; las esquinas lejanas son la alternativa, no el valor por defecto). El héroe por defecto va en heroAnchor/heroBands.best (centrado SOBRE 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 al frente es el último recurso.
  2. El ADN es la identidad que elegiste en el Paso 0 (CATALOG.md) — no reabras la elección aquí. Verifica que sea coherente con la escena (una banda de héroe con luminancia > 150 requiere ink; la guía completa de selección está en el catálogo, cubriendo las diez incluyendo neon / glitch / chrome / velocity). Indica tu elección + porqué; el usuario decide. El ADN bloquea tipo/paleta/mezcla/movimiento + el acto triple del héroe; las zonas seguras v2 (palette/optics/lighting) lo parametrizan para ESTA escena automáticamente.
  3. Escribe <proyecto>/cinematic.json — "dna": "<nombre>" + BLOQUES de pensamiento, no grupos brutos: cada bloque = líneas de palabras (agrupadas de 2 a 5 en límites de cláusula) + el plano en el que se apila + css por línea (tamaño/peso/estilo solo — sin posiciones) + como máximo UNA línea marcada como "hero": true (la palabra promocionada; "text" para la forma mostrada). Esquema: cabecera de scripts/make-cinematic.cjs.
  4. Compila: node scripts/make-cinematic.cjs <proyecto> — baja bloques → plan.json → index.html. Generado para ti: sincronizaciones secuenciadas por transcripción, acumulación dentro del bloque, paso de página entre bloques, el BLOQUEO DEL HÉROE (el contexto previo al bloque del héroe, el HÉROE y el contexto posterior se apilan como UNA composición unida centrada en el sujeto — orden de lectura de arriba a abajo = orden hablado por construcción; el contexto flota al FRENTE mientras que el héroe se incrusta DETRÁS = el sándwich de profundidad; una regla de masa mantiene al héroe dominando su contexto), división ápice/héroe menor, orden de lectura por construcción, alternativa fg según zonas seguras. Luego las compuertas se ejecutan como de costumbre. (Sigue siendo posible escribir plan.json a mano para diseños que los bloques no pueden expresar — luego ejecuta fill-timings.cjs + fit-fonts.cjs + make-composition.cjs tú mismo.)

Paso 3 — Modo Temático (constitución temática)

Lee themes/README.md PRIMERO — paradigma/registros de pieza central, enlaces, reglas estrictas y el esquema exacto de theme.json.

  1. Elige un ADN de tema por registro de contenido (cada themes/<nombre>.json tiene voice + when). Indica tu elección + porqué; el usuario decide.
  2. Escribe <proyecto>/theme.json — dna, lines (textual, orden de transcripción; 1–5 palabras cada una — para takeover cada línea es una TARJETA), minors (palabras de énfasis), hero:{match} (la palabra/frase culminante; DÉJALA FUERA de lines para piezas incrustadas, MANTÉNLA DENTRO para piezas en línea y panel+redact).
  3. Renderiza: bash scripts/render-theme.sh <proyecto> — compila (compuerta de completitud textual en tiempo de compilación), renderiza ambas capas, compone, aplica la reacción de placa → final_fx.mp4. Usa preview-frames con la bandera --theme (preview-frames --theme) para una comprobación visual previa al renderizado completo.

Individual skills in this repo

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

sansayan01/finance_app_zo

The fallback workflow for authoring or editing any custom HyperFrames composition at any length or format — longer / multi-scene pieces, brand and sizzle reels, montages, title cards, static loops, freeform builds. Use only when no specialized workflow fits the input; routing table at /hyperframes.

sansayan01/finance_app_zo

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.

sansayan01/finance_app_zo

HyperFrames CLI dev loop. Use when running npx hyperframes init, add, catalog, capture, lint, check, snapshot, compare, grade-compare, preview, play, render, publish, cloud, feedback, lambda, doctor, browser, info, upgrade, skills, compositions, docs, benchmark, telemetry, transcribe, tts, or remove-background (validate/inspect/layout are deprecated aliases covered by check), or when troubleshooting the HyperFrames build/render environment. Entry point for HeyGen-hosted cloud rendering (`hyperframes cloud render / list / get / delete`) and self-managed AWS Lambda rendering (`hyperframes lambda deploy / render / progress / destroy / policies / sites`).

sansayan01/finance_app_zo

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. Also covers Tailwind projects and the STORYBOARD.md / SCRIPT.md plan formats. Read before writing composition HTML.

sansayan01/finance_app_zo

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`.

sansayan01/finance_app_zo

Use when a HyperFrames composition needs seek-safe 2D/3D keyframes, GSAP timelines, 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.

sansayan01/finance_app_zo

MicroFlow Pro - MFI Staff Portal built with Flutter & Supabase

Skills relacionados