Communitygithub.com

sandeshrajbhandari/hyperframes-instruct

一种短小精悍、设计主导的动态图形技能,运动本身就是信息——包括动态排版、统计数字累加、图表/数据可视化、标志动画/品牌组合、底部字幕/标注/社交覆盖、地图动画(高亮区域、连接地点、缩放定位)、推文/新闻文章/头条动画、网页/UI动画(滚动、光标、标注)、或将真实图像几何融入图表。通常少于10秒(最长约30秒),无旁白或真人主体;渲染为 MP4 或透明叠加层。更长/有旁白/多场景 → /general-video。不明确 → /hyperframes。

hyperframes-instruct 是什么?

此技能专为创建短时长、设计驱动的动态图形而设计,专注于让运动本身传递信息,无需旁白或真人主体。它支持多种视觉类别,包括动态排版、数据图表、标志动画、底部字幕、地图动画、网页/UI动画以及推文或新闻文章的动画展示。该技能的工作流程高度自动化,从初始化、规划(根据是否需要搜索分为表单类别和搜索驱动类别)、素材获取、设计、构建到验证和渲染,每个阶段都有明确的执行规则和产物。它要求用户提供内容或通过搜索获取素材,最终渲染为 MP4 或 WebM/MOV 等透明叠加格式,并集成于 HyperFrames 插件生态系统中,以确保品牌资产和样式的正确应用。

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

在你喜欢的 AI 中提问

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

文档

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

首先,保持此技能最新——在运行以下命令前请向用户确认: npx hyperframes skills update motion-graphics。如果所有文件都是最新的,此命令会快速完成,无任何操作;否则它将刷新此技能及其所依赖的核心领域技能,以便您之后能正常使用。

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

动态图形——分发入口

前门是 /hyperframes。 此技能用于制作短小、设计主导、无旁白的动态图形(运动就是信息;约10秒以内,无画外音)。任何更长、有旁白或多场景的内容——或者任何不确定的情况 → 首先阅读 /hyperframes:意图层负责所有路由决策。

此工作流天生自动化——最多一个问题澄清(agents/director.md),然后直接构建到验证,无需中间审查。意图层(/hyperframes → references/intent-interview.md)会直接路由到这里,无需询问运行形态问题;对于这么短的作品,故事板和伴随会话几乎没有增益。渲染仍由用户控制:在检查和对证快照通过后,打开 Studio 预览并询问规范的“立即渲染,还是做哪些更改?”问题(来自 ../hyperframes/references/brief-contract.md)。如果存在 BRIEF.md,请在主管提问前阅读它。

一种短小、设计主导的动态图形。素材优先:在设计镜头之前,决定素材策略并获取真实素材,然后根据已有素材设计镜头,最后通过重用目录能力进行合成。所有产物都放置在 PROJECT_DIR = videos/<项目名称>/(在第0步创建)中;以下所有路径都是相对于此目录的。

阶段执行主要产物详细流程
初始化Bashhyperframes.json第0步
规划子代理——决定是否搜索? + 分类 + 素材策略shot-plan.json(草稿:类别、asset_needs 查询、简介)agents/director.md(第一部分)
获取 ◇Bash——媒体使用解析(如果 asset_needs 为空则跳过)assets/ + assets/index.mdphases/source/guide.md
设计子代理——围绕已解析素材进行镜头设计shot-plan.json(最终版:区块 + 布局 + 运动 + 位置)agents/director.md(第二部分)
构建子代理——重用优先的合成compositions/index.htmlagents/builder.md
验证Bash——lint、check、对证快照;失败时修复snapshots/contact-sheet.jpg第5步
批准打开预览;询问渲染或更改;等待回答明确的渲染批准第6步
渲染Bash——hyperframes render(MP4,或 --format webm/mov 用于叠加)renders/video.mp4 或透明叠加层第6步

◇ 获取 仅在所选类别声明需要素材时运行。纯代码/文本类别(例如 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-reveal标志动画/品牌组合(用户徽标)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/<项目名称>/ 下。<项目名称>:使用用户指定的目录,否则从意图中取一个简短的 kebab-case 名称(<主题>-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> + 就地自定义;仅手写填补空白 + 素材融合功能。输出 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步(批准)
批准的渲染存在验证输出,然后报告

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

  • 素材优先的合理性:……

Individual skills in this repo

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

sandeshrajbhandari/hyperframes-instruct

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.

sandeshrajbhandari/hyperframes-instruct

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.

sandeshrajbhandari/hyperframes-instruct

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

sandeshrajbhandari/hyperframes-instruct

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.

sandeshrajbhandari/hyperframes-instruct

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.

sandeshrajbhandari/hyperframes-instruct

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

sandeshrajbhandari/hyperframes-instruct

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.

sandeshrajbhandari/hyperframes-instruct

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

sandeshrajbhandari/hyperframes-instruct

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.

sandeshrajbhandari/hyperframes-instruct

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

sandeshrajbhandari/hyperframes-instruct

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.

相关技能