Communitygithub.com

shengdabai/Tony-Claude-Code-Skills

Padrões de adaptação de animação CSS para HyperFrames. Use ao criar keyframes CSS, temporização baseada em animation-delay, animation-fill-mode, animation-play-state ou movimento somente CSS que o HyperFrames deve buscar deterministicamente durante pré-visualização e renderização.

O que é Tony-Claude-Code-Skills?

Este skill fornece padrões e diretrizes para usar animações CSS dentro do framework HyperFrames, permitindo que animações CSS keyframe sejam buscadas deterministicamente durante pré-visualização e renderização. Ele suporta a criação de animações decorativas simples, como loops de fundo, shimmer, glow, máscaras e efeitos de paralaxe, sem a necessidade de timelines JavaScript complexas. O skill define contratos claros: colocar o elemento animado no DOM antes da inicialização do runtime, usar valores `data-start` para sincronizar o tempo local da animação com o clipe, e evitar animações infinitas ou dependentes de interação do usuário. Ele também inclui padrões básicos e stagger (escalonamento), validação via comandos CLI, e referências à documentação oficial do MDN para CSS Animation. É ideal para desenvolvedores que desejam adicionar animações CSS eficientes e previsíveis em projetos HyperFrames, especialmente para efeitos que pertencem a um único elemento com duração fixa.

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

Perguntar na sua IA favorita

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

Documentação

Animações CSS para HyperFrames

O HyperFrames pode buscar animações CSS keyframe por meio de seu adaptador de runtime css. Use isso para motivos repetidos simples, movimento de fundo, shimmer, brilho, máscaras e decoração não sequenciada.

Para coreografia de cena, o GSAP geralmente é mais claro. As animações CSS funcionam melhor quando o movimento pertence a um único elemento e tem uma duração fixa.

Contrato

  • Coloque o elemento animado no DOM antes da inicialização do runtime terminar.
  • Dê aos elementos temporizados um valor data-start para que o tempo da animação local corresponda ao clipe.
  • Use animation-duration e animation-iteration-count finitos porque a alternativa de delay negativo não pode representar duração ilimitada em ambientes sem animações CSS com suporte a WAAPI.
  • Prefira animation-fill-mode: both para que os estados buscados sejam mantidos antes e depois do movimento ativo.
  • Evite JavaScript baseado em relógio de parede, estado acionado por hover e alternâncias de classe que dependem de eventos do usuário.

O adaptador descobre elementos com animation-name computada, busca seus handles Animation do navegador quando disponíveis e recorre à pausa com animation-delay negativo.

Padrão Básico

<div
  id="pulse-ring"
  class="clip pulse-ring"
  data-start="0"
  data-duration="4"
  data-track-index="2"
></div>

<style>
  .pulse-ring {
    width: 280px;
    height: 280px;
    border: 4px solid rgba(255, 255, 255, 0.7);
    border-radius: 50%;
    animation-name: pulse-ring;
    animation-duration: 1200ms;
    animation-timing-function: cubic-bezier(0.2, 0, 0, 1);
    animation-iteration-count: 3;
    animation-fill-mode: both;
  }

  @keyframes pulse-ring {
    from {
      opacity: 0;
      transform: scale(0.82);
    }
    35% {
      opacity: 1;
    }
    to {
      opacity: 0;
      transform: scale(1.18);
    }
  }
</style>

Padrão Stagger (Escalonamento)

Use propriedades personalizadas CSS para evitar duplicar keyframes:

<div class="clip dots" data-start="1" data-duration="3" data-track-index="3">
  <span style="--i: 0"></span>
  <span style="--i: 1"></span>
  <span style="--i: 2"></span>
</div>

<style>
  .dots span {
    display: inline-block;
    width: 18px;
    height: 18px;
    margin-right: 10px;
    border-radius: 50%;
    background: currentColor;
    animation: dot-pop 900ms ease-out both;
    animation-delay: calc(var(--i) * 120ms);
  }

  @keyframes dot-pop {
    from {
      opacity: 0;
      transform: translateY(18px) scale(0.75);
    }
    to {
      opacity: 1;
      transform: translateY(0) scale(1);
    }
  }
</style>

Bons Usos

  • Loops decorativos com um número conhecido de repetições.
  • Máscara, brilho, shimmer, granulação e camadas de paralaxe sutis.
  • Entradas simples de um único elemento onde uma timeline JavaScript completa seria excessiva.

Evite

  • Animações CSS infinitas a menos que você tenha verificado que o navegador expõe handles de animação CSS buscáveis com suporte a WAAPI. Prefira um número finito de iterações cobrindo a duração visível.
  • Animar propriedades de layout como top, left, width ou height quando transformações funcionam.
  • Depender de hover, foco, rolagem ou media queries para acionar movimento crítico para renderização.
  • Alterar classes de animação após a inicialização, a menos que outra timeline determinística controle essa mudança.

Validação

Após editar composições de animação CSS:

npx hyperframes lint
npx hyperframes validate

Créditos e Referências

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

Author a new HyperFrames registry block (caption style, VFX block, transition, lower third) or component (text effect, overlay, snippet) and ship it as an upstream PR to the hyperframes repo. Use ONLY when the user wants to CONTRIBUTE to the public catalog — for in-project caption/transition authoring use the `hyperframes` skill, for installing existing registry items use the `hyperframes-registry` skill.

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