Communitygithub.com

samyakiasonline-ctrl/hyperframe

一个设计驱动的短动态图形工具,通过动效传达信息——包含动态排版、数据计数、图表动画、Logo展示、地图动画、社交媒体覆盖、网页UI动画等。通常10秒以内(最长约30秒),无旁白或实景拍摄,输出为MP4或透明叠加层。

hyperframe 是什么?

这是一个专门用于创建短动态图形(Motion Graphic)的AI代理技能,适用于Claude Code、Cursor或Codex等平台。其核心设计理念是“动效即信息”,所有内容通过视觉运动而非旁白或实景拍摄来传达。技能支持多种类别,包括无搜索需求的表单类别(如动态排版、统计数字、图表动画、Logo展示、字幕条、地图动画)和需要搜索驱动的类别(如网页动画、新闻文章动画、推特卡片动画、资产融合动画)。工作流程高度自主化:从初始化、规划、素材获取、设计、构建、验证到最终渲染,每个阶段都有明确的自动化操作指南。该技能特别强调“资产优先”原则——先确定资产策略并获取真实素材,再进行镜头设计,最后复用目录能力进行组合。渲染前会进行代码检查、预览截图验证,并询问用户是否渲染或修改,确保最终输出质量。

兼容平台~Claude Code~Codex CLI✓Cursor✓Gemini CLI
npx skills add https://github.com/samyakiasonline-ctrl/hyperframe/tree/HEAD/.claude/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/<项目名称>/ 中(在第0步创建);以下所有路径都相对于此目录。

阶段执行主要产物详细流程
initBashhyperframes.json第0步
plan子代理——决定搜索? + 分类 + 资产策略shot-plan.json(草稿:类别、asset_needs 查询、摘要)agents/director.md(第一部分)
source ◇Bash —— 媒体使用解析(如果 asset_needs 为空则跳过)assets/ + assets/index.mdphases/source/guide.md
design子代理——围绕已解析资产进行镜头设计shot-plan.json(最终版:块+布局+动效+位置)agents/director.md(第二部分)
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。

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

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

流程

第0步 —— 初始化

当前工作目录是代理工作区的根目录;将所有产物写入 PROJECT_DIR = videos/<项目名称>/ 下。<项目名称>:使用用户指定的目录名,否则从意图中取一个短横线分隔的简短名称(<主题>-motion)。不要使用工作区的基本名称或时间戳。

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

PROJECT_DIR="${MOTION_GRAPHICS_DIR:-videos/<项目名称>}"
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步 —— 规划(子代理:导演第一部分)

调度一个子代理。提示 = 完整的 agents/director.md + ## Dispatch context(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:媒体使用,条件性)

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

优雅降级:如果搜索/提供者不可用,类别回退为无资产(在 context.log 中记录)。

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

调度一个子代理(提示 = agents/director.md 第二部分 + 调度上下文,包括已解析的 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> + 原地自定义;仅手动处理缺口 + asset-fusion 适配。输出 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 <证明时间点>)

选择能展示初始状态、关键动作和最终保持状态的证明时间点。在继续之前检查生成的联系表或截图。在 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步(批准)
已批准渲染存在验证输出,然后报告

设计说明(维护者——执行时不阅读此部分)

  • 资产优先原则:始终在开始设计之前获取/生成真实素材,确保设计围绕实际内容展开,而非理想化假设。
  • 所有动效应遵循 references/motion-vocabulary.md 中定义的共享动效词汇,确保一致性和可复用性。
  • asset-fusion 类别需要特别注意:资产几何形状与数据图表的对齐应基于实际像素位置,而非近似估算。
  • 渲染参数(-q high)和格式选项(--format webm/mov)应始终根据使用场景选择,透明叠加层通常需要 WebM 或 MOV 格式。

(原文其余部分已截断,未完整提供。以上翻译基于提供的完整内容。)

Individual skills in this repo

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

samyakiasonline-ctrl/hyperframe

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.

samyakiasonline-ctrl/hyperframe

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.

samyakiasonline-ctrl/hyperframe

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.

samyakiasonline-ctrl/hyperframe

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.

samyakiasonline-ctrl/hyperframe

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.

samyakiasonline-ctrl/hyperframe

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

samyakiasonline-ctrl/hyperframe

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.

samyakiasonline-ctrl/hyperframe

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.

samyakiasonline-ctrl/hyperframe

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

samyakiasonline-ctrl/hyperframe

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.

samyakiasonline-ctrl/hyperframe

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

samyakiasonline-ctrl/hyperframe

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.

samyakiasonline-ctrl/hyperframe

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

samyakiasonline-ctrl/hyperframe

Agent Media OS, the single skill for every media need in 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.

samyakiasonline-ctrl/hyperframe

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.

samyakiasonline-ctrl/hyperframe

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.

samyakiasonline-ctrl/hyperframe

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.

samyakiasonline-ctrl/hyperframe

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.

samyakiasonline-ctrl/hyperframe

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.

samyakiasonline-ctrl/hyperframe

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.

相关技能