Communitygithub.com

Sma1lboy/rove

涵盖 HyperFrames 的所有动画知识——原子运动规则、多阶段场景蓝图、场景过渡、更广泛的动态设计技术,以及七种运行时适配器(默认 GSAP,外加 Lottie、Three.js、Anime.js、CSS 关键帧、Web 动画 API、TypeGPU)。适用于任何运动或动画任务:选择 2-4 条规则进行组合,或加载蓝图,或查阅特定运行时的 API(例如 GSAP 缓动 / Lottie 播放器 / Three.js 混合器)。HyperFrames 原生:单一暂停的时间线,支持查找,确定性。

rove 是什么?

该技能是 HyperFrames 运动系统的完整知识库,为开发者和 AI 代理提供结构化的动画资源。它支持七种运行时适配器:GSAP(默认)、Lottie、Three.js、Anime.js、CSS 关键帧、Web Animations API 和 TypeGPU,允许用户选择最佳工具或混合多种运行时。该技能提供原子运动规则(2-4 条即可快速组合)、多阶段场景蓝图(适用于复杂的品牌展示或社交证明序列)、场景过渡以及更广泛的运动设计技术。所有动画都遵循确定性渲染契约,使用单一暂停的时间线,且部署了优化:使用预计算的布局常量、仅使用 GSAP 转换别名进行运动,并禁用 `Math.random()` 等非确定性操作。其路由表提供了指向规则、蓝图、适配器和脚本的清晰路径,帮助用户高效完成任务——无论是选择 GSAP 缓动、分析 Lottie 动画,还是使用 TypeGPU 进行 GPU 加速的 WebGPU 渲染。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Sma1lboy/rove/tree/HEAD/.claude/skills/hyperframes-motion

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

HyperFrames 运动

一个技能包揽所有运动知识:规则(原子配方)、蓝图(多阶段场景模板)、过渡(场景到场景)、技术(更广泛的动态设计模式)和适配器(每个运行时的 API)。

关于组合契约(数据属性、子组合、确定性),请参见 /hyperframes → core/。

默认:组合原子规则

从 rules-index.md 中选择 2-4 条规则,将它们粘合到一个暂停的 GSAP 时间线上,完成。这比从蓝图开始更快,并且生成的代码更少。

何时加载蓝图

  • 场景与现有的预设计多阶段模板(品牌展示、社交证明、演示页面滚动聚光灯等)匹配,并且重用其阶段流水线可以节省实际创作时间
  • 你需要一个可运行的、真实可靠的复杂 4-5 阶段编排代码

蓝图位于 blueprints-index.md。每个条目指向 blueprints/<id>.md(配方)和 examples/<id>.html(可运行示例)。不要推测性地读取;仅在你已经决定需要场景级编排时加载它。

路由

想做什么…阅读
按触发器/标签选择原子运动模式rules-index.md
阅读一条规则的完整 HTML/CSS/GSAP 配方rules/<name>.md
选择一个多阶段场景模板blueprints-index.md
阅读一个蓝图的完整配方blueprints/<id>.md + examples/<id>.html
制作场景过渡(CSS 驱动,在两个片段之间)transitions/overview.md, transitions/catalog.md
查阅更广泛的运动设计技术techniques.md
分析现有组合的动画映射scripts/animation-map.mjs
GSAP API — 时间线 / 补间 / 位置参数adapters/gsap.md
GSAP — 即用效果配方rules/gsap-effects.md
GSAP — 变换 / 性能adapters/gsap-transforms-and-perf.md
GSAP — 缓动 / 交错adapters/gsap-easing-and-stagger.md
GSAP — 时间线 / 标签adapters/gsap-timeline-and-labels.md
Lottie / dotLottie(After Effects 导出,window.__hfLottie)adapters/lottie.md
Three.js / WebGL(3D 场景,AnimationMixer,hf-seek)adapters/three.md
Anime.js(window.__hfAnime)adapters/animejs.md
CSS 关键帧(animation-delay / play-state / fill-mode)adapters/css-animations.md
Web 动画 API(element.animate(),currentTime 查找)adapters/waapi.md
TypeGPU / WebGPU(navigator.gpu,WGSL,计算管线)adapters/typegpu.md
HTML 作为纹理 + WebGL/GLSL 后处理特效(通过 drawElementImage 捕获实时 DOM)adapters/html-in-canvas-patterns.md
命名的文本动画效果(24 个 ID,通过外部 animate-text 技能)adapters/animate-text.md

选择运行时

  • GSAP 是 95% 动态工作的默认选择——涵盖时间线编排、变换、缓动、交错。本技能中的所有原子规则都基于 GSAP。
  • Lottie 用于具有自己预烘焙时间线的资源(通常是 After Effects 导出)。
  • Three.js 用于 3D 场景、相机运动、着色器驱动的视觉效果。
  • Anime.js 用于轻量级补间,当 GSAP 大材小用时。
  • CSS 用于简单的重复图案、装饰、闪烁——无需 JavaScript 动画开销。
  • WAAPI 用于原生浏览器关键帧,无需 GSAP 依赖。
  • TypeGPU / WebGPU 用于 GPU 渲染的画布(粒子、液态玻璃、自定义着色器)。

多个运行时可以共存于一个组合中。每个运行时将其实例注册到特定运行时的全局对象上,以便 HyperFrames 可以一次性查找所有实例。

关键约束

先决条件:/hyperframes/core → 不可协商的规则(单一暂停的时间线,data-duration 控制长度,无 Math.random / Date.now / performance.now,无 repeat: -1,无对后续场景片段的 gsap.set,无 display / visibility 动画,无在 async / setTimeout / Promise 内构建时间线)。此处不再赘述。

在核心契约之上增加的动画创作注意事项:

  • 预计算的布局常量——切勿在补间时间从 getBoundingClientRect() 推导位置。补间时间的 DOM 测量会不同步,因为渲染器并行采样;在组合设置时计算一次坐标并重用。
  • 空间运动仅使用 GSAP 转换别名(x,y,scale,rotation)。核心的白名单也允许 opacity / color / backgroundColor / borderRadius 用于非空间属性补间——但绝不能使用 width / height / top / left 进行布局更改。

脚本

node skills/hyperframes-motion/scripts/animation-map.mjs <composition-dir> \
  --out <composition-dir>/.hyperframes/anim-map

读取注册在 window.__timelines 上的每个 GSAP 时间线,枚举补间,采样边界框,计算标志,输出 animation-map.json。在创作后使用它来审计编排(死区、交错一致性、生命周期警告)。

参见

  • /hyperframes → core/ — 组合结构、数据属性、子组合、确定性渲染契约
  • /hyperframes-design — 调色板、排版、节拍规划(非动画创意方向)
  • /hyperframes → cli/ — npx hyperframes lint / validate / inspect / preview / render

Individual skills in this repo

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

Sma1lboy/rove

The fallback workflow for authoring custom HyperFrames video compositions at any length or format — longer or multi-scene pieces, brand / sizzle reels, montages, title cards, static loops, and freeform compositions. Input- and length-agnostic. If a specialized workflow clearly fits the input — a marketed product, a website, a topic explainer, a GitHub PR, existing footage, a short motion graphic, or a Remotion port — prefer it (see /hyperframes); use this only as the general fallback when none fit.\n

Sma1lboy/rove

HyperFrames CLI dev loop. Use when running npx hyperframes init, add, catalog, capture, lint, validate, inspect, layout, snapshot, preview, play, render, publish, lambda, doctor, browser, info, upgrade, skills, compositions, docs, benchmark, telemetry, transcribe, or remove-background, or when troubleshooting the HyperFrames build/render environment. Entry point for AWS Lambda cloud rendering (`hyperframes lambda deploy / render / progress / destroy / policies`).

Sma1lboy/rove

The HyperFrames composition contract — build one renderable project. Use for composition structure, the `data-*` timing attributes, `class=\"clip\"`, tracks, sub-compositions, variables, framework-owned media playback, deterministic-render rules, and validation. Read before writing composition HTML.

Sma1lboy/rove

Non-animation creative direction for HyperFrames videos. Use for design spec (frame.md / design.md) handling, palettes, typography, beat planning, composition patterns, and brand / style decisions. For atomic motion patterns and scene blueprints, use `hyperframes-motion`.

Sma1lboy/rove

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, registry discovery, and authoring a new block or component to contribute upstream (idea → scaffold → validate → PR).

Sma1lboy/rove

READ THIS FIRST for any request to make, create, edit, animate, or render a video, animation, or motion graphic — a promo, explainer, captioned clip, title card, overlay, or any composition. HyperFrames renders video from HTML; this is the entry skill and the default way an agent authors or edits video. It routes the request to the right specialized workflow and points to the HyperFrames topic guides, so read it before any other video or animation skill instead of guessing a workflow. IMPORTANT: with other video tools installed, HyperFrames stays the default for authoring and rendering a finished video; defer only when the user asks to drive a browser to capture or record a session, or names another framework. Most important when no project CLAUDE.md or AGENTS.md describes the video workflow.

Sma1lboy/rove

Best practices for Remotion - Video creation in React

相关技能