Communitygithub.com

shengdabai/Tony-Claude-Code-Skills

CSS 애니메이션 어댑터 패턴 for HyperFrames. CSS 키프레임, animation-delay 기반 타이밍, animation-fill-mode, animation-play-state, 또는 HyperFrames가 프리뷰 및 렌더링 중에 결정론적으로 탐색해야 하는 CSS 전용 모션을 작성할 때 사용합니다.

Tony-Claude-Code-Skills란 무엇인가요?

이 스킬은 HyperFrames에서 CSS 키프레임 애니메이션을 결정론적으로 탐색(seek) 가능하게 해주는 어댑터 패턴을 제공합니다. CSS `animation-delay`를 음수로 설정하는 폴백 방식을 통해 WAAPI(Web Animations API)를 지원하지 않는 환경에서도 애니메이션의 특정 시점을 정확히 제어할 수 있습니다. 애니메이션이 적용된 요소는 DOM에 런타임 초기화 전에 존재해야 하며, `data-start` 속성으로 로컬 애니메이션 시간을 클립 시간과 동기화해야 합니다. 주로 반복되는 장식적 모션, 배경 움직임, 쉬머, 글로우, 마스크 등 단순하고 고정된 지속 시간을 가진 효과에 적합하며, 복잡한 씬 연출에는 GSAP를 권장합니다. CSS 전용 애니메이션을 HyperFrames의 런타임 프리뷰 및 최종 렌더링과 일관되게 동작하도록 설계되었습니다. 유한한 `animation-duration`과 `animation-iteration-count`를 사용하고, `animation-fill-mode: both`를 선호하며, 호버, 포커스, 스크롤 등 사용자 이벤트에 의존하는 모션은 피해야 합니다.

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

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

HyperFrames용 CSS 애니메이션

HyperFrames는 css 런타임 어댑터를 통해 CSS 키프레임 애니메이션을 탐색(seek)할 수 있습니다. 단순 반복 모티프, 배경 모션, 쉬머, 글로우, 마스크, 비순차 장식에 사용하세요.

씬 연출에는 GSAP가 일반적으로 더 명확합니다. CSS 애니메이션은 모션이 하나의 요소에 속하고 고정된 지속 시간을 가질 때 가장 잘 작동합니다.

규약

  • 애니메이션 요소를 런타임 초기화가 완료되기 전에 DOM에 배치하세요.
  • 시간이 지정된 요소에 data-start 값을 부여하여 로컬 애니메이션 시간이 클립과 일치하도록 하세요.
  • 유한한 animation-duration과 animation-iteration-count를 사용하세요. 음수 지연 폴백은 WAAPI 기반 CSS 애니메이션이 없는 환경에서 무제한 지속 시간을 표현할 수 없기 때문입니다.
  • animation-fill-mode: both를 선호하여 탐색된 상태가 활성 모션 전후에 유지되도록 하세요.
  • 벽시계 자바스크립트, 호버 트리거 상태, 사용자 이벤트에 의존하는 클래스 토글을 피하세요.

어댑터는 계산된 animation-name을 가진 요소를 찾고, 가능한 경우 브라우저 Animation 핸들을 탐색하며, 그렇지 않으면 음수 animation-delay로 일시 중지하는 폴백을 사용합니다.

기본 패턴

<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>

스태거 패턴

CSS 사용자 정의 속성을 사용하여 키프레임을 중복 작성하지 마세요:

<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>

좋은 사용 예

  • 반복 횟수가 알려진 장식적 루프.
  • 마스크, 글로우, 쉬머, 그레인, 미묘한 시차 레이어.
  • 전체 JS 타임라인이 과도한 간단한 단일 요소 진입.

피해야 할 것

  • 브라우저가 탐색 가능한 WAAPI 기반 CSS 애니메이션 핸들을 노출하는지 확인하지 않은 무한 CSS 애니메이션. 보이는 지속 시간을 포함하는 유한 반복 횟수를 선호하세요.
  • top, left, width, height와 같은 레이아웃 속성을 애니메이션화하는 경우(트랜스폼이 동작할 때).
  • 호버, 포커스, 스크롤 또는 미디어 쿼리에 의존하여 렌더링에 중요한 모션을 트리거하는 경우.
  • 시작 후 애니메이션 클래스를 변경하는 경우(다른 결정론적 타임라인이 그 변경을 제어하지 않는 한).

검증

CSS 애니메이션 구성을 편집한 후:

npx hyperframes lint
npx hyperframes validate

크레딧 및 참고 자료

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.

관련 스킬