Communitygithub.com

Elis3omndz/Claude_Skills

当 HyperFrames 合成需要推进、拉出、缩放、重新构图、Ken Burns 处理、摄像机移动、视觉匹配/甩镜头过渡或其他安全可寻的 2D/3D 关键帧时使用;也可用于 GSAP、CSS 关键帧、Anime.js、WAAPI、FLIP、路径、遮罩、SVG 变形/绘制、文字轨迹、3D 深度或 `hyperframes keyframes` 诊断。不适用于广泛的场景策略、品牌设计、媒体源、字幕或常规视频规划。

Claude_Skills 是什么?

这个技能专门用于 HyperFrames 生态系统中精确的视觉运动控制。它定义了一个“关键帧”作为姿态契约,确保可见状态、连续主体身份、安全可寻的运行时间和已验证的像素。技能核心功能包括处理推进/拉出、平滑多状态缩放/重新构图、平移/Ken Burns 处理、链式摄像机移动、匹配剪辑/甩镜头、裁剪/遮罩重新构图、方向性划像/虹膜揭示、分屏过渡、源变速(恒定速率和速率斜坡)以及冻结/保持效果。它明确区分自己的职责与 `/hyperframes-core`(时间线、剪辑定时、源范围)和 `/hyperframes-animation`(宽泛场景配方)的职责,强调关键帧仅对视觉包装器内的可见过渡或裁剪进行动画处理。该技能支持多种运行时技术——GSAP、CSS 关键帧、Anime.js、WAAPI——并有严格的规则(例如,GSAP 时间线必须暂停,只在构建完成后注册,有限迭代)。它提供清晰的操作步骤:识别主体和状态,选择最小化机制,编写安全可寻的关键帧,并通过 CLI 命令如 `hyperframes check` 和 `hyperframes keyframes`(支持 `--shot`、`--ghost`、`--layout strip` 等标志)进行验证。总的来说,它确保 HyperFrames 中的视觉运动是可预测、可验证且安全的,不与时间线管理或广泛场景编排发生冲突。

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

在你喜欢的 AI 中提问

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

文档

插件安装: 在执行设置或刷新命令之前,当此技能位于 HyperFrames 插件内部时,请遵循插件执行规则。独立安装则保留下面的更新说明。

HyperFrames 关键帧

关键帧是一个姿态契约:可见状态、连续主体身份、安全可寻的运行时间、已验证的像素。

使用 hyperframes-animation 处理宽泛的场景配方。使用 hyperframes-cli 获取完整命令文档。仅在选择实现机制而非视觉风格时,才使用 references/keyframe-patterns.md。

创作者编辑边界

关键帧负责视觉运动,而非片段组装。源范围硬切、修剪、拼接和重新排序属于 /hyperframes-core:每个保留范围只创作一个媒体元素,用 data-start 和 data-duration 放置,并用 data-media-start 选择源偏移。相邻范围构成硬切。淡入淡出使用不同轨道上的重叠片段加上视觉透明度关键帧;声音淡入淡出使用 /hyperframes-audio。

创作者请求真实机制
推进 / 拉出在片段内部的一个非定时视觉/裁剪包装器上,对 scale 配合 x/y 或百分比平移进行关键帧处理。使用固定的/短时间的补间实现硬推进,使用补间实现平滑移动。
平滑多状态缩放或重新构图保持一个主体包装器存活,并将多个缩放/重新构图状态编写为一个姿态阶梯,每个片段有单独的缓动。
平移、重新构图或 Ken Burns 摄像机移动对包装器的平移和缩放进行动画处理。几何是创作的;这不是人脸追踪或自动语义重新构图。
链式摄像机移动在一个已注册的安全可寻时间线上,链式化带标记的变换节拍。
匹配剪辑或甩镜头/hyperframes-animation 负责视觉交接;/hyperframes-registry 提供基础元素;关键帧保留创作的几何、方向和速度。没有自动匹配帧发现。
裁剪和遮罩重新构图在内层视觉包装器上插值 clip-path 或遮罩,以裁剪/重新构图,而不改变源时间。多边形关键帧可以形成多边形/遮罩过渡。
方向性划像或虹膜/揭示切在重叠的视觉片段上对遮罩/裁剪边界进行动画处理;/hyperframes-animation 负责交接编排。
分屏交接保持由核心放置的两个视觉片段,然后对其内层裁剪/遮罩包装器和分割线几何进行关键帧处理。
恒定源变速/hyperframes-core 拥有规范化的 data-playback-rate(0.1..10),用于渲染安全的画面和保持音调的声音。它对整个媒体元素是恒定的。
源速度斜坡在 <video>/<audio> 的 data-automation 中设置 rate 通道(t 为片段秒,v 为 0.1..10,对数插值);它覆盖恒定速率。
冻结 / 保持视觉姿态、最终源帧或完成的子合成可以保持。不支持任意中间源冻结;预处理一个静态/派生片段,将其作为自己的片段放置,然后用另一个源范围继续。

同时编辑画面和声音时,加载 /hyperframes-core、此技能用于视觉运动,以及 /hyperframes-audio 用于淡入淡出、交错淡变、音量自动化、闪避/雕刻或已放置轨道上的效果。

视觉过渡或裁剪处理不是时间上的源修剪或拼接。/hyperframes-core 拥有时间线、片段定时和源范围;关键帧仅对片段内部包装器上的可见交接或裁剪进行动画处理。对于可复制的组合画面/声音配方,使用 /hyperframes-core → references/creator-editing-recipes.md。

操作步骤

  1. 识别动画主体、可见状态、最终状态和运行时间。
  2. 选择能证明提示的最小化机制。仅在机制不明确时阅读 references/keyframe-patterns.md。
  3. 在声明的运行时间内编写安全可寻的关键帧。仅在构建完成后注册运行时实例;在 document.fonts.ready 内构建是可以的。
  4. 使用 hyperframes check(运行 lint)、hyperframes keyframes、一个集中的 --shot 以及在验证时间点的快照进行验证。
  5. 如果验证失败,修复源关键帧并重新运行最小的失败诊断,然后再进行渲染。

契约

  • 命名移动的主体。
  • 命名证明预期运动所需的姿态,包括最终状态。
  • 对可见通道进行关键帧处理,而不是隐藏的辅助状态。
  • 当连续性重要时,保持对象身份。
  • 仅当预期运动是替换或溶解时才使用淡入淡出。
  • 保持可读或语义状态足够长时间以便看清。
  • 最终帧是动画的一部分,而不是清理。
  • 除非请求,否则不要重置为静止状态。
  • 除非请求,否则不要以黑色结束。
  • 如果编辑起始场景,除非要求重新设计,否则保留布局、文案、资源、颜色和最终状态。

运行时规则

GSAP:

  • 在页面加载时或 document.fonts.ready 内部构建,并且仅在构建完成后注册
  • 使用 gsap.timeline({ paused: true })
  • 注册为 window.__timelines[compositionId]
  • 注册表键必须与 data-composition-id 匹配
  • 对于渲染关键的运动,不要调用 tl.play()
  • 保持循环有限

CSS 关键帧:

  • 有限的持续时间和迭代次数
  • 确定性的延迟
  • animation-fill-mode: both
  • 当定时属于某个片段时使用 data-start

Anime.js:

  • 同步创建
  • autoplay: false
  • 有限的持续时间和循环
  • 将每个实例推送到 window.__hfAnime

WAAPI:

  • 有限的 duration
  • fill: "both"
  • 确定性的构造
  • 文本表面不列出 WAAPI;使用 --shot(它能够寻找 WAAPI)和快照验证

切勿用于渲染关键的运动:

  • Date.now()
  • performance.now()
  • 未播种的 Math.random()
  • 悬停/滚动触发器
  • 定时器
  • 在其异步构建完成之前注册的时间线
  • 未注册的 requestAnimationFrame
  • 无限循环

GSAP 框架

const root = document.querySelector("[data-composition-id]");
const compositionId = root.dataset.compositionId;
const tl = gsap.timeline({ paused: true });

tl.addLabel("state-a", 0);
tl.to(".subject", {
  keyframes: [
    { x: 0, opacity: 1, duration: 0.2 },
    { x: 120, opacity: 1, duration: 0.4, ease: "power2.out" },
    { x: 100, opacity: 1, duration: 0.2, ease: "power2.inOut" },
  ],
  ease: "none",
});

window.__timelines = window.__timelines || {};
window.__timelines[compositionId] = tl;

使用标签表示语义状态。使用位置参数代替链式延迟。对于后来触及相同属性的 from()/fromTo() 补间,使用 immediateRender: false。

关键帧形式

  • 数组关键帧:带有每步时长/缓动的姿态阶梯。
  • 百分比关键帧:一个补间内的精确定时。
  • 属性数组:紧凑的多停点变化。
  • 当每个停点携带自己的缓动时,父级使用 ease: "none"。
  • 当每个片段应共享相同感觉时使用 easeEach。

不要从示例中复制数字距离或定时。从实际合成的几何和时长中推导。

对于一个在两个方框之间移动的主体,首选一个连续的变换补间或 FLIP。仅当观众应感受到不同节拍时,才将 x/y/scale 拆分为多个带缓动的关键帧;每个片段都会改变速度,可能被视为卡顿。

通道

优先使用合成器/视觉通道:x/y/z、xPercent/yPercent、scale、rotationX/Y/Z、skew、transformOrigin、svgOrigin、opacity、autoAlpha、clip-path、遮罩、CSS 变量、SVG 路径/虚线值、摄像机变换、着色器统一变量。

避免使用布局/生命周期通道:top/left/right/bottom、width/height、margin/padding、display、visibility、延迟的 DOM 创建、执行主体运动的辅助覆盖层。

对于可见性变化,在已注册的可寻 GSAP 时间线上使用 autoAlpha,或在显式边界处使用零时长的 tl.set()。只针对非剪辑元素或剪辑内部的包装器;永远不要针对 .clip 本身。永远不要对原始的 visibility 进行时长补间,也永远不要对 display 进行补间。

机制选择

选择能证明提示的最小化机制:

需要机制
同一主体改变盒子或层次结构共享元素 / FLIP
主体沿可见路径移动路径追踪
描边增长或追踪描边绘制
一个形状变成另一个形状形状插值
揭示边界可见裁剪、遮罩或着色器统一变量
多个项目按顺序移动错开 / 索引延迟
文本本身移动行、词、字符或带状细分
表面弯曲、拉伸或裁剪父/子反向变换
UI 有状态显式状态机
场景有深度DOM 3D、Three.js 或 WebGL 摄像机/对象关键帧

机制可以组合,但每个必须阐明想法。装饰不是证明。

定时

  • 仅在能阐明原因或方向时使用预期动作。
  • 加速离开静止状态。
  • 峰值证明应明确展示机制。
  • 跟随动作传达能量和方向。
  • 仅当主体应感觉有弹性或触觉时使用过冲。
  • 匀速路径追踪通常需要 ease: "none"。
  • 离散的 UI 状态通常需要锐利的 ease-out。
  • 重复元素需要有序偏移,而非相同定时。
  • 最终的锁定状态需要比过渡姿态更长的保持。
  • 平滑意味着同一主体上的连续速度。
  • 除非有意且已验证,否则不要重叠写入相同变换属性的补间。
  • 避免在主要英雄表面同时缩放或移动时,对大的 clip-path/遮罩变化进行动画处理;在主移动稳定后使用嵌套揭示。

文本

保留行框、词间距、可读性和最终适配。如果文本内部移动,移动字形或遮罩带,而不仅仅是文本周围的装饰。对可读帧进行快照。

SVG

对于描边增长,首选 DrawSVGPlugin,然后是 stroke-dasharray/stroke-dashoffset。对于形状插值,首选 MorphSVGPlugin;必要时将基本图形转换为路径,并将复杂轮廓拆分为更简单的部分。

3D

单纯的缩放是假深度。在稳定父级上使用透视、transform-style: preserve-3d、z 轴移动、旋转、摄像机/世界运动、遮挡以及对象交叉时的图层顺序。

使用一个或两个诊断角度来揭示深度关系。如果带角度的证明没有显示深度交叉,改进 z/摄像机/遮挡。

Canvas / WebGL

通过确定性状态对摄像机位置、摄像机目标、对象变换、材质透明度、着色器统一变量和后处理强度进行关键帧处理。从 HyperFrames 时间渲染。使用 --ghost,因为标记框无法看到内部画布运动。

CLI 验证

npx hyperframes check
npx hyperframes keyframes .
npx hyperframes keyframes . --json
npx hyperframes keyframes . --runtime all
npx hyperframes keyframes . --selector "<selector>" --shot "<file>" --samples <n>
npx hyperframes keyframes . --selector "<selector>" --shot "<file>" --layout strip --from <t0> --to <t1>
npx hyperframes keyframes . --shot "<file>" --ghost --angle <angle>
npx hyperframes snapshot . --at <times>

为真正动画主体选择 <selector>。为第一帧、验证姿态、最终减去保持和精确最终状态选择 <times>。仅在必须证明深度时选择 <angle>。

工具验证
keyframes目标、显式停点、路径、轨迹、组合的父/子运动、CSS 停点、Anime 注册
--shot幽灵、路线形状、时间间隔、DOM 3D 投影、聚焦选择器验证
--layout strip原地运动、重叠、接触、微妙缩放/透明度、文字波动
--ghost画布、WebGL、着色器运动、渲染的 3D
snapshot --at遮罩

...

[为翻译而截断]

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

All animation knowledge for HyperFrames — atomic motion rules, multi-phase scene blueprints, scene transitions, broader motion-design techniques, AND the seven runtime adapters (GSAP default, plus Lottie, Three.js, Anime.js, CSS keyframes, Web Animations API, TypeGPU). Use for any motion or animation task: pick 2-4 rules and compose, or load a blueprint, or look up runtime-specific API (e.g. GSAP eases / Lottie player / Three.js mixer). Also covers auditing an existing composition's choreography (animation map) and 24 named text-animation effects. HyperFrames-native: single paused timeline, seek-safe, deterministic.

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

相关技能