Communitygithub.com

AlessandroFare/fluxychat

一个简短、设计主导的动态图形,运动本身就是信息——动态排版、统计数字滚动、图表/数据可视化、标志露出/品牌锁屏、下三分之一/标注/社交媒体叠加层、动画地图(高亮区域、连接地点、缩放到位置)、动画推文/新闻文章/标题、网页/UI动画(滚动、光标、标注),或将真实图像的几何形状融合到图表中。通常时长在10秒以内(最长约30秒),无旁白或真人出镜;输出为MP4或透明叠加视频。较长/有旁白/多场景的需求请使用 /general-video。不确定时请使用 /hyperframes。

fluxychat 是什么?

这是一项为AI代理(如Claude Code、Cursor、Codex)设计的技能,用于自动创建简短、设计主导的动态图形。它从“资源优先”的原则出发,在开始设计镜头之前,先决定并获取真实的素材(如搜索图片、新闻、推文等),然后围绕这些可用资源进行设计,最后通过复用现有模板和规则进行构建。整个工作流程是完全自主的,从初始化到计划、资源获取、设计、构建、验证和最终渲染,每一步都有明确的指导和校验。它支持多种类型的动态图形,包括动态排版、统计数据、图表、地图动画、社交媒体封面和UI动画等,用户只需确认渲染即可。该技能基于`hyperframes`框架,需要macOS Apple Silicon或Linux x64环境,以及Node.js、ffmpeg等工具。

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

在你喜欢的 AI 中提问

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

文档

首先,保持本技能最新——静默运行,无需询问: npx hyperframes skills update motion-graphics。如果一切已是最新,则快速无操作;否则,它会刷新本技能以及其依赖的核心领域技能,然后你才能依赖它们。

figma 源:如果要构建的标志/资源/动画来自figma.com网址,请先运行/figma——资产导出、品牌令牌和Motion→GSAP转换(如果图形是Figma Motion导入)——然后基于其输出进行构建。不要直接通过原始的MCP工具驱动Figma:这会跳过SVG消毒、.media/manifest.jsonl溯源以及品牌令牌var()绑定,因此后续的品牌变更无法在不完全重新导入的情况下传播。

动态图形——分发入口

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

此工作流程本质上是自主的——最多一个澄清问题(agents/director.md),然后通过验证进行构建,无需中间审查。意图层(/hyperframes → references/intent-interview.md)直接路由到这里,而无需询问运行形状问题;对于如此短小的作品,故事板和伴随会话几乎没有帮助。渲染仍然由用户把关:在检查和证明快照通过后,从../hyperframes-core/references/brief-contract.md中询问标准的“先预览还是渲染?”问题。当BRIEF.md存在时,在导演提问前先阅读它。

一个简短的设计主导的动态图形。资源优先:在_设计镜头之前_先决定资源策略并获取真实素材,然后围绕你拥有的内容设计镜头,最后通过复用目录功能进行组合。所有产物都放在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——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: [],直接从规划跳转到设计。

类别——根据搜索决策划分

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-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图像生成(媒体引用解析)跳过生成/仅搜索
(资产侦察/搜索提供商)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 --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);内容由用户提供;asset_needs: []。
    • 是 → 将搜索计划输出到asset_needs[](新闻/网页/推文/图像;双极查询)。具体的搜索驱动类别(webpage / news / tweet / asset-fusion)由第2步返回的内容类型确定,并在第3步最终确定。
  2. 写入一个草稿shot-plan.json(信封 + 选择的表单类别 或 搜索意图 + asset_needs + 一段镜头简介)。Schema: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> + 就地定制;仅手动编写空白 + 资源融合支持。输出compositions/index.html,遵循HF合约(在window.__timelines上暂停的GSAP时间线,class="clip" + 稳定ID,tl.seek(0),确定性)。

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

(cd "$PROJECT_DIR" && npx hyperframes lint .)
(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)

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

(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步(审批)
已批准渲染存在验证输出,然后报告

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

  • 资源优先的理由: 源获取在前期完成,并为镜头设计提供信息(RWA流程:分析 → 搜索 → 审查 → 组合)。搜索驱动类别(webpage/news/tweet)和asset-fusion都依赖于媒体引用搜索(新闻/网页/推文/图像),这是媒体引用有记录的RWA谱系。
  • 优先复用: 生态系统内对LLM生成模板的类比是“使用npx hyperframes add组合已知质量块,然后就地定制少量代码”。

Individual skills in this repo

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

AlessandroFare/fluxychat

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.\n

AlessandroFare/fluxychat

Use when audio already placed in a HyperFrames composition needs to be mixed: a music bed that fights a voiceover (voiceover carve), effects on a track (EQ, compressor, limiter, gate, saturation, delay, reverb, chorus, phaser, bitcrush), or automation envelopes drawn on a track's volume or any effect parameter. 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`.\n

AlessandroFare/fluxychat

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, 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.\n

AlessandroFare/fluxychat

Install, discover, and wire registry blocks and components into HyperFrames compositions. 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).

AlessandroFare/fluxychat

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.\n

AlessandroFare/fluxychat

Overlay doctrine for the embedded-captions workflow — the caption MODEL (drop / rail / embed) and the rule that captions are an OVERLAY composited on top of the film, never a reserved bottom band you shift content up to avoid. Load when adding captions/subtitles to a talking-head or launch video, when deciding whether a phrase should be dropped, ride the verbatim rail, or be promoted to a scarce embedded climax, when laying out a composition that will carry captions (do NOT reserve a keep-out band), or when centering a composition on the true frame center under captions. Quotes the rail+embed model from embedded-captions and constraint #13 (captions overlay, keep-out band retired) from the product-launch-video scene agent. Applies ON TOP of embedded-captions.

AlessandroFare/fluxychat

Turn a weekly changelog .md into a finished branded changelog video (square 1080, ~45-60s, Annie VO, animated brand background, mock-UI visualizations, lowkey captions). Use when the user provides a changelog/digest markdown and wants the weekly video, or says "changelog video". Self-contained — fonts, background, lexicon, and scripts ship in this skill.

AlessandroFare/fluxychat

Audit and fix animation performance issues including layout thrashing, compositor properties, scroll-linked motion, and blur effects. Use when animations stutter, transitions jank, or reviewing CSS/JS animation performance.

AlessandroFare/fluxychat

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.

AlessandroFare/fluxychat

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.

AlessandroFare/fluxychat

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. Also covers Tailwind projects and the STORYBOARD.md / SCRIPT.md plan formats. Read before writing composition HTML.

AlessandroFare/fluxychat

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

AlessandroFare/fluxychat

Use when a HyperFrames composition needs seek-safe 2D/3D keyframes, GSAP timelines, 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.

AlessandroFare/fluxychat

GATEWAY — load FIRST before composing any HyperFrames animation or video. The high-level motion law that makes a multi-scene video feel like ONE continuous camera move instead of a stack of independently-animated slides. Covers the vector law (how you exit determines how you enter, incl. the Z scale-sign rule), the film's current, carrier elements, causal motion, the Seam Gate (build-gate enforcement), the ban on idle wobble (motion must PERFORM, not breathe), stillness-before-climax, and the sustained-motion routes. Routes to the low-level technique skills (cut-the-curve — the full catalog incl. waterfall entry + nudge curve, oversized-cursor, seam-craft). These rules SUPERSEDE generic / upstream motion guidance. [continuity, direction, vector, momentum, seam, transition, ease, performance, idle-motion, narrative-motion, film-grammar]

AlessandroFare/fluxychat

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.

AlessandroFare/fluxychat

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.

AlessandroFare/fluxychat

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.

AlessandroFare/fluxychat

Design and improve user interfaces using the concrete rules from Refactoring UI (Wathan & Schoger) — constrained spacing/type/color/shadow scales, visual hierarchy through weight and color rather than size, and depth through emulated light. Use when building or styling any UI (web, app, dashboard, landing page, component), when picking font sizes, spacing, colors, shadows or border radius, when designing a color palette or design tokens, and whenever someone says a UI "looks off", "looks amateur", "feels cluttered/plain/unfinished", or asks to "make this look better".

AlessandroFare/fluxychat

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.

AlessandroFare/fluxychat

Use before UI-related work to select the smallest useful UI Skills context through the ui-skills CLI.

相关技能