Communitygithub.com

Aseel1600/Edit01

超帧(HyperFrames)合成合约——构建一个可渲染的项目。用于合成结构、`data-*` 时间属性、`class=

Edit01 是什么?

“Aseel1600/Edit01”技能定义了 HyperFrames 框架的核心合成合约。HyperFrames 将 HTML 文件转化为可渲染的视频,其中 DOM 通过 `data-*` 属性声明时间线,运行时支持可搜索的动画,媒体播放由框架统一管理。此技能是构建 HyperFrames 项目的技术蓝图,详细说明了根元素形式(独立式与子合成)、同步时间线注册、必循的确定性渲染规则(如禁止运行时时钟、未种子化的随机数或无限循环),以及媒体资产的直接存放要求。它列举了位于 `references/` 目录下的各主题参考文件,涵盖最小合成骨架、合成模式、数据属性、轨道与剪辑、子合成、变量与媒体、确定性规则、全屏运动、故事板格式、脚本格式、子代理分发以及 Tailwind 集成。此外,还提供了验证步骤,引导开发者使用 `hyperframes-cli` 命令(如 `lint`、`validate`、`inspect`、`preview` 和 `render`)确保合成正确无误。该技能适用于所有 HyperFrames 平台,是开发者正确构建渲染视频项目的关键指南。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Aseel1600/Edit01/tree/HEAD/.agents/skills/hyperframes-core

在你喜欢的 AI 中提问

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

文档

HyperFrames 核心

HyperFrames 从 HTML 渲染视频。合成是一个 HTML 文件,其 DOM 通过 data-* 属性声明时间,动画运行时是可搜索的,媒体播放由框架拥有。

本技能是技术合约——如何构建一个 hyperframes 项目。以下正文为构建指南;各主题的详细信息位于 references/ 目录下(请根据需要阅读索引),其他关注点位于同级领域技能中——hyperframes-animation、hyperframes-creative、hyperframes-media、hyperframes-cli、hyperframes-registry。/hyperframes 中的功能地图说明了每个技能覆盖的内容。

参考文件

文件阅读目的
references/minimal-composition.md从最小的可渲染合成骨架开始
references/composition-patterns.md选择单体式与模块化;构建模块化 index.html;选择子合成原型
references/data-attributes.md查找任何 data-*(根 / 剪辑 / 子合成宿主 / 旧别名);使用 class="clip"
references/tracks-and-clips.md选择 data-track-index;处理同轨重叠 / z-index;相对于另一个剪辑设置剪辑的时间
references/sub-compositions.md连接子合成(宿主属性、<template>、每个实例的变量)并在其内部制作动画
references/variables-and-media.md声明变量;放置 <video>/<audio>;设置音量、剪辑
references/determinism-rules.md构建可搜索的时间线;确定性禁止项;可动画属性白名单;布局 / 文本适配
references/full-screen-motion.md使用共享背景创作全屏动画
references/storyboard-format.md编写 STORYBOARD.md 计划(以及解析后的清单)
references/script-format.md编写可选的 SCRIPT.md 锁定旁白
references/subagent-dispatch.md将子代理分发动词(并行扇出 / 后台 / 等待)映射到你的工具链
references/tailwind.md在 Tailwind v4 项目中工作(init --tailwind;运行时合约与 Studio 的 v3 不同)

有关动画运行时的详细信息(GSAP API、Lottie、Three.js 等),请参阅 hyperframes-animation → adapters/<runtime>.md。

构建合成

两种根形式(不可互换)

  • 独立式(顶层 index.html)—— 根 <div data-composition-id="…"> 直接位于 <body> 中,没有 <template> 包装器(否则会隐藏所有内容并破坏渲染)。
  • 子合成(通过 data-composition-src 加载)—— 根必须包装在 <template> 中。

⚠ 传输规则:运行时仅克隆 <template> 的内容;外部的一切(包括 <head> 中的样式/脚本)都会被丢弃——将 <style>/<script> 放入模板内部。 ⚠ 宿主ID规则:宿主插槽的 data-composition-id 必须完全等于内部模板的 data-composition-id 以及 window.__timelines["<id>"] 键——不添加 -mount/-slot/-host 后缀。

文件形状、宿主连接以及预渲染检查清单 → references/sub-compositions.md。

根必须设置尺寸(静默布局错误)

独立式根需要一个显式的尺寸框(以像素为单位的 width/height),并且每个祖先直到 height:100% 的元素都必须有一个已解析的高度——否则 flex/100% 子元素会折叠到接近 0,内容会堆积到左上角。lint/validate/inspect 无法捕获此问题。骨架 → references/minimal-composition.md。

一条暂停的时间线

每个合成在 window.__timelines["<id>"](键 = 根 data-composition-id)处注册恰好一条 gsap.timeline({ paused: true }),在页面加载时同步构建。渲染时长 = 根 data-duration,而不是时间线长度。不要手动将子时间线嵌套到宿主中。完整合约(包括非GSAP运行时) → references/determinism-rules.md + hyperframes-animation/adapters/。

不可协商的规则(lint/validate/inspect 无法捕获的静默错误)

此处列出,完整理由见链接参考。请勿违反:

  • 无渲染时时钟 / 未种子化的 Math.random / 网络 / 输入状态;无 repeat: -1(使用有限次数)。 → determinism-rules.md
  • 仅对视觉属性白名单进行动画;绝不使用 display/visibility;不在后续场景的剪辑上使用 gsap.set。 → determinism-rules.md
  • 正文文本中无 <br>;变换后的元素必须是块级且已设定尺寸;脉动的绝对定位装饰元素需要峰值间隙。 → determinism-rules.md
  • <video>/<audio> 必须是宿主根元素的直接子元素(绝不能位于子合成 <template>/包装器内部);框架拥有播放控制权。 → variables-and-media.md
  • 每个 id 在组装后的页面中必须唯一;在子合成内部,为 id 加上合成 id 前缀(#<id>-hero)。重复的 <video>/<img> id 会渲染为空白——生产者通过 getElementById 注入帧,跨文件重复会绕过 lint。 → composition-patterns.md
  • 全屏场景填充应用于全出血子元素(position:absolute; inset:0),绝不能用于合成根本身——生产者的帧合成可能会丢弃根元素自身的 background(帧渲染为黑色),尽管预览/snapshot 显示正确。 → composition-patterns.md

编辑现有合成

  • 首先阅读文件。保留无关的时间、轨道、ID、变量、媒体路径。
  • 匹配现有的合成ID和时间线键。
  • 添加剪辑:选择一个不重叠的 data-track-index 或有意调整周围的时间。
  • 添加子合成:在连接宿主之前验证其内部的 data-composition-id。

验证

使用 hyperframes-cli 获取命令详情

  • npx hyperframes lint 通过(0 错误)
  • npx hyperframes validate 通过(0 控制台错误)
  • npx hyperframes inspect 通过(0 错误)
  • 包含子合成的项目:npx hyperframes snapshot --at <midpoints> 并目视检查每一帧
  • npx hyperframes preview 用于审查(用户可以在 Studio 的时间线中编辑任何内容)
  • 仅在用户批准后执行 npx hyperframes render

Individual skills in this repo

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

Aseel1600/Edit01

Generate AI videos from text prompts using multiple provider gateways. Use when: (1) Generating videos from text descriptions, (2) Creating AI-generated video clips for content production, (3) Image-to-video generation with a reference image, (4) Choosing between video generation providers (VEO, Kling, Sora, Runway, Seedance, MiniMax, Gemini Omni). Supports gateways: HeyGen API, fal.ai API, Kling official direct API, and the Gemini API (Gemini Omni Flash).

Aseel1600/Edit01

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.

Aseel1600/Edit01

Use p5.js/canvas for local procedural character effects: particles, weather, squash/stretch, walk cycles, and environmental motion.

Aseel1600/Edit01

Review local character animation with schema checks, Playwright browser previews, frame sampling, and FFmpeg/ffprobe final output checks.

Aseel1600/Edit01

Create videos from a text prompt using HeyGen's Video Agent. Use when: (1) Creating a video from a description or idea, (2) Generating explainer, demo, or marketing videos from a prompt, (3) Making a video without specifying exact avatars, voices, or scenes, (4) Quick video prototyping or drafts, (5) One-shot prompt-to-video generation, (6) User says "make me a video" or "create a video about X".

Aseel1600/Edit01

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.

Aseel1600/Edit01

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.

Aseel1600/Edit01

Generate expressive, multilingual narration with fish.audio (S1 / S2-generation models) and reuse cloned voices via reference_id. Use when the user prefers fish.audio/Fish Audio TTS, wants a specific playground voice model, or needs high-emotion voice-clone narration.

Aseel1600/Edit01

Use when implementing Disney's 12 animation principles with Framer Motion in React applications

Aseel1600/Edit01

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). HyperFrames-native: single paused timeline, seek-safe, deterministic.

Aseel1600/Edit01

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, tts, 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`).

Aseel1600/Edit01

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

Aseel1600/Edit01

Audio and media assets for HyperFrames compositions, produced by one shared audio engine (`scripts/audio.mjs`) — multi-provider TTS (HeyGen / ElevenLabs / Kokoro local), background music + sound effects (HeyGen audio-library retrieval by default, with local Lyria / MusicGen BGM generation and a bundled SFX library as the no-credential fallback), Whisper transcription, background removal, and caption authoring. Use for voiceover / TTS, BGM, SFX / sound effects, transcription, captions / subtitles / lyrics / karaoke / per-word styling, voice + provider selection, and music-mood prompting.

Aseel1600/Edit01

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

Aseel1600/Edit01

Use when the user wants a short, design-led motion graphic where motion is the message: kinetic typography, stat or number count-up, chart/data-viz hit, logo sting, brand lockup, lower-third, callout, social overlay, animated headline/tweet/news item, motion poster, or quick captured-page highlight. Usually under 10s and up to ~30s, with no narration arc, voice-over, or live-action subject. Can render to MP4 or transparent overlay. Not for longer, multi-scene, narrated, or brand-reel pieces (use general-video), narrated website videos (website-to-video), topic explainers (faceless-explainer), product promos (product-launch-video), PR videos (pr-to-video), or captions on existing footage (embedded-captions). When unsure whether it's a quick motion-first piece or a longer / narrated treatment, see /hyperframes.

Aseel1600/Edit01

Use when the user has a music track (an audio file, or a video to pull audio from) and wants a beat-synced HyperFrames video, calm to hard-hitting. The music drives everything: one analyzer reads it once, the orchestrator lays out the frames and fills a per-frame plan, and one sub-agent builds each frame. Typography and templates are the floor — a complete video needs zero assets — but any images or videos the user supplies are cut into the frames on the same beat grid (beat-cut / ken-burns). The genre (lyric video, slideshow, kinetic promo) falls out of the per-frame choices; the pipeline never branches on it.

Aseel1600/Edit01

Best practices for Remotion - Video creation in React

Aseel1600/Edit01

Toolkit-specific Remotion patterns — custom transitions, shared components, and project conventions. For core Remotion framework knowledge (hooks, animations, rendering, etc.), see the `remotion-official` skill.

Aseel1600/Edit01

Port an existing Remotion (React) composition to HyperFrames HTML. Use ONLY when the user explicitly asks to port/convert/migrate/translate a Remotion source. Do NOT use: (a) authoring a new HyperFrames composition; (b) Remotion mentioned in passing; (c) Remotion code shared as reference only; (d) "same video as my Remotion one" without explicit migrate request — treat as fresh build. Doubt → `/general-video`. One-way, Remotion-only: no reverse export (HyperFrames→Remotion or any framework), no non-Remotion source (After Effects, Framer Motion, plain React/CSS) → out of scope, re-create via `/general-video`. Flags unsupported patterns (useState, useEffect, async calculateMetadata, third-party React libs, `@remotion/lambda`) and recommends runtime interop over lossy translation. Unsure whether to port vs. build fresh, or only a passing Remotion mention? → /hyperframes.

Aseel1600/Edit01

Animate SVG character rigs with GSAP, CSS transforms, Remotion frame control, and HyperFrames-compatible browser previews.

相关技能