Communitygithub.com

motion-graphics — 动态图形

创建简短、设计主导、无旁白的动态图形,如动态排版、数据图表、Logo展示等。通常时长不超过10秒,输出MP4或透明叠加格式。

motion-graphics — 动态图形 是什么?

此技能专注于生成“设计驱动、无旁白”的短动态图形(Motion Graphics),时长通常小于10秒,最长约30秒。其核心理念是“资产优先”:在绘制镜头前,先决定资产策略并获取真实材料,然后围绕已有资产设计镜头,并通过复用目录能力进行合成。技能覆盖两类场景:一是无需搜索的“表单类别”(如动态排版、统计数字、图表、Logo展示、下三分之一等),用户直接提供内容;二是需搜索的“搜索驱动类别”(如网页/新闻/推文动画、资产融合等),先通过媒体搜索(新闻/网页/推文/图像)获取资产,再基于内容类型动画化。执行流程分为初始化、规划、素材获取、设计、构建、渲染和验证七个步骤,严格遵循标准化的任务执行顺序。该技能适用于Claude Code、Codex等AI Agent平台,要求macOS Apple Silicon或Linux x64环境,并依赖Node.js、FFmpeg及hyperframes CLI工具。

兼容平台~Claude Code~Codex CLI✓Cursor✓Gemini CLI
npx skills add https://github.com/1345AbhishekKumar/starter-supabase/tree/HEAD/.agents/skills/motion-graphics

在你喜欢的 AI 中提问

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

文档

motion-graphics — 分发条目

在步骤0之前确认路由。 此技能制作简短、设计主导、无旁白的动态图形(运动即信息;约10秒以内,无配音)。更长、多场景或有旁白的作品 → /general-video;网站的旁白视频 → /website-to-video;主题讲解 → /faceless-explainer;产品推广 → /product-launch-video;现有素材的字幕 → /embedded-captions。超出范围:实时/渲染时数据,或无法捕获的素材。不确定是运动优先还是有旁白?请先阅读 /hyperframes。

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

阶段执行方式主要工件详细流程
初始化Bashhyperframes.json步骤0
规划子代理 — 决定是否需要搜索? + 分类 + 资产策略shot-plan.json(草稿:类别、asset_needs 查询、简报)agents/director.md(第1部分)
素材获取 ◇Bash — 媒体使用解析(如果 asset_needs 为空则跳过)assets/ + assets/index.mdphases/source/guide.md
设计子代理 — 围绕已解析资产进行镜头设计shot-plan.json(最终版:区块 + 布局 + 动画 + 位置)agents/director.md(第2部分)
构建子代理 — 复用优先的合成compositions/index.htmlagents/builder.md
渲染Bash — hyperframes render(MP4,或 --format webm/mov 用于叠加)renders/video.mp4步骤5
验证Bash — lint / inspect -> 失败时修复子代理(就地修复)agents/finalize.md

◇ 素材获取 只在所选类别声明需要资产时运行。纯代码/文本类别(例如 kinetic-type、大多数 charts/stat)的 asset_needs: [],会直接从规划跳到设计。

类别 — 按搜索决策划分

规划 的第一个决策是:是否需要搜索? 这个分支将类别分为两组;然后选择具体的类别——对于搜索驱动的类别,根据搜索结果的内容类型来选择。每个类别对应一个 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-* + 注册表叠加块

搜索驱动类别 — 先搜索,然后根据内容类型动画化(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。

可选密钥(未设置时使用本地回退)——仅对通过媒体使用获取/生成资产的类别需要:

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

流程

步骤0 — 初始化

当前工作目录是代理工作区根目录;将所有工件写入 PROJECT_DIR = videos/<project-name>/。<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

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);内容由用户提供;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:媒体使用,有条件)

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

# 示意——参见 phases/source/guide.md
(cd "$PROJECT_DIR" && node <SKILL_DIR>/phases/source/resolve.mjs --plan ./shot-plan.json --out ./assets)

平稳降级:如果搜索/提供商不可用,类别回退到无资产(在 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 — 构建(子代理:构建器,复用优先)

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

步骤5 — 渲染(Bash)

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

步骤6 — 验证(Bash → 失败时修复子代理)

(cd "$PROJECT_DIR" && npx hyperframes lint . && npx hyperframes inspect .)

exit 0 → 完成。出现 lint/inspect 错误时,分发修复子代理(agents/finalize.md:快照 QA + 一次就地修复 + 重新渲染)。修复过程中永远不要更改固定时长。

报告 + 可选预览

报告最终输出(renders/video.mp4,或 .webm / .mov 叠加变体)+ 时长。运行期间不要打开预览。 仅在请求时提供,且在渲染之后启动,以便提供最终文件:

(cd "$PROJECT_DIR" && npx hyperframes preview)   # Studio UI;或 `npx hyperframes play` 获取可共享链接

标志位于 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 存在,没有 renders/video.mp4步骤5(渲染)+ 步骤6
renders/video.mp4 存在报告 + 停止

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

  • 资产优先的理由: 素材获取提前进行,并指导镜头设计(RWA 流程:分析 → 搜索 → 审查 → 合成)。搜索驱动类别(webpage/news/tweet)和 asset-fusion 都依赖于媒体使用的搜索(新闻/网页/推文/图片),这是媒体使用记录的 RWA 血统。
  • 复用优先: 生态系统中 LLM 生成模板的类比是“组合目录块 + hyperframes-animation 规则”。HF 的暂停 GSAP 时间线相当于 Remotion 的 useCurrentFrame。
  • 类别模块约定: 一个 categories/<id>/module.md(规划 + 构建),共享 references/motion-vocabulary.md(+ 可选评估)。添加一个类别 = 放下文件夹 + 在 agents/director.md 中注册其分类器行 + 在 catalog-map.md 中注册其行;阶段流程保持不变。
  • 目录结构:
    videos/<project-name>/
      hyperframes.json  context.log
      shot-plan.json            # IR(导演输出)
      assets/  assets/index.md  # 媒体使用输出(如果已获取)
      compositions/index.html   # 构建器输出
      renders/video.mp4
    
  • 注册: 在 hyperframes 路由器中——添加“设计主导的短动态图形”意图 + 工作流描述;从 /general-video 中切出 motion-graphics 触发器;添加反向禁止使用的边。参见 motion-graphics-genre.md §5-7。

Individual skills in this repo

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

1345AbhishekKumar/starter-supabase

Add captions to a talking-head video. ONE catalog (CATALOG.md) of 32 visual identities behind two engines: column-flow (captions composited INTO the scene — matte occlusion + mix-blend; cream/ink/editorial/keynote/documentary/loud/neon/glitch/chrome/velocity) and themed constitutions (anchor/ordnance/terminal/neonsign/stardust/stomp/scoreboard/transit/vhs/arcade/dossier/laser/thunder/hologram/biolume/aurora/spectrum/papercut/popup/chalkboard/graffiti/brush/inkwater/ransom/lastpage/nightcity — e.g. a glyph-decode climax, a neon sign WRITTEN stroke by stroke, or the quiet `anchor` rail default). Route by identity, never by mode. Trigger on "captions/subtitles", "embed/cinematic captions", "VFX captions", "炸/特效/酷炫字幕", a named identity, or top-tier motion-graphics asks. Embedding every word is wrong for most talking-head content — `anchor` is the verbatim default. Pipeline: transcription → hyperframes remove-background matting → HTML render → ffmpeg overlay. Requires hyperframes and a single-subject clip.

1345AbhishekKumar/starter-supabase

The fallback workflow for authoring custom HyperFrames video compositions at any length or format — longer or multi-scene pieces, brand / sizzle reels, montages, title cards, static loops, and freeform compositions. Input- and length-agnostic. If a specialized workflow clearly fits the input — a marketed product, a website, a topic explainer, a GitHub PR, existing footage, a short motion graphic, or a Remotion port — prefer it (see /hyperframes); use this only as the general fallback when none fit.

1345AbhishekKumar/starter-supabase

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.

1345AbhishekKumar/starter-supabase

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

1345AbhishekKumar/starter-supabase

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.

1345AbhishekKumar/starter-supabase

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

1345AbhishekKumar/starter-supabase

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.

1345AbhishekKumar/starter-supabase

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

1345AbhishekKumar/starter-supabase

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.

1345AbhishekKumar/starter-supabase

turn a product or marketing URL, pasted script, or brief into a product launch video, including SaaS promos, feature reveals, app launches, company promos, and product marketing videos. Use this skill when the user wants to market, launch, promote, or reveal a product. Do not use it for general non-launch website tours, non-product topic explainers, GitHub pull requests, captioning existing footage, or short unnarrated motion graphics. If the intent is unclear, route through /hyperframes first. This is the new shot-sequence architecture: every visual frame is authored as a time-coded shot sequence picked from a menu of golden blueprints, so frames develop over their full duration instead of freezing after entrance.

1345AbhishekKumar/starter-supabase

turn a GitHub pull request (a PR URL like github.com/<owner>/<repo>/pull/<N>, an <owner>/<repo>#<N> ref, or 'this PR' in a checked-out repo) into a code-change explainer video, up to ~3 min (sweet spot 30-90s) — changelog, feature reveal, fix, or refactor walkthrough, rendered from the diff / commits / files. The input is a CODE CHANGE read via the gh CLI; there is no website capture. Use this skill for a GitHub PR. Do not use it for a product launch/promo (use /product-launch-video), a tour of a real website (use /website-to-video), a topic explainer with no PR (use /faceless-explainer), captions on existing footage (use /embedded-captions), or a short unnarrated motion graphic (use /motion-graphics). If the intent is unclear, route through /hyperframes first.

1345AbhishekKumar/starter-supabase

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.

1345AbhishekKumar/starter-supabase

Capture a general website/URL and turn it into a HyperFrames video (site tour, showcase, or social clip from the site's own visuals). Uses headless Chrome screenshots + brand assets. Use when intent is general — portfolio/blog/landing-page showcase or social clip from the site. NOT for: product/SaaS launch or promo (→ /product-launch-video, even from a URL); topic explainer with no site (→ /faceless-explainer); GitHub PR (→ /pr-to-video); adding captions to existing video (→ /embedded-captions); short unnarrated page-highlight motion graphic (→ /motion-graphics). Unclear launch-vs-general-site? Ask one question or start at /hyperframes.

相关技能