Communitygithub.com

HyperFrames 动效技能

生成设计驱动的简短动效图形,包括动态字效、统计数字、图表、Logo动画、地图动效等,时长通常在10秒以内。

HyperFrames 动效技能 是什么?

此技能专为创建设计驱动的简短动效图形而设计,强调视觉运动本身传达信息,无需旁白或真人表演。它支持多种动效类别,包括动态排版(kinetic-type)、统计数字计数(stat)、数据图表(charts)、Logo动画(logo-reveal)、字幕条(lower-thirds)、地图动效(maps),以及基于搜索的网页/UI动画、新闻文章、推文和资产融合(asset-fusion)等。该工作流遵循严格的资产优先原则:先确定资产策略并获取素材,再围绕可用资产设计镜头,最后复用现有目录能力进行合成。整个过程高度自动化,从初始化到渲染仅需一次明确的问题(导演的一次决策),然后自主完成规划、设计、构建、验证和渲染,最终输出MP4或透明叠加视频。支持macOS Apple Silicon和Linux x64系统,依赖Node.js和FFmpeg,并可选用GPU加速渲染。

兼容平台~Claude Code~Codex CLI✓Cursor✓Gemini CLI
npx skills add https://github.com/laviedezidane/hyperframes-skill/tree/HEAD/.agents/skills/motion-graphics

在你喜欢的 AI 中提问

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

文档

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

首先,保持此技能更新——在执行前向用户确认: npx hyperframes skills update motion-graphics。如果一切正常,此操作几乎无影响;否则,它会刷新此技能及其依赖的核心领域技能,然后才能依赖它们。

figma 源:如果要构建的Logo/资产/动画来自 figma.com 的URL,请先运行 /figma —— 资产导出、品牌令牌,以及如果图形是Figma Motion导入,则进行Motion→GSAP翻译 —— 然后基于其输出进行构建。不要直接通过原始的MCP工具驱动Figma:这会跳过SVG清理、.media/manifest.jsonl 溯源和品牌令牌 var() 绑定,导致后续品牌变更无法传播,除非完全重新导入。

motion-graphics —— 调度入口

前门是 /hyperframes。此技能用于制作简短、设计驱动、无旁白的动效图形(运动即信息;约10秒以内,无画外音)。任何更长、有旁白或多场景的内容——或不确定时→请先阅读 /hyperframes:意图层负责所有路线决策。

此工作流自主设计——最多一次澄清问题(agents/director.md),然后从构建到验证无需中间审查。意图层(/hyperframes → references/intent-interview.md)直接路由至此,无需询问运行形状问题;对于如此短的片段,故事板和配套会话几乎没有价值。渲染仍然由用户控制:在检查和验证快照通过后,打开Studio预览并询问规范性的“立即渲染,还是修改?”问题(来自 ../hyperframes/references/brief-contract.md)。当 BRIEF.md 存在时,在导演提问之前先阅读它。

一个简短的设计驱动动效图形。资产优先:在设计镜头之前,决定资产策略并获取真实素材,然后围绕你拥有的资产设计镜头,接着通过复用目录能力进行合成。所有工件都放置在 PROJECT_DIR = videos/<project-name>/ 目录下(在第0步创建);以下所有路径都相对于它。

阶段执行主要工件详细流程
initBashhyperframes.json第0步
plan子代理 — 决定是否搜索? + 分类 + 资产策略shot-plan.json(草稿:类别、asset_needs 查询、简述)agents/director.md(第1部分)
source ◇Bash — media-use 解析(如果 asset_needs 为空则跳过)assets/ + assets/index.mdphases/source/guide.md
design子代理 — 围绕已解析资产进行镜头设计shot-plan.json(最终:区块 + 布局 + 动效 + 位置)agents/director.md(第2部分)
build子代理 — 优先复用进行合成compositions/index.htmlagents/builder.md
verifyBash — lint、check、验证快照;失败时修复snapshots/contact-sheet.jpg第5步
approve打开预览;询问渲染或修改;等待回答明确的渲染批准第6步
renderBash — hyperframes render(MP4,或 --format webm/mov 用于叠加)renders/video.mp4 或透明叠加视频第6步

◇ source 仅当所选类别声明了资产时运行。纯代码/文本类别(例如 kinetic-type、大多数 charts/stat)具有 asset_needs: [],直接从规划跳到设计。

类别——按搜索决策划分

plan 的首要决策是:是否需要搜索? 这个分支将类别分成两组;然后选择具体的类别——对于搜索驱动的,按搜索返回的内容类型。每个类别是一个 categories/<id>/module.md(其规划和构建规则);共享的动效词汇位于 references/motion-vocabulary.md(→ hyperframes-animation 规则/蓝图 + 注册表块)。

形式类别——无需搜索;用户提供内容:

类别意图依赖
kinetic-type引人注目的台词/引文/标题,以动效为主的文字caption-* 块 + 动画规则
stat单个主数字/计数 + 环形效果apple-money-count / rules/{counting-dynamic-scale, stat-bars-and-fills}
charts条形/折线/饼图/竞赛图/百分比 来自数据data-chart 块
logo-revealLogo动画/品牌锁定(用户Logo)logo-outro / rules/svg-path-draw
lower-thirds姓名/标题栏、标注、社交叠加caption-* + 注册表叠加块
maps地理动效——高亮区域、连接地点、缩放到某位置(矢量路径或预烘焙底图路径)us-map / world-map 系列 + bake-basemap.mjs

搜索驱动类别——先搜索,然后按内容类型动画化(RWA路径):

返回内容类别动画
网页/链接webpage网页/UI动画(滚动、显示、光标、标注)
新闻文章news标题显示 + 来源卡片 + 关键事实标注
推文tweet动画推文卡片
图片/实体asset-fusion资产的几何形状_变成_图表(RWA 融合融合)

构建顺序:一次一个,优先覆盖范围(粗糙即可)。kinetic-type 从原型移植而来;其余依此类推。

先决条件

macOS Apple Silicon 或 Linux x64。系统工具:brew install node ffmpeg。执行一次 npx hyperframes doctor。macOS GPU 渲染:export PRODUCER_BROWSER_GPU_MODE=hardware。

可选密钥(如果未设置,则使用本地回退)——仅对通过 media-use 获取/生成资产的类别需要:

密钥用途回退
GEMINI_API_KEY / GOOGLE_API_KEY图像生成(media-use 解析)跳过生成 / 仅搜索
(asset_scout / 搜索提供商)webpage/news/tweet + asset-fusion 真实资产搜索类别降级为无资产

流程

第0步——初始化

当前工作目录是代理工作区根目录;所有工件都写入 PROJECT_DIR = videos/<project-name>/。:使用用户提供的目录,否则从意图中获取一个短横线命名(<subject>-motion)。不要使用工作区基本名称或时间戳。

仅当 $PROJECT_DIR/hyperframes.json 不存在时:

PROJECT_DIR="${MOTION_GRAPHICS_DIR:-videos/<project-name>}"
mkdir -p "$(dirname "$PROJECT_DIR")"
npx hyperframes init "$PROJECT_DIR" --non-interactive --example=blank --skill=motion-graphics

init 检查已安装的技能是否与 GitHub 上的最新版本一致,如果任何技能过时,则更新全局集合。

约束: 永远不要在工作区根目录执行 hyperframes init;永远不要在 PROJECT_DIR 内部嵌套另一个 hyperframes/ 目录;每个 Bash 命令(主代理 + 子代理)都是一个 (cd "$PROJECT_DIR" && ...) 子 shell——永远不要使用裸 cd。

第1步——规划(子代理:导演第1部分)

分派一个子代理。提示 = 完整的 agents/director.md + ## 分派上下文(SKILL_DIR / PROJECT_DIR / 用户请求 / Schema: <SKILL_DIR>/references/shot-plan-ir.md)。它必须:

  1. 决定:是否需要搜索?(第一个分支)
    • 否 → 选择一个形式类别(kinetic-type / stat / charts / logo-reveal / lower-thirds / maps);内容由用户提供;asset_needs: []。
    • 是 → 将搜索计划写入 asset_needs[](新闻/网页/推文/图片;双极查询)。具体的搜索驱动类别(webpage / news / tweet / asset-fusion)由第2步返回的内容类型确认,并在第3步最终确定。
  2. 编写草稿 shot-plan.json(外壳 + 选定的形式类别_或_搜索意图 + asset_needs + 一段镜头简述)。架构:references/shot-plan-ir.md。

验证:[ -s "$PROJECT_DIR/shot-plan.json" ] && echo ok || echo missing。

第2步——素材 ◇(Bash:media-use,有条件)

如果 shot-plan.json.asset_needs 非空,则解析资产(搜索/生成/获取 → 冻结的项目本地路径 + 台账)。请参阅 phases/source/guide.md(包装了 media-use resolve;搜索驱动类别使用新闻/网页/推文/图片搜索)。如果 asset_needs 为空,则跳到第3步。

优雅降级:如果搜索/提供商不可用,类别回退到无资产(在 context.log 中注明)。

第3步——设计(子代理:导演第2部分)

分派一个子代理(提示 = agents/director.md 第2部分 + 分派上下文,包括已解析的 assets/index.md(如果第2步运行了) + catalog-map.md)。它围绕可用资产设计镜头:选择目录块 + hyperframes-animation 规则/蓝图、布局、动效、节拍,以及(对于 asset-fusion)element_positions + 吸管调色板。最终确定 shot-plan.json(content.block + content.customize + 每个类别的内容)。

第4步——构建(子代理:构建器,优先复用)

在构建器的分派上下文中包含共享的动效原则。对于 charts 和 stat,还包含数据动效。构建器在编写时间线之前阅读这些指南。

分派一个子代理。提示 = 完整的 agents/builder.md + 分派上下文(shot-plan.json、catalog-map.md、类别的 module.md、references/motion-vocabulary.md、references/builder-contract.md)。优先复用:npx hyperframes add <block> + 就地定制;仅手动编写缺口 + 资产融合辅助功能。输出 compositions/index.html,遵守 HF 合约(暂停的 GSAP 时间线在 window.__timelines 上、class="clip" + 稳定 ID、tl.seek(0)、确定性)。

第5步——验证(Bash → 失败时调用修复子代理)

(cd "$PROJECT_DIR" && npx hyperframes check .)
(cd "$PROJECT_DIR" && npx hyperframes snapshot --at <proof-times>)

选择能够展示开始状态、标志性动作和最终保持状态的证明时间点。在继续之前检查生成的联系表或快照表。如果 lint、check 或快照失败,分派修复子代理(agents/finalize.md)进行一次就地修复,然后重新运行失败的关卡。永远不要为了掩盖缺陷而更改固定时长。

第6步——批准和渲染(Bash)

打开 Studio,然后问一个问题:“立即渲染,还是修改?” 修订后,返回同一关卡:

(cd "$PROJECT_DIR" && npx hyperframes preview --background)

仅在收到明确的渲染答复后才渲染:

(cd "$PROJECT_DIR" && npx hyperframes render . --skill=motion-graphics -q high -o ./renders/video.mp4)
# 透明叠加变体:--format webm(或 mov)

验证输出存在、非空且具有预期的时长。最终交接命名工件、实际时长、合成或帧 ID、证明时间点以及已检查的联系表或快照表。标志位于 /hyperframes-cli → references/preview-render.md。

恢复表

状态从中继续
没有 shot-plan.json第1步(规划)
shot-plan.json 有 asset_needs,没有 assets/第2步(素材)
shot-plan.json 已定稿,没有 compositions/index.html第3/4步(设计+构建)
compositions/index.html 存在,验证快照缺失第5步(验证)
检查和验证快照通过,无批准的渲染第6步(批准)
批准的渲染存在验证输出,然后报告

设计说明(维护者——执行时不读取此内容)

  • 资产优先原则:确保所有动效都基于真实素材设计,避免失真的假设。

Individual skills in this repo

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

laviedezidane/hyperframes-skill

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.

laviedezidane/hyperframes-skill

Turn arbitrary text — an article, notes, a topic, a brief — into a faceless explainer video: there is no site or footage to capture, so the visuals are invented per scene (typography, abstract graphics, diagrams, data-viz). Use for topic explainers, concept breakdowns, how-tos, listicles. Not a video built from a website (/product-launch-video — promo or tour). Unclear → /hyperframes.

laviedezidane/hyperframes-skill

Import Figma content into a HyperFrames composition — rendered assets, brand tokens, components, storyboard sections → reconstructed motion (frames read as states, not slides) (REST/CLI), connector-assisted motion when available, and shaders from a connector or native export. Use when the user pastes a figma.com link or asks to bring a Figma design, frame, logo, brand, or animation into a video/composition.

laviedezidane/hyperframes-skill

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.

laviedezidane/hyperframes-skill

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.

laviedezidane/hyperframes-skill

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

laviedezidane/hyperframes-skill

Use the HyperFrames CLI development loop: init, add, catalog, capture, lint, check, snapshot, compare, grade-compare, preview, play, present, beats, keyframes, single or batch render, publish, cloud, cloudrun, feedback, lambda, doctor, browser, info, upgrade, skills, compositions, timeline, history, clean, docs, benchmark, telemetry, transcribe, auth, tts, and remove-background. Also use when diagnosing build or render failures. validate, inspect, and layout are deprecated aliases; use check. Covers local, HeyGen-hosted cloud, AWS Lambda, and Google Cloud Run rendering.

laviedezidane/hyperframes-skill

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.

laviedezidane/hyperframes-skill

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

laviedezidane/hyperframes-skill

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.

laviedezidane/hyperframes-skill

Search, install, and wire registry blocks and components into HyperFrames compositions. Use BEFORE hand-building any named visual — whenever a brief, a user, or a storyboard names a look, effect, treatment, or transition such as CRT scanlines, glitch, chromatic aberration, film grain, a shimmer sweep, a chart, a code or terminal window, a map, or a confetti burst — because roughly 400 hosted items already cover many of them and the search ranks all of them with nothing installed, no project, and no account. Also use when running hyperframes add or hyperframes catalog, installing one item or every block matching a tag, wiring an installed item into index.html, or working with hyperframes.json. Covers discovery, install locations, block sub-composition wiring, component snippet merging, and authoring a new block or component to contribute upstream (idea → scaffold → validate → PR).

laviedezidane/hyperframes-skill

Mandatory entry point: read this first for any request to make, create, edit, animate, or render a video, animation, or motion graphic, including a promo, explainer, captioned clip, title card, overlay, slideshow or interactive deck, Remotion port, or any HyperFrames HTML composition. Also use it to inspect, diagnose, validate, preview, publish, or batch-render an existing HyperFrames project. Inputs may be a website URL, GitHub PR, Figma design or URL, text or brief, existing footage, or music. It resumes project state, captures intent when applicable, selects and installs the owning workflow, and routes domain capabilities. HyperFrames is the default output framework unless the user explicitly chooses another framework for the deliverable or asks only to record a browser session.

laviedezidane/hyperframes-skill

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

laviedezidane/hyperframes-skill

Agent Media OS for a HyperFrames project. Resolve BGM, SFX, image, icon, brand logo, voice, color grade, or LUT into a frozen local file or paste-ready block + ledger record (one verb, `resolve`); generate via TTS / music / image models when the catalog misses; produce voiceover, transcription, captions, and background removal through one shared audio engine; operate on media (cut / reframe / transform); and reuse assets across projects. Also use for vague feedback that real footage looks dark, flat, boring, should feel retro/camcorder/print/ASCII, needs privacy, or needs a media reveal. When the host app provides its own music or sound-effect tools, use those for music and sound effects; `resolve --type bgm|sfx` needs the heygen CLI. When `HEYGEN_API_BASE` is set, HeyGen calls go through that host with no CLI sign-in.

laviedezidane/hyperframes-skill

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.

laviedezidane/hyperframes-skill

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.

laviedezidane/hyperframes-skill

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.

laviedezidane/hyperframes-skill

Port an existing Remotion (React) composition''s source to HyperFrames HTML. Use ONLY on an explicit ask to port/convert/migrate/translate a Remotion source — one-way, Remotion-only. A passing Remotion mention, reference-only code, or "make something like my Remotion video" is a fresh build (/general-video). Unclear → /hyperframes.

laviedezidane/hyperframes-skill

Author a HyperFrames slideshow — a presentation, pitch deck, or interactive deck with discrete slides, fragment reveals, branching, hotspot navigation, and built-in presenter mode with speaker notes; also converts an existing page into a deck. Output is a navigable deck, not a rendered MP4. If the user didn't explicitly ask for a slideshow, confirm before authoring. Unclear → /hyperframes.

laviedezidane/hyperframes-skill

Package an existing talking-head / interview / podcast video with timed, designed GRAPHIC OVERLAY cards — kinetic titles, lower-thirds, data callouts, quotes, side panels, picture-in-picture — synced to the transcript, on a 16:9 / 9:16 / 4:5 canvas of your choice; the clip plays untouched underneath. Trigger on "graphic overlays", "on-screen graphics", "package / dress up my video". Not plain subtitles (/embedded-captions). Unclear → /hyperframes.

相关技能