Communitygithub.com

shengdabai/Tony-Claude-Code-Skills

Crea un nuevo bloque o componente del registro de HyperFrames (estilo de subtítulo, bloque VFX, transición, tercio inferior) y envíalo como una PR ascendente al repositorio hyperframes. Úsalo SOLO cuando el usuario quiera CONTRIBUIR al catálogo público — para la creación de subtítulos/transiciones dentro de un proyecto, usa la skill `hyperframes`, para instalar elementos existentes del registro usa la skill `hyperframes-registry`.

¿Qué es Tony-Claude-Code-Skills?

Esta skill guía al usuario a través del proceso completo de contribución al registro público de HyperFrames, desde una idea inicial hasta una Pull Request fusionada. Está diseñada para que desarrolladores y creadores de contenido puedan construir y compartir nuevos bloques (como estilos de subtítulos, efectos VFX, tarjetas de título y tercios inferiores) o componentes (efectos CSS, superposiciones, fragmentos reutilizables) que se añadirán al catálogo oficial de HyperFrames. La skill define un flujo de trabajo de seis pasos (Clarificar, Andamiar, Construir, Validar, Previsualizar y Enviar), proporcionando instrucciones detalladas sobre la estructura de archivos, convenciones de nomenclatura, reglas de animación con GSAP, plantillas para bloques y componentes, comandos de CLI para linting y validación, y los pasos exactos para crear una PR. Es compatible con la herramienta de línea de comandos `hyperframes` y se usa exclusivamente para contribuciones al catálogo público, no para proyectos locales. Si el usuario desea trabajar con elementos existentes del registro o crear contenido local, debe utilizar las skills `hyperframes` o `hyperframes-registry` respectivamente.

Compatible con✓Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/shengdabai/Tony-Claude-Code-Skills/tree/HEAD/skills/hyperframes-contribute-catalog

Preguntar en tu IA favorita

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

Documentación

Contribuir al Registro de HyperFrames

Guía al usuario desde la idea hasta una PR fusionada para un nuevo bloque o componente del registro.

Flujo de trabajo

1. Clarificar → 2. Andamiar → 3. Construir → 4. Validar → 5. Previsualizar → 6. Enviar

Paso 1: Clarificar

Pregunta qué están construyendo. El registro tiene dos tipos de elementos:

  • Bloque (registry/blocks/, tipo hyperframes:block) — una composición independiente completa con dimensiones y duración fijas. Estilos de subtítulos, efectos VFX, tarjetas de título, tercios inferiores.
  • Componente (registry/components/, tipo hyperframes:component) — un fragmento reutilizable sin dimensiones ni duración fijas. Efectos CSS, tratamientos de texto, superposiciones que se adaptan a cualquier tamaño de composición.

Luego pregunta:

  • Descripción de una frase del efecto
  • Referencia visual (URL, captura de pantalla o descripción)
  • ¿Quién usa esto y cuándo?

Paso 2: Andamiar

Crea la estructura del registro:

Para bloques:

registry/blocks/{nombre-del-bloque}/
  {nombre-del-bloque}.html
  registry-item.json

Para componentes:

registry/components/{nombre-del-componente}/
  {nombre-del-componente}.html
  registry-item.json

Convención de nomenclatura:

Nombre del elementoPrefijo IDEjemplos de IDs
cap-hormozihzhz-cg-0, hz-cw-3
cap-typewritertwtw-cg-0, tw-ch-0-5
vfx-chromevcvc-canvas

Usa un prefijo de 2-3 letras. TODOS los IDs de elementos deben usar este prefijo para evitar colisiones en sub-composiciones.

registry-item.json para bloques:

{
  "$schema": "https://hyperframes.heygen.com/schema/registry-item.json",
  "name": "{nombre-del-bloque}",
  "type": "hyperframes:block",
  "title": "{Título Humano}",
  "description": "{una frase}",
  "dimensions": { "width": 1920, "height": 1080 }, // ajustar: 1080x1920 para vertical/redes sociales
  "duration": 10, // ajustar para tu composición
  "tags": ["{categoría}", "{subcategoría}"],
  "files": [
    {
      "path": "{nombre-del-bloque}.html",
      "target": "compositions/{nombre-del-bloque}.html",
      "type": "hyperframes:composition"
    }
  ]
}

registry-item.json para componentes (sin dimensions ni duration):

{
  "$schema": "https://hyperframes.heygen.com/schema/registry-item.json",
  "name": "{nombre-del-componente}",
  "type": "hyperframes:component",
  "title": "{Título Humano}",
  "description": "{una frase}",
  "tags": ["{categoría}"],
  "files": [
    {
      "path": "{nombre-del-componente}.html",
      "target": "compositions/components/{nombre-del-componente}.html",
      "type": "hyperframes:snippet"
    }
  ]
}

Paso 3: Construir

Aplica la plantilla correcta según el tipo. Consulta templates.md para iniciadores de copiar y pegar.

Bloques de subtítulos

Reglas de subtítulos no negociables:

  • Fuente: Mínimo 96px para fuentes proporcionales. 64-72px aceptable para monoespaciadas (los caracteres más anchos necesitan menos tamaño).
  • Legibilidad: -webkit-text-stroke: 2-3px O text-shadow multicapa
  • Desbordamiento: llama a window.__hyperframes.fitTextFontSize() en cada grupo
  • Karaoke: resalta la palabra activa mediante tl.to(wordEl, { color/scale }, WORDS[wi].start)
  • Corte brusco: tl.set(groupEl, { opacity: 0, visibility: "hidden" }, g.end) en CADA grupo
  • Nunca uses tl.from(el, { opacity: 0 }) en la misma posición que tl.set(el, { opacity: 1 }) — el from sobrescribe el set. Usa tl.to en su lugar.

Animación por carácter (máquina de escribir, desorden):

  • Envuelve cada carácter en <span> con el ID {prefijo}-ch-{grupo}-{caracter}
  • Escalonado mediante tl.set en intervalos calculados a partir de las marcas de tiempo de las palabras
  • Cursores/elementos decorativos: usa tl.set en intervalos — NO animación CSS (no es buscable)

Variantes de posicionamiento:

  • Centrado: display: flex; align-items: center; justify-content: center;
  • Tercio inferior: position: absolute; bottom: 100px; left: 0; width: 100%; text-align: center;
  • Alineado a la izquierda: position: absolute; bottom: 100px; left: 120px; text-align: left;

Bloques VFX (Three.js)

  • Usa [email protected] desde CDN (script global)
  • tl.eventCallback("onUpdate", renderScene); renderScene(); — NO requestAnimationFrame
  • Patrón proxy de estado: GSAP anima un objeto JS plano, la función de render lo lee
  • PRNG con semilla (mulberry32) para aleatoriedad

Todos los tipos

  • data-composition-id DEBE coincidir con window.__timelines["id"]
  • Todos los IDs de elementos prefijados con la abreviatura del bloque
  • gsap.timeline({ paused: true }) — siempre en pausa
  • No Math.random(), no Date.now()

Paso 4: Validar

hyperframes lint                    # 0 errores requeridos
hyperframes validate --no-contrast  # 0 errores de consola requeridos

Paso 5: Previsualizar

# Renderizar video de vista previa
hyperframes render -o preview.mp4

# Captura instantánea para revisión visual
hyperframes snapshot --at "1.0,3.0,5.0,7.0"

# Publicar en hyperframes.dev para revisión
npx hyperframes publish

Imagen de vista previa del catálogo — La tarjeta del catálogo usa un PNG en docs/images/catalog/{tipo}/{nombre}.png (donde {tipo} es blocks o components). Genérala a partir de una captura instantánea, luego:

  • Contribuidores internos de HeyGen: ejecuten scripts/upload-docs-images.sh (requiere el perfil de AWS engineering-767398024897)
  • Contribuidores externos: adjunten el MP4 de vista previa a la descripción de su PR. Un mantenedor generará y subirá la imagen del catálogo antes de fusionar.

Paso 6: Enviar

Todos los pasos son requeridos. Si falta alguno, se produce una entrada de catálogo rota.

{tipo} es blocks o components dependiendo de lo que construiste en el Paso 1.

# 1. Crear rama
git checkout -b feat/registry-{nombre}

# 2. Formatear HTML
npx oxfmt registry/{tipo}/{nombre}/*.html

# 3. Actualizar registry/registry.json — agregar entrada al array "items":
#    { "name": "{nombre}", "type": "hyperframes:block" }  (o "hyperframes:component")

# 4. Generar página de documentación del catálogo
npx tsx scripts/generate-catalog-pages.ts

# 5. Publicar en hyperframes.dev para que los revisores puedan previsualizar
npx hyperframes publish

# 6. Agregar todo al área de preparación
git add registry/{tipo}/{nombre}/ registry/registry.json docs/catalog/

# 7. Hacer commit
git commit -m "feat(registry): agrega {nombre} — {una frase}"

# 8. Subir y abrir PR con enlace a hyperframes.dev
git push origin feat/registry-{nombre}
gh pr create --title "feat(registry): {nombre}" --body "preview: {url-de-hyperframes-dev}"

Si no tienes una cuenta de GitHub: necesitas una para abrir una PR. Regístrate en https://github.com/signup, luego ejecuta gh auth login.

Puerta de calidad

  • hyperframes lint → 0 errores
  • hyperframes validate → 0 errores de consola
  • npx oxfmt --check pasa
  • registry/registry.json actualizado con nueva entrada
  • scripts/generate-catalog-pages.ts ejecutado (página de documentación generada)
  • npx hyperframes publish ejecutado (reclama tu URL del proyecto)
  • MP4 de vista previa adjunto a la PR (externo) o PNG del catálogo subido (interno)
  • Todos los IDs únicos y prefijados

Individual skills in this repo

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

shengdabai/Tony-Claude-Code-Skills

Downloads videos from YouTube and other platforms for offline viewing, editing, or archival. Handles various formats and quality options.

shengdabai/Tony-Claude-Code-Skills

接收抖音、小红书、微信视频号等短视频链接或分享文案,查询作品/账号数据并提取语音文字稿,按作者和标题归档为 Markdown。用户希望完整解析短视频、取得数据或文字稿时使用;运行前检查 TikHub 与轻抖使用凭证,缺少时用新手能理解的方式引导购买和安全配置。

shengdabai/Tony-Claude-Code-Skills

Read-only queue dashboard for workspace-aware ship. (gstack)

shengdabai/Tony-Claude-Code-Skills

Anime.js adapter patterns for HyperFrames. Use when writing Anime.js animations or timelines inside HyperFrames compositions, registering animations on window.__hfAnime, making Anime.js seek-driven and deterministic, or translating Anime.js examples into render-safe HyperFrames HTML.

shengdabai/Tony-Claude-Code-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.

shengdabai/Tony-Claude-Code-Skills

GSAP animation reference for HyperFrames. Covers gsap.to(), from(), fromTo(), easing, stagger, defaults, timelines (gsap.timeline(), position parameter, labels, nesting, playback), and performance (transforms, will-change, quickTo). Use when writing GSAP animations in HyperFrames compositions.

shengdabai/Tony-Claude-Code-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.

shengdabai/Tony-Claude-Code-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.

Skills relacionados