Communitygithub.com

Elis3omndz/Claude_Skills

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, sub-composiciones, variables, reproducción de medios controlada por el framework, reglas de renderizado determinista y validación. Léelo antes de escribir HTML de composición.

¿Qué es Claude_Skills?

Esta habilidad define el contrato técnico para construir proyectos renderizables con HyperFrames, un framework que convierte HTML en video. Cubre la estructura de composición, atributos de temporización `data-*`, el uso de `class="clip"` para clips animados, pistas, sub-composiciones, variables y reglas de renderizado determinista. Es útil para desarrolladores que trabajan con HyperFrames en entornos como Claude Code, Cursor o Codex, ya que proporciona una guía completa de construcción, validación y edición de composiciones. La habilidad detalla las formas de raíz (independiente vs. sub-composición), reglas de linting y errores comunes, así como reglas no negociables para evitar bugs silenciosos. También lista referencias a archivos adicionales para profundizar en temas específicos como composiciones mínimas, patrones, atributos, pistas y más. Soporta múltiples plataformas y runtimes de animación (GSAP, Lottie, Three.js) a través de adaptadores.

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

Preguntar en tu IA favorita

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

Documentación

Instalación del plugin: Antes de ejecutar comandos de configuración o actualización, sigue las reglas de instalación del plugin cuando esta habilidad esté dentro de un plugin de HyperFrames. Las instalaciones independientes mantienen las instrucciones de actualización a continuación.

HyperFrames Core

Errores comunes del agente (léelos primero):

  • Centra con flex/inset, no con transform: translate(-50%,-50%) de CSS en un nodo al que luego aplicas GSAP x/y. Lint: gsap_css_transform_conflict. Usa fromTo o xPercent/yPercent.
  • No agregues un tl.set(..., {visibility:"hidden"}) al final de la escena. El runtime ya oculta los clips temporizados. Los fundidos de opacidad en nodos internos (o opacity en .clip) son suficientes. Los cortes abruptos de subtítulos siguen otra regla.
  • window.__timelines["id"] debe coincidir con el data-composition-id raíz.
  • Después de render, lee la segunda línea del resumen: beginframe vs screenshot, modo GPU, tiempos de etapa. screenshot + software gpu en Linux es la ruta lenta.

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

Esta habilidad es el contrato técnico — cómo construir un proyecto de 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 según sea necesario. Los documentos de proceso (brief, storyboard, revisión, producción, despacho, frame-worker) viven en /hyperframes → references/. Otros temas viven en las habilidades de dominio hermanas: hyperframes-animation, hyperframes-creative, media-use, hyperframes-cli, hyperframes-registry. El mapa de capacidades en /hyperframes dice qué cubre cada una.

Referencias

ArchivoLéelo para…
references/minimal-composition.mdempezar desde el esqueleto de composición renderizable más pequeño
references/composition-patterns.mdelegir entre monolítico vs. modular; estructurar un index.html modular; elegir un arquetipo de sub-composición
references/data-attributes.mdbuscar cualquier data-* (raíz / clip / host de sub-comp / alias heredados); usar class="clip"
references/tracks-and-clips.mdentender qué controla data-track-index (y qué no), z-index, temporizar un clip relativo a otro; listar cada pista y clip con npx hyperframes timeline
references/creator-editing-recipes.mdcopiar recetas verdaderas de corte/recorte/reordenar/retemporizar/congelar/cámara/máscara/encadenado/edición de audio y sus límites
references/sub-compositions.mdconectar una sub-composición (atributos de host, <template>, variables por instancia) y animar dentro de ella
references/variables-and-media.mddeclarar variables; colocar <video>/<audio>, ajustar volumen, recortar
references/determinism-rules.mdconstruir una línea de tiempo buscable; prohibiciones de determinismo; diseño / ajuste de texto
references/full-screen-motion.mdcrear movimiento a pantalla completa con fondos compartidos
references/tailwind.mdtrabajar en un proyecto Tailwind v4 (init --tailwind; el contrato de runtime difiere del Studio v3)

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 de 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>. Envolver una raíz independiente oculta todo el contenido y lint lo rechaza (standalone_composition_wrapped_in_template, error).
  • Sub-composición (cargada vía data-composition-src): envuelve la raíz en <template>. Esta es la forma a escribir: el cargador también acepta un documento completo y recurre a su <body>, pero la forma con plantilla es la que asumen los ejemplos y las herramientas.

⚠ Regla de transporte: para una sub-composición con plantilla, el ensamblador descarta el <head> <style>/<script> propio del archivo (packages/core/src/compiler/compositionAssembly.ts, la puerta hasTemplate), por lo que debes poner <style>/<script> dentro de la plantilla. <link> se eleva de cualquier manera. ⚠ Convención de ID de host: dale a la ranura del host, a la plantilla interna y a la clave window.__timelines["<id>"] el mismo id. Se admite un ID local diferente (el ensamblador recurre a la primera raíz en el archivo), pero el desajuste es silencioso, así que hazlos coincidir a menos que tengas una razón para no hacerlo.

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

La raíz debe tener tamaño (bug de diseño silencioso)

La raíz independiente usa width/height: 100%. El tamaño del lienzo es data-width/data-height. El runtime estampa esos píxeles en la raíz de la composición. No codifiques 1920px/1080px en #root. 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 de la raíz). Se admite construirla dentro de una llamada asíncrona (document.fonts.ready); lo que importa es que la registres solo después de que la construcción se complete. La duración del renderizado es el data-duration de la raíz, no la longitud de la línea de tiempo: una línea de tiempo que se extiende más allá se corta, y una que termina antes mantiene su último fotograma. Omite el data-duration de la raíz y la longitud se infiere en su lugar (línea de tiempo, ventana de medios o adaptador). No necesitas window.__timelines = window.__timelines || {}: el runtime crea el registro antes de que se ejecuten tus scripts en línea, y lint ya no lo solicita. No anides manualmente sub-líneas de tiempo en el host; el runtime anida automáticamente las líneas de tiempo hijas registradas. Contrato completo (incluyendo runtimes no GSAP) → references/determinism-rules.md + hyperframes-animation/adapters/.

Errores comunes de lint de primera pasada (una falla de construcción inicial garantizada)

Reglas que lint sí detecta, pero solo después del hecho. Escríbelas bien desde el principio:

  • Nunca combines un transform CSS inicial con una interpolación GSAP en la misma propiedad — el valor CSS y el inicio de la interpolación luchan y lint lo rechaza con gsap_css_transform_conflict. Establece el estado inicial dentro de la interpolación con gsap.fromTo(el, { x: -40 }, { x: 0 }) en lugar de un transform: translateX(-40px) de CSS.
  • Nunca pongas crossorigin en <video>/<audio>. lint lo rechaza incondicionalmente con media_crossorigin_breaks_preview (error), incluso para lectura de canvas/WebGL/WebAudio. No hay supresión.
  • Nunca des a un <video data-start> un ancestro que también tenga data-start. lint lo rechaza con video_nested_in_timed_element (error). Temporiza el contenedor o el video, no ambos.
  • Cada <audio> necesita un id. lint lo rechaza con media_missing_id, y un <audio> sin id nunca es recogido por el mezclador, por lo que el renderizado es silencioso.
  • Nunca interpoles un .clip con autoAlpha o visibility — lint lo rechaza con gsap_animates_clip_element. Anima un hijo en su lugar.
  • Una font-family CSS nombrada necesita un @font-face en el archivo a un archivo local enviado, o lint dispara font_family_without_font_face.
  • El #root de una sub-composición usa width/height: 100% (o inset: 0), no 1920px/1080px codificados. El tamaño del lienzo es data-width/data-height.

Un error de lint también desactiva las auditorías de diseño y contraste: check entonces reporta 0 sample(s) y 0/0 text checks, lo que se lee como un archivo limpio pero significa que no se ejecutó nada. Limpia los errores de lint antes de confiar en esos números.

Reglas no negociables (bugs silenciosos que las puertas automáticas pueden pasar por alto)

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; repeat: -1 solo bajo un data-duration raíz finito (exporta clips a él — de lo contrario, usa un conteo finito). → determinism-rules.md
  • Nunca interpoles display, visibility o autoAlpha en un elemento .clip. El framework posee la visibilidad del clip y lint lo rechaza (gsap_animates_clip_element). Anima un hijo en su lugar. → determinism-rules.md
  • Sin <br> en el texto del cuerpo; los elementos transformados deben ser de nivel de bloque y tener tamaño; los decorativos absolutos pulsantes necesitan espacio libre máximo. → determinism-rules.md
  • <video>/<audio> se encuentran mediante una consulta plana del documento, por lo que el framework los busca y decodifica a cualquier profundidad de anidamiento (incluyendo dentro de un <template> o contenedor de sub-comp). Un límite estricto: lint da error si un <video data-start> está dentro de otro elemento simple que también tiene data-start, y la falla es real (fotogramas fuente incorrectos, luego el clip desaparece a mitad de la ranura), así que pon la temporización en el contenedor o en el video, nunca en ambos. Los hosts de sub-composiciones están exentos: los medios dentro de una sub-composición se renderizan correctamente. La otra advertencia son las líneas de tiempo, no la colocación: una línea de tiempo de sub-comp no puede animar elementos raíz del host. → variables-and-media.md
  • Mantén cada id único en la página ensamblada (prefija los ids de sub-comp con el id de la composición, #<id>-hero) para que tus propios CSS #id y las llamadas getElementById se resuelvan. La inyección de fotogramas ya no depende de ello: el compilador estampa un data-hf-render-id único del documento en cada video[src]/audio[src]/img[src]. Los medios que usan hijos <source> en lugar de un atributo src no reciben el estampado, por lo que los ids únicos todavía importan allí. → composition-patterns.md
  • Un relleno de pantalla completa en la raíz de la composición está bien en un renderizado normal. Se descarta solo en la ruta de composición en capas (contenido HDR, o una composición que usa transiciones de shader), donde el motor fuerza cada raíz de composición transparente para que la capa inferior se vea a través. Si tu composición usa transiciones de shader o medios HDR, coloca el relleno en un hijo a sangre completa (position:absolute; inset:0). → composition-patterns.md

Editando composiciones existentes

  • Lee los archivos primero. Preserva la temporización, pistas, IDs, variables y rutas de medios no relacionadas.
  • Para saber qué hay en la línea de tiempo de un proyecto (pistas, clips, inicios, fines, qué se reproduce), ejecuta npx hyperframes timeline [--json] en lugar de leer index.html y cada archivo de sub-composición.
  • Haz coincidir los IDs de composición y las claves de línea de tiempo existentes.
  • Agregar un clip: establece su data-start/data-duration intencionalmente en relación con los clips circundantes. data-track-index es un carril de visualización del Studio, no una restricción de temporización, por lo que no necesita estar libre.
  • Un clip que termina después del data-duration raíz se corta: extiende el data-duration raíz hasta el final del clip en la misma edición (lint advierte clip_ends_past_root_duration).
  • data-hidden en cualquier elemento de composición lo oculta tanto en la vista previa como en el renderizado, anulando su ventana de tiempo; no es destructivo/reversible y se alterna con el icono de ojo de la línea de tiempo del Studio.
  • Agregar una sub-composició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, diseño, movimiento y contraste)
  • Proyectos con sub-composiciones: npx hyperframes snapshot --at <midpoints> y revisa visualmente cada fotograma
  • npx hyperframes preview --background para revisión (el usuario puede editar cualquier cosa en la línea de tiempo del Studio, y el servidor sobrevive al comando invocador)
  • npx hyperframes render solo después de que el usuario lo apruebe

Individual skills in this repo

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

Elis3omndz/Claude_Skills

Add captions or subtitles to an existing single-subject talking-head video without editing the footage. Use for plain verbatim captions, cinematic captions embedded behind the subject, VFX captions, “炸/特效/酷炫字幕,” or a named identity from the 35-style catalog. Route by visual identity, not by backend engine. The quiet `anchor` rail is the default; embed every word only when the user explicitly wants a fully cinematic treatment. The workflow runs locally end to end, including transcription and subject matting; split multi-shot footage before applying it.

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

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