Communitygithub.com

Biznomad/claude-skills

Crea composiciones de video, animaciones, tarjetas de título, superposiciones, subtítulos, voces en off, visuales reactivos al audio y transiciones de escena en HyperFrames HTML. Úsalo cuando se te pida construir cualquier contenido de video basado en HTML, agregar subtítulos o leyendas sincronizadas con el audio, generar narración de texto a voz, crear animaciones reactivas al audio (sincronización de ritmo, brillo, pulso impulsado por música), agregar resaltado de texto animado (barridos de marcador, círculos dibujados a mano, líneas de ráfaga, garabatos, bocetos) o agregar transiciones entre escenas (fundidos, cortinillas, revelados, transiciones de sombreado). Cubre la autoría de composiciones, temporización, medios y el flujo de trabajo completo de producción de video. Para comandos CLI de bucle de desarrollo (init, lint, inspect, preview, render) consulta la habilidad hyperframes-cli; para comandos de preprocesamiento de activos (tts, transcribe, remove-background) consulta la habilidad hyperframes-media.

¿Qué es claude-skills?

Esta habilidad permite a un agente de IA (como Claude Code, Cursor o Codex) actuar como un editor de video y compositor completo, utilizando HTML como fuente de verdad para la producción de video. Con ella, puedes crear composiciones de video complejas que incluyen animaciones, tarjetas de título, superposiciones, subtítulos sincronizados con audio, voces en off generadas por texto a voz, visuales reactivos al audio (como sincronización de ritmo o pulsos), resaltado de texto animado y transiciones de escena. La habilidad se basa en el framework HyperFrames, que usa archivos HTML con atributos `data-*` para la temporización, una línea de tiempo GSAP para la animación y CSS para la apariencia. La habilidad está diseñada para agentes que se ejecutan en la terminal (por ejemplo, Claude Code) y cubre todo el flujo de trabajo de producción de video: desde la comprensión de la intención del usuario y la expansión del prompt, hasta el diseño del sistema visual, la planificación de la estructura de la composición, la disposición de elementos con el método "Layout Before Animation" y la adición de movimiento. El framework soporta sub-composiciones, variables parametrizadas para reutilizar el mismo diseño con diferente contenido y una amplia gama de atributos de datos para controlar con precisión la temporización y el comportamiento de cada clip. Con esta habilidad, un agente de IA puede reemplazar herramientas de edición de video tradicionales gestionando todo el proceso creativo y técnico a través de código.

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

Preguntar en tu IA favorita

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

Documentación

HyperFrames

HTML es la fuente de verdad para el video. Una composición es un archivo HTML con atributos data-* para la temporización, una línea de tiempo GSAP para la animación y CSS para la apariencia. El framework maneja la visibilidad de los clips, la reproducción de medios y la sincronización de la línea de tiempo.

Enfoque

Descubrimiento (solo para solicitudes exploratorias)

Para solicitudes abiertas ("hazme un video de lanzamiento de producto", "crea algo para nuestra marca") donde el usuario no se ha comprometido con una dirección, comprende la intención antes de elegir colores:

  • Audiencia — ¿quién ve esto? ¿Desarrolladores? ¿Ejecutivos? ¿Consumidores generales?
  • Plataforma — ¿dónde se reproduce? ¿Redes sociales (15s), sitio web hero, demo de producto, interno?
  • Prioridad — ¿qué importa más? ¿Calidad del movimiento? ¿Precisión del contenido? ¿Fidelidad de la marca? ¿Velocidad?
  • Variaciones — ¿el usuario quiere opciones, o una sola toma única?

Para solicitudes específicas ("agrega una tarjeta de título", "arregla la temporización en la escena 3"), omite el descubrimiento.

Para solicitudes exploratorias, considera ofrecer 2-3 variaciones que difieran significativamente — no solo cambios de color, sino diferentes ritmos, niveles de energía o enfoques estructurales. Una segura/esperada, una ambiciosa. No impongas esto — es una herramienta disponible cuando sea apropiado.

Paso 1: Sistema de diseño

Si existe design.md o DESIGN.md en el proyecto, léelo primero (verifica ambas mayúsculas/minúsculas — son archivos diferentes en Linux). Es la fuente de verdad para los colores de la marca, fuentes y restricciones. Usa sus valores exactos — no inventes colores ni sustituyas fuentes. Cualquier formato funciona (frontmatter YAML, prosa, tablas — solo extrae los valores).

Si nombra fuentes que no puedes encontrar localmente (sin directorio fonts/ con archivos .woff2, no es una fuente incorporada), advierte al usuario antes de escribir HTML: "design.md especifica [nombre de la fuente] pero no se encontraron archivos de fuente. Agrega archivos .woff2 a fonts/ o usaré el respaldo [alternativa incorporada más cercana]."

Si no existe design.md, ofrece al usuario una opción:

  1. ¿El usuario nombró un estilo o estado de ánimo? → Lee visual-styles.md para los 8 preajustes nombrados. Elige la coincidencia más cercana.
  2. ¿Quiere explorar opciones visualmente? → Ejecuta el selector de diseño: lee references/design-picker.md para el flujo de trabajo completo. Esto sirve una página de selector visual. El usuario configura el estado de ánimo, la paleta, la tipografía y el movimiento en el navegador, luego copia el design.md generado y lo pega de nuevo en la conversación.
  3. ¿Quiere omitir e ir rápido? → Pregunta: estado de ánimo, claro u oscuro, ¿colores/fuentes de marca? Luego elige una paleta de house-style.md.

design.md define la marca. No define las reglas de composición de video. Esas vienen de references/video-composition.md y house-style.md. Usa los colores de la marca a una escala apropiada para video — no a la opacidad de una interfaz web.

Paso 2: Expansión del prompt

Siempre se ejecuta en cada composición (excepto piezas de una sola escena y ediciones triviales). Este paso ancla la intención del usuario contra design.md y house-style.md y produce un intermedio consistente que todos los agentes posteriores lean de la misma manera.

Lee references/prompt-expansion.md para el proceso completo y el formato de salida.

Paso 3: Planificar

Antes de escribir HTML, piensa a alto nivel:

  1. Qué — ¿qué debería experimentar el espectador? Identifica el arco narrativo, los momentos clave y los latidos emocionales.
  2. Estructura — cuántas composiciones, cuáles son sub-composiciones vs. en línea, qué pistas llevan qué (video, audio, superposiciones, subtítulos).
  3. Ritmo — declara el ritmo de tu escena antes de implementar. Qué escenas son golpes rápidos, cuáles son pausas, dónde caen los sombreadores, dónde alcanza su punto máximo la energía. Nombra el patrón: rápido-rápido-LENTO-rápido-SOMBREADOR-pausa. Lee references/beat-direction.md para plantillas de ritmo.
  4. Temporización — qué clips impulsan la duración, dónde caen las transiciones, cuál es el ritmo.
  5. Diseño — construye el estado final primero. Consulta "Diseño antes de la Animación" más abajo.
  6. Animar — luego agrega movimiento usando las reglas a continuación.

Construye lo que se pidió. Una solicitud de "una tarjeta de título" no es una solicitud de "una tarjeta de título + 3 escenas de apoyo + música ambiental + subtítulos." Cada escena, cada elemento, cada tween debe ganarse su lugar. Si escenas o elementos adicionales mejoraran genuinamente la pieza, propónlos — no los agregues.

Para ediciones pequeñas (arreglar un color, ajustar la temporización, agregar un elemento), salta directamente a las reglas.

Diseño antes de la Animación

Posiciona cada elemento donde debería estar en su momento más visible — el fotograma donde ha entrado completamente, está colocado correctamente y aún no está saliendo. Escríbelo como HTML+CSS estático primero. Sin GSAP todavía.

Por qué es importante: Si posicionas los elementos en su estado inicial animado (fuera de pantalla, escalados a 0, opacidad 0) y los interpolas a donde crees que deberían aterrizar, estás adivinando el diseño final. Las superposiciones son invisibles hasta que el video se renderiza. Al construir el estado final primero, puedes ver y solucionar problemas de diseño antes de agregar cualquier movimiento.

El proceso

  1. Identifica el fotograma heroico para cada escena — el momento en que la mayoría de los elementos son simultáneamente visibles. Este es el diseño que construyes.
  2. Escribe CSS estático para ese fotograma. El contenedor .scene-content DEBE llenar la escena completa usando width: 100%; height: 100%; padding: Npx; con display: flex; flex-direction: column; gap: Npx; box-sizing: border-box. Usa padding para empujar el contenido hacia adentro — NUNCA uses position: absolute; top: Npx en un contenedor de contenido. Los contenedores de contenido con posición absoluta se desbordan cuando el contenido es más alto que el espacio restante. Reserva position: absolute solo para elementos decorativos.
  3. Agrega entradas con gsap.from() — anima DESDE fuera de pantalla/invisible HASTA la posición CSS. La posición CSS es la verdad fundamental; el tween describe el viaje para llegar allí. (En sub-composiciones cargadas a través de data-composition-src, prefiere gsap.fromTo() — consulta las reglas GSAP de carga en references/motion-principles.md.)
  4. Agrega salidas con gsap.to() — anima HASTA fuera de pantalla/invisible DESDE la posición CSS.

Ejemplo

/* scene-content llena la escena, el padding posiciona el contenido */
.scene-content {
  display: flex;
  flex-direction: column;
  justify-content: center;
  width: 100%;
  height: 100%;
  padding: 120px 160px;
  gap: 24px;
  box-sizing: border-box;
}
.title {
  font-size: 120px;
}
.subtitle {
  font-size: 42px;
}
/* El contenedor se adapta a cualquier tamaño de escena (1920x1080, 1080x1920, etc.).
   El padding posiciona el contenido. Flex + gap maneja el espaciado. */

INCORRECTO — dimensiones fijas y posicionamiento absoluto:

.scene-content {
  position: absolute;
  top: 200px;
  left: 160px;
  width: 1920px;
  height: 1080px;
  display: flex; /* ... */
}
// Paso 3: Animar HACIA esas posiciones
tl.from(".title", { y: 60, opacity: 0, duration: 0.6, ease: "power3.out" }, 0);
tl.from(".subtitle", { y: 40, opacity: 0, duration: 0.5, ease: "power3.out" }, 0.2);
tl.from(".logo", { scale: 0.8, opacity: 0, duration: 0.4, ease: "power2.out" }, 0.3);

// Paso 4: Animar FUERA de esas posiciones
tl.to(".title", { y: -40, opacity: 0, duration: 0.4, ease: "power2.in" }, 3);
tl.to(".subtitle", { y: -30, opacity: 0, duration: 0.3, ease: "power2.in" }, 3.1);
tl.to(".logo", { scale: 0.9, opacity: 0, duration: 0.3, ease: "power2.in" }, 3.2);

Cuando los elementos comparten espacio a lo largo del tiempo

Si el elemento A sale antes de que el elemento B entre en la misma área, ambos deben tener posiciones CSS correctas para sus respectivos fotogramas heroicos. El orden de la línea de tiempo garantiza que nunca coexistan visualmente, pero si omites el paso de diseño, no detectarás el caso en que se superpongan accidentalmente debido a un error de temporización.

Qué cuenta como superposición intencional

Los efectos en capas (brillo detrás del texto, elementos de sombra, patrones de fondo) y los diseños apilados en z (pilas de tarjetas, capas de profundidad) son intencionales. El paso de diseño se trata de detectar superposiciones no intencionales — dos titulares cayendo uno sobre otro, una estadística cubriendo una etiqueta, contenido saliéndose del fotograma.

Atributos de Datos

Todos los Clips

AtributoRequeridoValores
idSíIdentificador único
data-startSíSegundos o referencia de ID de clip ("el-1", "intro + 2")
data-durationRequerido para img/div/composicionesSegundos. Video/audio usa la duración del medio por defecto.
data-track-indexSíEntero. Los clips del mismo track no pueden superponerse.
data-media-startNoDesplazamiento de recorte en el origen (segundos)
data-volumeNo0-1 (por defecto 1)

data-track-index no afecta la superposición visual — usa CSS z-index.

Clips de Composición

AtributoRequeridoValores
data-composition-idSíID de composición único
data-startSíTiempo de inicio (composición raíz: usa "0")
data-durationSíTiene prioridad sobre la duración de la línea de tiempo GSAP
data-width / data-heightSíDimensiones en píxeles (1920x1080 o 1080x1920)
data-composition-srcNoRuta a un archivo HTML externo
data-variable-valuesNoObjeto JSON de anulaciones de variable por instancia en un host de sub-comp

En el elemento raíz <html>:

AtributoRequeridoValores
data-composition-variablesNoArray JSON de variables declaradas (id/tipo/etiqueta/valor_por_defecto) — impulsa la interfaz de edición de Studio y proporciona valores predeterminados para getVariables()

Estructura de la Composición

Las sub-composiciones cargadas a través de data-composition-src usan un contenedor <template>. Las composiciones independientes (el archivo index.html principal) NO usan <template> — colocan el div data-composition-id directamente en <body>. Usar <template> en un archivo independiente oculta todo el contenido del navegador y rompe el renderizado.

Estructura de sub-composición:

<template id="my-comp-template">
  <div data-composition-id="my-comp" data-width="1920" data-height="1080">
    <!-- contenido -->
    <style>
      [data-composition-id="my-comp"] {
        /* estilos con ámbito */
      }
    </style>
    <script src="https://cdn.jsdelivr.net/npm/[email protected]/dist/gsap.min.js"></script>
    <script>
      window.__timelines = window.__timelines || {};
      const tl = gsap.timeline({ paused: true });
      // tweens...
      window.__timelines["my-comp"] = tl;
    </script>
  </div>
</template>

Cargar en la raíz: <div id="el-1" data-composition-id="my-comp" data-composition-src="compositions/my-comp.html" data-start="0" data-duration="10" data-track-index="1"></div>

Variables (Composiciones Parametrizadas)

Renderiza la misma composición con contenido diferente — título, color de tema, precios, subtítulos — sin editar el HTML de origen.

Patrón de tres pasos:

  1. Declara variables en la raíz <html> de la composición con data-composition-variables. Cada entrada necesita id, type (uno de string, number, color, boolean, enum), label y default. Las entradas Enum también necesitan options: [{value, label}, ...].
  2. Lee los valores resueltos dentro del script de la composición con window.__hyperframes.getVariables(). Devuelve el resultado combinado de los valores predeterminados declarados + anulaciones por instancia + anulaciones CLI.
  3. Anula en tiempo de renderizado con npx hyperframes render --variables '{...}' (nivel superior) o con data-variable-values='{...}' en el elemento host (por instancia para sub-comps).
<!doctype html>
<html
  data-composition-variables='[
  {"id":"title","type":"string","label":"Título","default":"Hola"},
  {"id":"theme","type":"enum","label":"Tema","default":"light","options":[
    {"value":"light","label":"Claro"},
    {"value":"dark","label":"Oscuro"}
  ]}
]'
>
  <body>
    <div data-composition-id="root" data-width="1920" data-height="1080">
      <h1 id="hero" class="clip" data-start="0" data-duration="3"></h1>
      <script>
        const { title, theme } = window.__hyperframes.getVariables();
        document.getElementById("hero").textContent = title;
        document.body.dataset.theme = theme;
      </script>
    </div>
  </body>
</html>
# La vista previa de desarrollo usa los valores predeterminados declarados
npx hyperframes preview

# Renderiza con anulaciones
npx hyperframes render --variables '{"title":"Reporte Q4","theme":"dark"}' --output q4.mp4

# O desde un archivo JSON
npx hyperframes render --variables-file ./vars.json

Valores por instancia de sub-composición: el mismo getVariables() funciona dentro de sub-comps cargadas a través de data-composition-src. Cada elemento host pasa sus propios valores:

<div
  data-composition-id="card-pro"
  data-composition-src="compositions/card.html"
  data-variable-values='{"title":"Pro","price":"$29"}'
></div>
<div
  data-composition-id="card-enterprise"
  data-composition-src="compositions/card.html"
  data-variable-values='{"title":"Empresa","price":"$99"}'
></div>

Individual skills in this repo

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

Biznomad/claude-skills

TikTok Ads deep analysis covering creative quality, tracking, bidding, campaign structure, and TikTok Shop. Evaluates 25 checks with emphasis on creative-first strategy, safe zone compliance, and Smart+ campaigns. Use when user says "TikTok Ads", "TikTok marketing", "TikTok Shop", "Spark Ads", "Smart+", or "TikTok campaign".

Biznomad/claude-skills

YouTube Ads specific analysis covering campaign types, creative quality, audience targeting, and measurement. Evaluates video ad performance across skippable, non-skippable, bumper, Shorts, and Demand Gen formats. Use when user says "YouTube Ads", "video ads", "pre-roll", "bumper ads", "YouTube campaign", or "Shorts ads".

Biznomad/claude-skills

Help users get promoted at work. Use when someone is preparing for a promotion conversation, building their case for advancement, trying to understand what's blocking their promotion, or figuring out how to get to the next level in their career.

Biznomad/claude-skills

CSS animation adapter patterns for HyperFrames. Use when authoring CSS keyframes, animation-delay based timing, animation-fill-mode, animation-play-state, or CSS-only motion that HyperFrames must seek deterministically during preview and rendering.

Biznomad/claude-skills

HyperFrames CLI dev loop — `npx hyperframes` for scaffolding (init), validation (lint, inspect), preview, render, and environment troubleshooting (doctor, browser, info, upgrade). Use when running any of these commands or troubleshooting the HyperFrames build/render environment. For asset preprocessing commands (`tts`, `transcribe`, `remove-background`), invoke the `hyperframes-media` skill instead.

Biznomad/claude-skills

Asset preprocessing for HyperFrames compositions — text-to-speech narration (Kokoro), audio/video transcription (Whisper), and background removal for transparent overlays (u2net). Use when generating voiceover from text, transcribing speech for captions, removing the background from a video or image to use as a transparent overlay, choosing a TTS voice or whisper model, or chaining these (TTS → transcribe → captions). Each command downloads its own model on first run.

Biznomad/claude-skills

Install and wire registry blocks and components into HyperFrames compositions. Use when running hyperframes add, installing a block or component, wiring an installed item into index.html, or working with hyperframes.json. Covers the add command, install locations, block sub-composition wiring, component snippet merging, and registry discovery.

Biznomad/claude-skills

Optimize landing pages for higher conversion rates using proven frameworks and design patterns. Use when designing, reviewing, or improving landing pages, hero sections, pricing pages, CTAs, or when the user asks about conversion optimization.

Biznomad/claude-skills

Building promotion cases, brag documents, tracking wins, and self-advocacy for career advancement. Use when preparing for promotions, documenting accomplishments, or building your case for advancement.

Biznomad/claude-skills

Translate an existing Remotion (React-based) video composition into a HyperFrames HTML composition. Use ONLY when the user explicitly asks to port, convert, migrate, translate, or rewrite a Remotion composition as HyperFrames (e.g. "port my Remotion project to HyperFrames"). Do NOT use when (a) authoring a NEW HyperFrames composition (even if A/B-testing a Remotion video); (b) Remotion is mentioned in passing; (c) Remotion code is shared as reference, not for translation; (d) the user wants "the same video as my Remotion one" without explicitly asking to migrate the source — treat as a fresh HyperFrames build. When in doubt, default to the `hyperframes` skill. Detects unsupported patterns (useState, useEffect side effects, async calculateMetadata, third-party React component libraries, `@remotion/lambda`) and recommends the runtime interop escape hatch instead of a lossy translation.

Biznomad/claude-skills

Produce programmable videos with Remotion using scene planning, asset orchestration, and validation gates for automated, brand-consistent video content.

Biznomad/claude-skills

Generate cinematic film-style video prompts for Seedance 2.0 on Higgsfield. Use whenever the user wants cinematic, film-like, movie-quality, Hollywood-style, dramatic, or professional film-quality AI video. Triggers on: cinematic, film look, movie scene, dramatic lighting, depth of field, lens flare, anamorphic, letterbox, noir, epic, Steadicam, dolly, crane shot, or any cinematic video generation request. Always use this skill even if the user doesn't explicitly say "cinematic" but describes a film-like aesthetic.

Biznomad/claude-skills

为 Seedance 2.0(Higgsfield)生成电影级胶片风格视频提示词。在用户想要电影级、胶片感、电影质量、好莱坞风格、戏剧性或专业胶片质量的AI视频时使用。触发词:电影级、胶片感、电影场景、戏剧性打光、景深、镜头光晕、变形、信箱式、黑色电影、史诗、稳定摄像机、推车镜头、吊臂镜头或任何电影级视频生成请求。即使用户没有明确说"电影级"但描述了胶片美学,也要使用此技能。

Biznomad/claude-skills

Convert comic book panels, manga pages, webtoons, and illustrated storyboards into animated video using Seedance 2.0 on Higgsfield. Use whenever the user wants to animate comics, bring illustrations to life, convert manga to video, animate storyboards, or create motion from static sequential art. Triggers on: comic to video, manga animation, panel animation, storyboard to video, webtoon animation, comic book motion, sequential art, graphic novel animation, or any illustrate-to-animate request. Use even when user says "make this drawing move" or "animate this page.

Biznomad/claude-skills

Generate music video and beat-synced visual content prompts for Seedance 2.0 on Higgsfield. Use whenever the user wants to create a music video, lyric video, beat-synced visuals, performance video, concert visual, album art animation, or music-driven visual content. Triggers on: music video, lyric video, beat sync, music visualization, performance video, concert visual, album visual, song video, music clip, beat drop visual, rhythm sync, or any music-driven video request. Use even for "make visuals for my song" or "video for this track.

Biznomad/claude-skills

Build, redesign, and deploy websites across any stack — static HTML, Next.js, Astro, or Shopify Liquid themes. Handles design systems, brand-aware layouts, component architecture, and deployment pipelines (Netlify, Vercel, Shopify API). Use when asked to build a website, redesign a site, create a landing page, build a web app, create Shopify sections/templates, or deploy web projects. Triggers on requests like "build me a website", "redesign this page", "create a landing page", "build a Shopify theme", "deploy to Netlify".

Biznomad/claude-skills

Capture a website and create a HyperFrames video from it. Use when: (1) a user provides a URL and wants a video, (2) someone says "capture this site", "turn this into a video", "make a promo from my site", (3) the user wants a social ad, product tour, or any video based on an existing website, (4) the user shares a link and asks for any kind of video content. Even if the user just pastes a URL — this is the skill to use.

Skills relacionados