Communitygithub.com

shengdabai/Tony-Claude-Code-Skills

Padrões de adaptador Anime.js para HyperFrames. Use ao escrever animações ou timelines do Anime.js dentro de composições HyperFrames, registrando animações no `window.__hfAnime`, tornando o Anime.js orientado a seek e determinístico, ou traduzindo exemplos de Anime.js em HTML HyperFrames seguro para renderização.

O que é Tony-Claude-Code-Skills?

Esta skill fornece um adaptador de runtime para integrar o Anime.js com o sistema de composição HyperFrames. Ela permite que animações e timelines do Anime.js sejam controladas pelo clock determinístico do HyperFrames, em vez do relógio interno do Anime.js, garantindo que a reprodução seja orientada a seek e consistente em diferentes ambientes. A skill suporta tanto a versão clássica (IIFE) quanto builds de módulo ES do Anime.js, mantendo a compatibilidade com a API familiar. Seu principal benefício é permitir que desenvolvedores usem a sintaxe concisa do Anime.js para floreios em SVG e DOM dentro de composições HyperFrames, enquanto ainda depende do GSAP para sequenciamento complexo de cenas. Para usar, basta criar animações com `autoplay: false` durante a inicialização da composição, registrá-las no array `window.__hfAnime`, e o adaptador cuidará do resto, chamando `instance.seek(timeMs)` com o tempo atual do HyperFrames.

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

Perguntar na sua IA favorita

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

Documentação

Anime.js para HyperFrames

O HyperFrames pode controlar instâncias do Anime.js através de seu adaptador de runtime animejs. A composição é dona dos objetos de animação; o HyperFrames é dono do relógio.

Contrato

  • Crie animações ou timelines de forma síncrona durante a inicialização da composição.
  • Defina autoplay: false para que o Anime.js não avance com seu próprio relógio.
  • Registre cada animação ou timeline retornada em window.__hfAnime.
  • Use durações finitas e contagens de loop finitas.
  • Evite callbacks que mutem o DOM com base no tempo real (wall-clock), estado de rede ou aleatoriedade não seedada.

O adaptador chama instance.seek(timeMs) em cada instância registrada, onde timeMs é o tempo do HyperFrames em milissegundos.

Padrão Básico

<script src="https://cdn.jsdelivr.net/npm/[email protected]/lib/anime.iife.min.js"></script>
<script>
  const anim = anime({
    targets: ".mark",
    translateX: 280,
    rotate: "1turn",
    opacity: [0, 1],
    duration: 1200,
    easing: "easeOutExpo",
    autoplay: false,
  });

  window.__hfAnime = window.__hfAnime || [];
  window.__hfAnime.push(anim);
</script>

Padrão de Timeline

<script>
  const tl = anime.timeline({
    autoplay: false,
    easing: "easeOutCubic",
  });

  tl.add({
    targets: ".title",
    translateY: [40, 0],
    opacity: [0, 1],
    duration: 650,
  }).add(
    {
      targets: ".accent",
      scaleX: [0, 1],
      duration: 450,
    },
    250,
  );

  window.__hfAnime = window.__hfAnime || [];
  window.__hfAnime.push(tl);
</script>

Builds de Módulo

Se você usar um build de módulo ES, o adaptador não se importa como a instância foi criada. Ele só precisa que o objeto retornado exponha seek(), pause() e, preferencialmente, play():

<script type="module">
  import { animate } from "https://cdn.jsdelivr.net/npm/animejs/+esm";

  const anim = animate(".chip", {
    x: "18rem",
    duration: 900,
    autoplay: false,
  });

  window.__hfAnime = window.__hfAnime || [];
  window.__hfAnime.push(anim);
</script>

Bons Usos

  • Pequenos floreios em SVG e DOM onde a sintaxe do Anime.js é compacta.
  • Exemplos de Anime.js importados que podem ser tornados orientados a seek.
  • Múltiplas micro-animações independentes enviadas para o mesmo registro.

Use GSAP para sequenciamento complexo de cenas, a menos que o usuário peça especificamente pelo Anime.js. GSAP ainda é o caminho principal de autoria do HyperFrames.

Evite

  • Deixar autoplay no padrão do Anime.js.
  • Depender da descoberta automática anime.running em vez de window.__hfAnime.push(...) explícito.
  • Loops infinitos. Calcule uma contagem de repetição finita a partir da duração da composição.
  • Construir animações em timers, promises, manipuladores de eventos ou após cargas de assets assíncronas.

Validação

Após editar uma composição que usa Anime.js:

npx hyperframes lint
npx hyperframes validate

Créditos e Referências

  • Fonte do adaptador HyperFrames: packages/core/src/runtime/adapters/animejs.ts.
  • Documentação do Anime.js para autoplay, pause() e seek(): https://animejs.com/documentation/

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

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

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