Communitygithub.com

1345AbhishekKumar/starter-nextjs

用于创建短小精悍、以设计为主导、无旁白叙述的动态图形,时长通常不超过10秒,如动态字体、数据统计动画、Logo展示等。

starter-nextjs 是什么?

该技能专为生成短时长、高设计感、以动效为核心表现力的动态图形而设计,典型时长在10秒以内,最长约30秒。它不支持任何形式的旁白叙述、配音或真人实拍。技能内部采用严格的资产优先(Asset-First)工作流:首先确定需要何种资产(文本、数据、图片或网页链接),然后围绕实际可用的资产进行镜头设计,最后复用现有的组件库进行合成渲染。整个流程包含初始化、规划、资源获取、设计、构建、渲染和验证七个标准化步骤,并支持MP4或透明背景叠加格式输出。若不确定当前需求属于此类短动效还是需要旁白的长视频,技能建议先查阅`/hyperframes`进行确认。

兼容平台~Claude Code~Codex CLI✓Cursor✓Gemini CLI
npx skills add https://github.com/1345AbhishekKumar/starter-nextjs/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创建);以下所有路径均相对于此目录。

阶段执行方式主要工件详细流程
initBashhyperframes.json步骤0
plan子智能体 — 决定是否搜索? + 分类 + 资产策略shot-plan.json(草稿:类别、asset_needs 查询、简报)agents/director.md(第1部分)
source ◇Bash — 媒体用途解析(如果 asset_needs 为空则跳过)assets/ + assets/index.mdphases/source/guide.md
design子智能体 — 围绕已解析资产进行镜头设计shot-plan.json(最终版:区块 + 布局 + 动效 + 位置)agents/director.md(第2部分)
build子智能体 — 复用优先的组合compositions/index.htmlagents/builder.md
renderBash — hyperframes render(MP4,或 --format webm/mov 用于叠加)renders/video.mp4步骤5
verifyBash — lint / inspect -> 失败时调修复子智能体(原地修复)agents/finalize.md

◇ 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-* + 注册表覆盖层块

搜索驱动型类别 — 先搜索,然后按内容类型制作动画(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图片生成(媒体用途解析)跳过生成 / 仅搜索
(资产搜索/搜索提供商)webpage/news/tweet + asset-fusion 真实资产搜索类别降级为无资产

流程

步骤 0 — 初始化

当前工作目录是智能体工作区根目录;所有工件写入 PROJECT_DIR = videos/<project-name>/。<project-name>:使用用户提供的目录名称,否则从意图中获取一个简短的短横线命名(<主语>-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> + 原地自定义;仅手工编写缺口 + asset-fusion 功能。输出 compositions/index.html,遵守 HF 约定(暂停的 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:快照质量检测 + 一轮原地修复 + 重新渲染)。修复过程中绝不改变固定时长。

报告 + 可选预览

报告最终输出(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-nextjs

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-nextjs

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-nextjs

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-nextjs

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-nextjs

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-nextjs

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-nextjs

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-nextjs

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-nextjs

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-nextjs

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-nextjs

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-nextjs

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-nextjs

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.

相关技能