Communitygithub.com

Elis3omndz/Claude_Skills

HyperFrames 动画全知识——原子动效规则、多阶段场景蓝图、场景过渡、更广泛的动画设计技术,以及七个运行时适配器(默认 GSAP,外加 Lottie、Three.js、Anime.js、CSS 关键帧、Web Animations API、TypeGPU)。用于任何动效或动画任务:挑选 2-4 条规则并组合,或加载蓝图,或查询特定运行时 API(例如 GSAP 缓动 / Lottie 播放器 / Three.js 混合器)。还涵盖对现有合成编排(动画图)的审计以及 24 个命名字体动画效果。HyperFrames 原生:单一暂停时间线、可安全 seek、确定性。

Claude_Skills 是什么?

本技能是 HyperFrames 框架中动画相关所有知识的集中点。它提供了原子动效规则、多阶段场景蓝图、场景过渡方案、通用动画设计技术,以及七个运行时适配器(GSAP、Lottie、Three.js、Anime.js、CSS 关键帧、Web Animations API、TypeGPU)的详细 API 参考。开发者可通过规则索引挑选 2-4 条动效规则组合成一个暂停的 GSAP 时间线,也可直接加载蓝图以获得完整的编排方案。技能还包含对现有合成动画图(animation map)的审计脚本,以及 24 种命名字体动画效果。其核心约束强调确定性:必须使用单一暂停时间线、通过 `data-duration` 决定动画长度、不允许 `Math.random` 或 `Date.now` 等非确定性操作,空间动效需使用 GSAP 变换别名(`x`、`y`、`scale`、`rotation`)。多运行时可共存于同一合成中,并通过全局对象注册以便 HyperFrames 统一进行 seek 操作。

兼容平台✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Elis3omndz/Claude_Skills/tree/HEAD/.claude/skills/hyperframes-animation

在你喜欢的 AI 中提问

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

文档

插件安装: 在运行 setup 或 freshness 命令之前,如果此技能位于 HyperFrames 插件内部,请遵循 插件执行规则。独立安装则保留下面的更新说明。

HyperFrames 动画

所有动效知识集中在单个技能中:规则(原子配方)、蓝图(多阶段场景模板)、过渡(场景到场景)、技术(更广泛的动画设计模式)以及适配器(每个运行时的 API)。

关于合成约定(数据属性、子合成、确定性),请参阅 hyperframes-core。

默认:组合原子规则

从 rules-index.md 中挑选 2-4 条规则,用单个暂停的 GSAP 时间线将它们粘合起来,完成。这比从蓝图开始更快,产生的代码也更少。

在以下情况下加载蓝图

  • 场景匹配现有的预设计多阶段模板(品牌揭示、社交证明等),重复使用其阶段管道能节省实际创作时间
  • 你需要针对复杂的 4-5 阶段编排生成可运行的基准代码

蓝图位于 blueprints-index.md 中。每个条目指向 blueprints/<id>.md(配方)。不要投机性地读取它;当你已经决定需要场景级编排时才加载它。

路由

想做什么…阅读
通过触发器/标签挑选原子动效模式rules-index.md
读取某条规则的完整 HTML / CSS / GSAP 配方rules/<name>.md
挑选多阶段场景模板blueprints-index.md
读取某个蓝图的完整配方blueprints/<id>.md
编写一个场景过渡(CSS 驱动,位于两个片段之间)transitions/overview.md、transitions/catalog.md
查找更广泛的动画设计技术techniques.md
运动模糊——元素上的快门涂抹效果,以及何时不该使用references/motion-blur.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
角色动画(行走循环、吉祥物、关节木偶、手势)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 Animations 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
命名字体动画效果(通过外部 animate-text 技能,24 个 ID)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,无没有有限根 data-duration 的 repeat: -1,无页面加载时对后续场景片段的 gsap.set,无 display 或原始 visibility 补间,并且仅在时间线完全构建后才注册它,包括在异步回调如 document.fonts.ready 内部构建时)。GSAP 的 autoAlpha 和在显式时间线边界处的零持续时间可见性设置仍被核心允许。仅在非片段元素或片段内部的包装器上使用这些例外;框架拥有 .clip 生命周期。不要在此处重复完整的约定。

核心约定基础上增加的动画精耕规则:

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

脚本

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

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

animation-map.mjs 首先从当前项目解析辅助包,然后可以引导捆绑的 HyperFrames 包版本。仅在技能在捆绑的 CLI/技能安装之外运行且需要显式固定该引导版本时,设置 HYPERFRAMES_SKILL_PKG_VERSION=<version>。

参见

  • hyperframes-core——合成结构、数据属性、子合成、确定性渲染约定
  • hyperframes-creative——调色板、排版、叙事、节拍规划(非动画创意指导)
  • hyperframes-cli——npx hyperframes lint / check / snapshot / preview / render

Individual skills in this repo

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

Elis3omndz/Claude_Skills

Add captions or subtitles to an existing single-subject talking-head video without editing the footage. Use for plain verbatim captions, cinematic captions embedded behind the subject, VFX captions, “炸/特效/酷炫字幕,” or a named identity from the 35-style catalog. Route by visual identity, not by backend engine. The quiet `anchor` rail is the default; embed every word only when the user explicitly wants a fully cinematic treatment. The workflow runs locally end to end, including transcription and subject matting; split multi-shot footage before applying it.

Elis3omndz/Claude_Skills

Author or edit a custom HyperFrames composition when no specialized workflow fits, or when BRIEF.md sets flow: companion. Use for longer or multi-scene pieces, brand and sizzle reels, montages, static loops, static title cards, footage remixes, and freeform builds. Use motion-graphics instead for a short unnarrated motion-first unit, including an animated title. Route fresh creation through hyperframes before using this skill.

Elis3omndz/Claude_Skills

Use when audio already placed in a HyperFrames composition needs to be mixed: fade-in/fade-out, crossfade, track gain or volume, volume automation, ducking, a music bed that fights a voiceover (voiceover carve), effects on a track (EQ, compressor, limiter, gate, saturation, delay, reverb, chorus, phaser, bitcrush), automation envelopes drawn on a track's volume or any effect parameter, or one submix bus carrying a chain, a fader and an automation clock for several tracks at once (`<hf-audio-group>`). Don't use for sourcing or generating audio — finding BGM, SFX, or making a voiceover is `/media-use`. Don't use for clip timing or track layout, which is `/hyperframes-core`.

Elis3omndz/Claude_Skills

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.

Elis3omndz/Claude_Skills

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

Elis3omndz/Claude_Skills

Use when a HyperFrames composition needs a punch-in, punch-out, zoom, reframe, Ken Burns treatment, camera move, visual match/whip handoff, or other seek-safe 2D/3D keyframes; also for GSAP, CSS keyframes, Anime.js, WAAPI, FLIP, paths, masks, SVG morph/draw, text trails, 3D depth, or `hyperframes keyframes` diagnostics. Don't use for broad scene strategy, brand design, media sourcing, captions, or general video planning.

Elis3omndz/Claude_Skills

Use when working with a person on a HyperFrames project in Studio: first, whether their message asks for a change at all (questions, loose ideas and "don't change anything" get an answer and a plan, not an edit); for a new film, the plan, storyboard and build order that the HyperFrames launch films follow; and how the timeline should be laid out so it reads well (one caption track, one element kind per track, every scene a sub-composition) and where captions and key content may sit (safe zones). Don't use for how to perform an individual edit (split, trim, retime, volume, copy, swap): that is `creator-editing-recipes.md` in `/hyperframes-core`.

Elis3omndz/Claude_Skills

A short, design-led motion graphic where motion is the message — kinetic typography, stat count-up, chart/data-viz hit, logo sting / brand lockup, lower-third / callout / social overlay, animated map (highlight regions, connect places, zoom to a location), animated tweet / news-article / headline, webpage / UI animation (scroll, cursor, callouts), or fusing a real image's geometry into a chart. Usually under 10s (up to ~30s), no narration or live-action subject; renders to MP4 or transparent overlay. Longer / narrated / multi-scene → /general-video. Unclear → /hyperframes.

Elis3omndz/Claude_Skills

Turn a music track (an audio file, a video to pull audio from, or a track generated from a mood brief) into a beat-synced video — lyric video, slideshow, or kinetic promo. The music drives all pacing; any user-supplied images/videos are cut onto the same beat grid, and a complete video needs zero assets. Narrated pieces → the input-matched workflow (see /hyperframes). Unclear → /hyperframes.

Elis3omndz/Claude_Skills

Turn a product or marketing URL, pasted script, or brief into a product launch / promo video — SaaS promos, feature reveals, product demos, app and company launches. Use when the user wants to market, launch, promote, or reveal a product; the default for any commercial URL. Site tours / showcases of a website route here too — the brief carries the show-it-as-is intent. Unclear → /hyperframes.

Elis3omndz/Claude_Skills

Turn a GitHub pull request (a PR URL, owner/repo#N, or 'this PR' in a checked-out repo) into a code-change explainer video — changelog, feature reveal, fix, or refactor walkthrough built from the diff, commits, and files: the input is a code change, not a website. Not a product promo (/product-launch-video) or a no-PR topic explainer (/faceless-explainer). Unclear → /hyperframes.

相关技能