Communitygithub.com

Zuhair-01/claude-skills-and-systems

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

claude-skills-and-systems 是什么?

该技能汇集了 HyperFrames 动画系统的全部知识,涵盖从原子运动规则到多阶段场景蓝图的所有内容。开发者可以通过选择 2-4 条规则快速组合动画,或加载预设计的蓝图模板(如品牌揭示、社交证明)用于复杂编排。技能不仅仅关注动画本身,还提供了场景过渡、更广泛的动效设计技术以及七个运行时适配器的详细 API 参考,包括 GSAP(默认)、Lottie、Three.js、Anime.js、CSS 关键帧、Web Animations API 和 TypeGPU/WebGPU。此外,该技能支持通过 `animation-map.mjs` 脚本审查现有合成的动画映射,并包含 24 种命名文本动画效果。其核心遵循 HyperFrames 的确定性时间线约束:单条暂停时间线,避免运行时随机性,并通过数据属性管理生命周期,从而确保动画的可预测性和跨场景的一致性。

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

在你喜欢的 AI 中提问

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

文档

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——时间线/Tween/位置参数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 用于轻量级 Tweening,当 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 的 Tween,并且不应在 async/setTimeout/Promise 内部构建时间线)。核心允许在明确的时间线边界使用 GSAP autoAlpha 和零持续时间的可见性设置。仅在非片段元素或片段内的包装器上使用这些例外;框架拥有 .clip 生命周期。请勿在此重复完整的契约。

在核心契约基础上的动画制作补充:

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

脚本

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

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

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

参见

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

Individual skills in this repo

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

Zuhair-01/claude-skills-and-systems

Create AI avatar videos with precise control over avatars, voices, scripts, scenes, and backgrounds using HeyGen's v2 API. Use when: (1) Choosing a specific avatar and voice for a video, (2) Writing exact scripts for an avatar to speak, (3) Building multi-scene videos with different backgrounds per scene, (4) Creating transparent WebM videos for compositing, (5) Using talking photos as video presenters, (6) Integrating HeyGen avatars with Remotion, (7) Batch video generation with exact specs, (8) Brand-consistent production videos with precise control.

Zuhair-01/claude-skills-and-systems

Generate Mandarin and multilingual narration with Volcengine Doubao Speech 2.0. Use when creating Chinese voiceovers, when the user prefers Doubao/Volcengine/火山引擎/豆包 TTS, or when narration needs character-level timestamp metadata for subtitles.

Zuhair-01/claude-skills-and-systems

Edit existing videos using AI — remix style, upscale, remove background, and add audio via fal.ai's hosted video models.

Zuhair-01/claude-skills-and-systems

Video and audio processing with FFmpeg. Use for format conversion, resizing, compression, audio extraction, and preparing assets for Remotion. Triggers include converting GIF to MP4, resizing video, extracting audio, compressing files, or any media transformation task.

Zuhair-01/claude-skills-and-systems

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.

Zuhair-01/claude-skills-and-systems

Read-only queue dashboard for workspace-aware ship. (gstack)

Zuhair-01/claude-skills-and-systems

Generate HeyGen presenter videos via the v3 Video Agent pipeline — handles Frame Check (aspect ratio correction), prompt engineering, avatar resolution, and voice selection. Required for any HeyGen video generation. Replaces deprecated endpoints with v3. Use when: (1) generating any HeyGen video (via API or otherwise), (2) sending a personalized video message (outreach, update, announcement, pitch, knowledge), (3) creating a HeyGen presenter-led explainer, tutorial, or product demo with a human face, (4) "make a video of me saying...", "send a video to my leads", "record an update for my team", "create a video pitch", "make a loom-style message", "I want to appear in this video", "generate a HeyGen video", "make a talking head video". Accepts avatar_id from heygen-avatar for identity-first HeyGen videos, or uses a stock presenter. Returns video share URL + HeyGen session URL for iteration. Chain signal: when the user wants to create/design an avatar AND make a video in the same request, run heygen-avatar f...

Zuhair-01/claude-skills-and-systems

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.

Zuhair-01/claude-skills-and-systems

Generates high-converting Next.js/React landing pages with Tailwind CSS. Uses PAS, AIDA, and BAB frameworks for optimized copy/components (Heroes, Features, Pricing). Focuses on Core Web Vitals/SEO.

相关技能