Communitygithub.com

sansayan01/finance_app_zo

El contrato de composición de HyperFrames: construye un proyecto renderizable. Úsalo para la estructura de composición, los atributos de temporización `data-*`, `class="clip"`, pistas, subcomposiciones, variables, reproducción de medios gestionada por el framework, reglas de renderizado determinista y validación. También cubre proyectos con Tailwind y los formatos de plan STORYBOARD.md / SCRIPT.md. Léelo antes de escribir HTML de composición.

¿Qué es finance_app_zo?

Esta habilidad define el contrato técnico fundamental para construir proyectos renderizables con HyperFrames, un framework que convierte HTML en video. Describe la estructura de composición, el uso de atributos de temporización `data-*`, clases como `clip`, y la gestión de pistas y subcomposiciones. Es útil para desarrolladores que necesitan crear animaciones deterministas y reproducibles, con reglas estrictas sobre cómo declarar medios (video/audio), variables y estilos. Soporta proyectos independientes y subcomposiciones, así como proyectos con Tailwind v4. Incluye referencias detalladas a archivos de documentación (como `data-attributes.md` y `determinism-rules.md`) que se deben consultar bajo demanda, y forma parte de un ecosistema más amplio de habilidades hermanas para animación, creatividad, CLI y registro. El contenido abarca reglas no negociables que las herramientas de validación no detectan, como la prohibición de usar `Math.random` sin semilla, la necesidad de que los elementos raíz tengan un tamaño explícito, y que los IDs sean únicos en toda la página ensamblada.

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

Preguntar en tu IA favorita

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

Documentación

HyperFrames Core

HyperFrames renderiza video a partir de HTML. Una composición es un archivo HTML cuyo DOM declara la temporización con atributos data-*, cuyo tiempo de ejecución de animación es seekable, y cuya reproducción de medios es gestionada por el framework.

Esta habilidad es el contrato técnico — cómo construir un proyecto hyperframes. El cuerpo a continuación es la guía de construcción; los detalles por tema viven en references/ (índice a continuación), léelos bajo demanda. Otras preocupaciones viven en las habilidades de dominio hermanas — hyperframes-animation, hyperframes-creative, media-use, hyperframes-cli, hyperframes-registry. El mapa de capacidades en /hyperframes dice lo que cubre cada una.

Referencias

ArchivoLéelo para…
references/minimal-composition.mdcomenzar desde el esqueleto de composición renderizable más pequeño
references/composition-patterns.mdelegir monolítico vs modular; estructurar un index.html modular; elegir un arquetipo de subcomp
references/data-attributes.mdbuscar cualquier atributo data-* (raíz / clip / host de subcomp / alias heredados); usar class="clip"
references/tracks-and-clips.mdelegir data-track-index, manejar superposición / z-index en la misma pista, temporizar un clip relativo a otro
references/sub-compositions.mdcablear una subcomposición (atributos host, <template>, vars por instancia) y animar dentro de ella
references/variables-and-media.mddeclarar variables; colocar <video>/<audio>, establecer volumen, recortar
references/determinism-rules.mdconstruir una línea de tiempo seekable; prohibiciones de determinismo; la lista permitida de propiedades animables; ajuste de diseño / texto
references/full-screen-motion.mdcrear movimiento a pantalla completa con fondos compartidos
references/storyboard-format.mdcrear un plan STORYBOARD.md (+ el manifiesto analizado)
references/brief-contract.mdrealizar la toma de requerimientos de un flujo de trabajo de creación — modo de interacción (colaborativo / autónomo), campos compartidos del brief, reglas de preguntas
references/script-format.mdcrear la narración fija opcional SCRIPT.md
references/subagent-dispatch.mdmapear verbos de despacho de subagentes (fan-out paralelo / fondo / espera) a tu harness
references/tailwind.mdtrabajar en un proyecto Tailwind v4 (init --tailwind; el contrato de tiempo de ejecución difiere del v3 de Studio)

Para detalles específicos del runtime de animación (API de GSAP, Lottie, Three.js, etc.) ve a hyperframes-animation → adapters/<runtime>.md.

Construyendo una composición

Dos formas raíz (no intercambiables)

  • Independiente (index.html de nivel superior) — el <div data-composition-id="…"> raíz se coloca directamente en <body>, sin envoltorio <template> (envolverlo oculta todo el contenido y rompe el renderizado).
  • Subcomposición (cargada mediante data-composition-src) — la raíz debe estar envuelta en <template>.

⚠ Regla de transporte: el runtime solo clona el contenido de <template>; todo lo que está fuera (incl. estilos/scripts de <head>) se descarta — coloca <style>/<script> dentro del template. ⚠ Regla de ID de host: el data-composition-id del slot host debe coincidir exactamente con el data-composition-id del template interno y con la clave window.__timelines["<id>"] — sin sufijo -mount/-slot/-host.

Forma del archivo, cableado del host y la lista de verificación previa al renderizado → references/sub-compositions.md.

La raíz debe tener tamaño explícito (error de layout silencioso)

La raíz independiente necesita un cuadro con tamaño explícito (width/height en px), y cada ancestro hasta un elemento con height:100% debe tener una altura resuelta — de lo contrario, un hijo flex/100% colapsa a ~0 y el contenido se apila en la esquina superior izquierda. lint/validate/inspect no detectan esto. Esqueleto → references/minimal-composition.md.

Una línea de tiempo pausada

Cada composición registra exactamente una gsap.timeline({ paused: true }) en window.__timelines["<id>"] (clave = data-composition-id raíz), construida síncronamente al cargar la página. Duración del renderizado = data-duration raíz, no la longitud de la línea de tiempo. No anides manualmente sublíneas de tiempo en el host. Contrato completo (incl. runtimes que no son GSAP) → references/determinism-rules.md + hyperframes-animation/adapters/.

Reglas no negociables (errores silenciosos que lint/validate/inspect no detectarán)

Expuestas aquí; justificación completa en la referencia vinculada. No las violes:

  • Sin relojes en tiempo de renderizado / Math.random sin semilla / red / estado de entrada; sin repeat: -1 (usa un conteo finito). → determinism-rules.md
  • Anima solo la lista permitida de propiedades visuales; nunca display/visibility; sin gsap.set en clips de escenas posteriores. → determinism-rules.md
  • Sin <br> en el texto del cuerpo; los elementos transformados deben ser de nivel de bloque + con tamaño; los decorativos absolutos pulsantes necesitan espacio máximo. → determinism-rules.md
  • <video>/<audio> debe ser un hijo directo de la raíz del host (nunca dentro de un <template>/envoltorio de subcomp); el framework gestiona la reproducción. → variables-and-media.md
  • Cada id debe ser único en toda la página ensamblada; dentro de una subcomp, prefija los ids con el id de la composición (#<id>-hero). Los ids duplicados de <video>/<img> renderizan en blanco — el productor inyecta fotogramas mediante getElementById, y los duplicados entre archivos pasan desapercibidos para lint. → composition-patterns.md
  • El relleno de una escena a pantalla completa va en un hijo de sangría completa (position:absolute; inset:0), nunca en la raíz de la composición misma — la composición de fotogramas del productor puede eliminar el background del elemento raíz (el fotograma se renderiza negro) aunque la vista previa/snapshot lo muestren correctamente. → composition-patterns.md

Editando composiciones existentes

  • Lee los archivos primero. Conserva la temporización, pistas, IDs, variables y rutas de medios no relacionadas.
  • Coincide con los IDs de composición y claves de línea de tiempo existentes.
  • Agregar un clip: elige un data-track-index que no se superponga o ajusta intencionalmente la temporización circundante.
  • data-hidden en cualquier elemento de composición lo oculta TANTO en la vista previa como en el renderizado, anulando su ventana de tiempo; es no destructivo/reversible y se alterna con el ícono de ojo de la línea de tiempo de Studio.
  • Agregar una subcomposición: verifica su data-composition-id interno antes de cablear el host.

Validación

Usa hyperframes-cli para detalles de comandos

  • npx hyperframes check pasa (0 hallazgos en lint, runtime, layout, motion y contraste)
  • Proyectos con subcomposiciones: npx hyperframes snapshot --at <midpoints> y revisa visualmente cada fotograma
  • npx hyperframes preview para revisión (el usuario puede editar cualquier cosa en la línea de tiempo de Studio)
  • npx hyperframes render solo después de que el usuario lo apruebe

Individual skills in this repo

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

sansayan01/finance_app_zo

Add captions to a talking-head video. ONE catalog (CATALOG.md) of 36 visual identities behind two engines: column-flow (captions composited INTO the scene — matte occlusion + mix-blend; cream/ink/editorial/keynote/documentary/loud/neon/glitch/chrome/velocity) and themed constitutions (anchor/ordnance/terminal/neonsign/stardust/stomp/scoreboard/transit/vhs/arcade/dossier/laser/thunder/hologram/biolume/aurora/spectrum/papercut/popup/chalkboard/graffiti/brush/inkwater/ransom/lastpage/nightcity — e.g. a glyph-decode climax, a neon sign WRITTEN stroke by stroke, or the quiet `anchor` rail default). Route by identity, never by mode. Trigger on "captions/subtitles", "embed/cinematic captions", "VFX captions", "炸/特效/酷炫字幕", a named identity, or top-tier motion-graphics asks. Embedding every word is wrong for most talking-head content — `anchor` is the verbatim default. Runs locally end-to-end (transcribes and mattes the subject itself, no API key). Requires hyperframes and a single-subject clip (multi-shot clips ar...

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

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