Communitygithub.com

delorenj/skills

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

skills란 무엇인가요?

이 스킬은 HyperFrames 플랫폼에서 CSS 애니메이션을 사용하는 방법을 설명합니다. HyperFrames의 `css` 런타임 어댑터를 통해 CSS 키프레임 애니메이션을 탐색(seek)할 수 있어, 반복적인 장식 모션, 배경 움직임, 광택, 글로우, 마스크 등에 적합합니다. 복잡한 씬 연출에는 GSAP이 더 명확하지만, 단일 요소에 고정된 지속 시간의 모션을 적용할 때는 CSS 애니메이션이 유용합니다. 어댑터는 `animation-name`이 계산된 요소를 찾아 브라우저 `Animation` 핸들을 탐색하거나, 대체로 `animation-delay` 음수 값을 사용하여 일시 중지합니다. 유한한 `animation-duration`과 `animation-iteration-count`를 사용하고, `animation-fill-mode: both`를 선호하며, 시계 시간이나 사용자 이벤트에 의존하는 자바스크립트를 피해야 합니다. 무한 CSS 애니메이션은 WAAPI 지원 환경에서만 사용하고, 레이아웃 속성보다는 transform을 사용하는 것이 좋습니다.

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

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

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

문서

HyperFrames용 CSS 애니메이션

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

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

계약

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

어댑터는 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 애니메이션. 가시 지속 시간을 포함하는 유한 반복 횟수를 선호하세요.
  • 변형(transform)이 가능할 때 top, left, width 또는 height와 같은 레이아웃 속성 애니메이션.
  • 호버, 포커스, 스크롤 또는 미디어 쿼리에 의존하여 렌더링에 중요한 모션을 트리거하는 경우.
  • 시작 후 애니메이션 클래스를 변경하는 경우. 다른 결정적 타임라인이 해당 변경을 제어하지 않는 한.

검증

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

npx hyperframes lint
npx hyperframes validate

크레딧 및 참고 자료

Individual skills in this repo

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

delorenj/skills

Plan and generate terminal ASCII animations/screensaver-style output (FPS, refresh rules, loop policy, low-flicker guidance), with a static poster frame and an optional local demo script.

delorenj/skills

ASCII video: convert video/audio to colored ASCII MP4/GIF.

delorenj/skills

Plan, build and quality-check a premium short commercial for a real business (roofing, property, ecommerce, B2B software) using AI-generated footage, code-built motion (HTML/GSAP), selective Three.js and an independent-critic "Gauntlet" loop. Use when asked to make a launch-style / SaaS-style video, business ad, explainer, sample reel or pitch video, or to review and improve one. Encodes motion principles distilled from 28 professional launch films, a quality bar, audio rules and a business-offer playbook.

delorenj/skills

Generate professional voiceovers using ElevenLabs AI. Use when the user needs to create voiceovers for videos, audio narration, or text-to-speech content. Supports multiple voices with character presets (narrator, salesperson, expert) for natural delivery. Includes single scene regeneration for fine-tuning.

delorenj/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.

delorenj/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.

delorenj/skills

Install and wire registry blocks and components into HyperFrames compositions. Use when running hyperframes add, installing a block or component, wiring an installed item into index.html, or working with hyperframes.json. Covers the add command, install locations, block sub-composition wiring, component snippet merging, and registry discovery.

delorenj/skills

Create video compositions, animations, title cards, overlays, captions, voiceovers, audio-reactive visuals, and scene transitions in HyperFrames HTML. Use when asked to build any HTML-based video content, add captions or subtitles synced to audio, generate text-to-speech narration, create audio-reactive animation (beat sync, glow, pulse driven by music), add animated text highlighting (marker sweeps, hand-drawn circles, burst lines, scribble, sketchout), or add transitions between scenes (crossfades, wipes, reveals, shader transitions). Covers composition authoring, timing, media, and the full video production workflow. For dev-loop CLI commands (init, lint, inspect, preview, render) see the hyperframes-cli skill; for asset preprocessing commands (tts, transcribe, remove-background) see the hyperframes-media skill.

delorenj/skills

Manim CE animations: 3Blue1Brown math/algo videos.

delorenj/skills

Join a Google Meet or Zoom call as a video meeting agent via PikaStreaming. Trigger: user drops a Google Meet or Zoom link, or asks to join a meeting.

delorenj/skills

Translate an existing Remotion (React-based) video composition into a HyperFrames HTML composition. Use ONLY when the user explicitly asks to port, convert, migrate, translate, or rewrite a Remotion composition as HyperFrames (e.g. "port my Remotion project to HyperFrames"). Do NOT use when (a) authoring a NEW HyperFrames composition (even if A/B-testing a Remotion video); (b) Remotion is mentioned in passing; (c) Remotion code is shared as reference, not for translation; (d) the user wants "the same video as my Remotion one" without explicitly asking to migrate the source — treat as a fresh HyperFrames build. When in doubt, default to the `hyperframes` skill. Detects unsupported patterns (useState, useEffect side effects, async calculateMetadata, third-party React component libraries, `@remotion/lambda`) and recommends the runtime interop escape hatch instead of a lossy translation.

delorenj/skills

Generate speech using the self-hosted voxxy (vox) TTS service at https://vox.delo.sh. Use when the user asks to speak, say, narrate, synthesize speech, clone a voice, create a voice, add or register a voice, pipe TTS, or control voice qualities by description (e.g. "a young woman with a cheerful voice"). Handles HTTP API usage, voice profile management, description-based voice design, cloning, MCP registration, and integration patterns for new platforms.

delorenj/skills

Capture a website and create a HyperFrames video from it. Use when: (1) a user provides a URL and wants a video, (2) someone says "capture this site", "turn this into a video", "make a promo from my site", (3) the user wants a social ad, product tour, or any video based on an existing website, (4) the user shares a link and asks for any kind of video content. Even if the user just pastes a URL — this is the skill to use.

delorenj/skills

YouTube transcripts to summaries, threads, blogs.

관련 스킬