Communitygithub.com

HyperFrames 用 CSS アニメーション

HyperFrames 向け CSS アニメーションアダプターのパターン集。CSS キーフレーム、animation-delay ベースのタイミング、animation-fill-mode、animation-play-state、または HyperFrames がプレビューおよびレンダリング中に決定的にシークする必要がある CSS のみのモーションを作成する際に使用します。

HyperFrames 用 CSS アニメーション とは?

このスキルは、HyperFrames プラットフォームで CSS キーフレームアニメーションを扱うためのパターンとベストプラクティスを提供します。HyperFrames は CSS ランタイムアダプターを通じてキーフレームアニメーションをシークでき、背景の動き、きらめき、グロー、マスク、装飾など、シンプルで繰り返しのモーションパターンに最適です。このスキルは、アニメーション要素を DOM に追加するタイミングや、`data-start` 属性を使用してアニメーション時間をクリップに一致させる方法など、重要なコントラクトをカバーしています。また、決定的なシークを保証するために、有限の `animation-duration` と `animation-iteration-count` を使用する必要性や、`animation-fill-mode: both` を使用してアクティブモーションの前後で状態を保持することを推奨します。アダプターは要素の計算された `animation-name` を見つけ、利用可能な場合はブラウザの `Animation` ハンドルをシークし、それ以外の場合は負の `animation-delay` で一時停止します。スキルには基本パターン、CSS カスタムプロパティを使用したスタッガーパターン、使用例と避けるべき例、および検証コマンドが含まれています。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/delorenj/skills/tree/HEAD/css-animations

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

HyperFrames 用 CSS アニメーション は何をしますか?

HyperFrames は css ランタイムアダプターを通じて CSS キーフレームアニメーションをシークできます。シンプルな繰り返しのモチーフ、背景の動き、きらめき、グロー、マスク、およびシーケンス化されていない装飾に使用します。

シーンの振り付けには、通常 GSAP の方が明確です。CSS アニメーションは、モーションが単一の要素に属し、固定された持続時間を持つ場合に最適に機能します。

コントラクト

  • アニメーション要素をランタイム初期化が完了する前に DOM に配置します。
  • タイミング付き要素に data-start 値を設定し、ローカルアニメーション時間をクリップに一致させます。
  • 有限の animation-duration と animation-iteration-count を使用します。負の delay フォールバックでは、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.

関連スキル