Communitygithub.com

shengdabai/Tony-Claude-Code-Skills

Crie um novo bloco ou componente do registro HyperFrames e envie-o como um PR upstream para o repositório hyperframes. Use SOMENTE quando o usuário quiser CONTRIBUIR para o catálogo público — para criação de legendas/transições em projeto, use a habilidade `hyperframes`; para instalar itens existentes do registro, use a habilidade `hyperframes-registry`.

O que é Tony-Claude-Code-Skills?

Esta habilidade permite que um agente de IA (como Claude Code) guie o usuário por todo o fluxo de contribuição ao catálogo público do HyperFrames, desde a clarificação da ideia até o envio de um Pull Request (PR) para o repositório upstream. Ela suporta a criação de dois tipos de itens: **Blocos** (composições completas com dimensões e duração fixas, como estilos de legenda, efeitos VFX e vinhetas inferiores) e **Componentes** (snippets reutilizáveis sem dimensões fixas, como efeitos de texto, sobreposições ou trechos adaptáveis). A habilidade é útil para desenvolvedores que desejam contribuir com assets de mídia reutilizáveis para a comunidade, garantindo que sigam as convenções de nomenclatura, estrutura de diretórios e validação do projeto. O fluxo de trabalho inclui etapas como scaffolding, construção (com regras específicas para animação de legendas e uso de Three.js para VFX), validação com ferramentas CLI, preview via renderização e snapshot, e finalmente, a submissão do PR com todas as etapas obrigatórias para evitar entradas quebradas no catálogo.

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

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

Contribuir para o Registro HyperFrames

Guie o usuário desde a ideia até um PR mesclado para um novo bloco ou componente do registro.

Fluxo de Trabalho

1. Clarificar → 2. Estruturar → 3. Construir → 4. Validar → 5. Pré-visualizar → 6. Enviar

Etapa 1: Clarificar

Pergunte o que eles estão construindo. O registro tem dois tipos de itens:

  • Bloco (registry/blocks/, tipo hyperframes:block) — uma composição completa e independente com dimensões e duração fixas. Estilos de legenda, efeitos VFX, cartelas de título, vinhetas inferiores.
  • Componente (registry/components/, tipo hyperframes:component) — um snippet reutilizável sem dimensões ou duração fixas. Efeitos CSS, tratamentos de texto, sobreposições que se adaptam a qualquer tamanho de composição.

Depois, pergunte:

  • Descrição em uma frase do efeito
  • Referência visual (URL, captura de tela ou descrição)
  • Quem usa isso e quando?

Etapa 2: Estruturar

Crie a estrutura do registro:

Para blocos:

registry/blocks/{nome-do-bloco}/
  {nome-do-bloco}.html
  registry-item.json

Para componentes:

registry/components/{nome-do-componente}/
  {nome-do-componente}.html
  registry-item.json

Convenção de nomenclatura:

Nome do itemPrefixo do IDExemplos de IDs
cap-hormozihzhz-cg-0, hz-cw-3
cap-typewritertwtw-cg-0, tw-ch-0-5
vfx-chromevcvc-canvas

Use um prefixo de 2 a 3 letras. TODOS os IDs de elementos DEVEM usar este prefixo para evitar colisões em subcomposições.

registry-item.json para blocos:

{
  "$schema": "https://hyperframes.heygen.com/schema/registry-item.json",
  "name": "{nome-do-bloco}",
  "type": "hyperframes:block",
  "title": "{Título Humano}",
  "description": "{uma frase}",
  "dimensions": { "width": 1920, "height": 1080 }, // ajuste: 1080x1920 para retrato/redes sociais
  "duration": 10, // ajuste para sua composição
  "tags": ["{categoria}", "{subcategoria}"],
  "files": [
    {
      "path": "{nome-do-bloco}.html",
      "target": "compositions/{nome-do-bloco}.html",
      "type": "hyperframes:composition"
    }
  ]
}

registry-item.json para componentes (sem dimensions ou duration):

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

Etapa 3: Construir

Aplique o modelo correto com base no tipo. Consulte templates.md para iniciadores de copiar e colar.

Blocos de legenda

Regras de legenda não negociáveis:

  • Fonte: Mínimo de 96px para fontes proporcionais. 64–72px aceitável para monoespaçadas (caracteres mais largos precisam de menos tamanho).
  • Legibilidade: -webkit-text-stroke: 2-3px OU text-shadow em múltiplas camadas
  • Estouro: chame window.__hyperframes.fitTextFontSize() em cada grupo
  • Karaokê: destaque a palavra ativa via tl.to(wordEl, { color/scale }, WORDS[wi].start)
  • Parada forçada: tl.set(groupEl, { opacity: 0, visibility: "hidden" }, g.end) em CADA grupo
  • Nunca use tl.from(el, { opacity: 0 }) na mesma posição de tl.set(el, { opacity: 1 }) — o from sobrescreve o set. Use tl.to.

Animação por caractere (máquina de escrever, embaralhamento):

  • Envolva cada caractere em <span> com ID {prefixo}-ch-{grupo}-{caractere}
  • Escalone via tl.set em intervalos calculados a partir dos timestamps das palavras
  • Cursores/elementos decorativos: use tl.set em intervalos — NÃO animação CSS (não buscável)

Variantes de posicionamento:

  • Centralizado: display: flex; align-items: center; justify-content: center;
  • Terço inferior: position: absolute; bottom: 100px; left: 0; width: 100%; text-align: center;
  • Alinhado à esquerda: position: absolute; bottom: 100px; left: 120px; text-align: left;

Blocos VFX (Three.js)

  • Use [email protected] do CDN (script global)
  • tl.eventCallback("onUpdate", renderScene); renderScene(); — NÃO use requestAnimationFrame
  • Padrão de proxy de estado: GSAP anima um objeto JavaScript simples, a função de renderização o lê
  • PRNG com semente (mulberry32) para aleatoriedade

Todos os tipos

  • data-composition-id DEVE corresponder a window.__timelines["id"]
  • Todos os IDs de elementos prefixados com a abreviação do bloco
  • gsap.timeline({ paused: true }) — sempre pausada
  • Sem Math.random(), sem Date.now()

Etapa 4: Validar

hyperframes lint                    # 0 erros obrigatórios
hyperframes validate --no-contrast  # 0 erros de console obrigatórios

Etapa 5: Visualizar

# Renderizar vídeo de pré-visualização
hyperframes render -o preview.mp4

# Snapshot para QA visual
hyperframes snapshot --at "1.0,3.0,5.0,7.0"

# Publicar em hyperframes.dev para revisão
npx hyperframes publish

Imagem de pré-visualização do catálogo — O cartão do catálogo usa um PNG em docs/images/catalog/{kind}/{name}.png (onde {kind} é blocks ou components). Gere a partir de um snapshot, então:

  • Colaboradores internos da HeyGen: execute scripts/upload-docs-images.sh (requer perfil AWS engineering-767398024897)
  • Colaboradores externos: anexe o MP4 de pré-visualização à descrição do seu PR. Um mantenedor gerará e fará o upload da imagem do catálogo antes de mesclar.

Etapa 6: Enviar

Todas as etapas são obrigatórias. A falta de qualquer uma produz uma entrada quebrada no catálogo.

{kind} é blocks ou components dependendo do que você construiu na Etapa 1.

# 1. Criar branch
git checkout -b feat/registry-{nome}

# 2. Formatar HTML
npx oxfmt registry/{kind}/{nome}/*.html

# 3. Atualizar registry/registry.json — adicionar entrada ao array "items":
#    { "name": "{nome}", "type": "hyperframes:block" }  (ou "hyperframes:component")

# 4. Gerar página de documentação do catálogo
npx tsx scripts/generate-catalog-pages.ts

# 5. Publicar em hyperframes.dev para que revisores possam visualizar
npx hyperframes publish

# 6. Preparar tudo
git add registry/{kind}/{nome}/ registry/registry.json docs/catalog/

# 7. Commitar
git commit -m "feat(registry): adicionar {nome} — {uma frase}"

# 8. Empurrar e abrir PR com link do hyperframes.dev
git push origin feat/registry-{nome}
gh pr create --title "feat(registry): {nome}" --body "preview: {hyperframes.dev-url}"

Se você não tiver uma conta GitHub: você precisa de uma para abrir um PR. Cadastre-se em https://github.com/signup, depois execute gh auth login.

Portão de Qualidade

  • hyperframes lint → 0 erros
  • hyperframes validate → 0 erros de console
  • npx oxfmt --check passa
  • registry/registry.json atualizado com nova entrada
  • scripts/generate-catalog-pages.ts executado (página de documentação gerada)
  • npx hyperframes publish executado (reivindique a URL do seu projeto)
  • MP4 de pré-visualização anexado ao PR (externo) ou PNG do catálogo enviado (interno)
  • Todos os IDs únicos e prefixados

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.

Habilidades Relacionadas