Communitygithub.com

TheAngryPit/TheAngrySkills

短小精悍的视觉动效设计,用动画本身传递信息——动态排版、统计计数、图表可视化、标志开场、底部标题、地图动画、推文/新闻动画、网页或UI动画,以及将真实图像的几何结构融入图表。通常在10秒以内(最长约30秒),无旁白或真人主体,输出MP4或透明叠加层。

TheAngrySkills 是什么?

`TheAngryPit/TheAngrySkills` 是一个面向AI代理(如Claude Code、Cursor、Codex)的技能,专注于生成短小、设计驱动且无旁白的动态图形。该技能强调“动画即信息”,涵盖多种类别,包括动态排版、统计计数、图表可视化、标志出场、底部标题、地图动画、推文/新闻动画、网页/UI动画,以及将真实图像的几何结构嵌入图表等。它遵循严格的资产优先工作流程:先确定资产策略并获取真实素材,再进行镜头设计,最后通过复用目录能力进行合成。支持苹果Silicon或Linux x64系统,依赖Node.js和ffmpeg,并能通过HyperFrames工具链进行渲染、验证和预览。该技能旨在高度自主,通常只提一个澄清问题,之后从构建到验证一气呵成,最终用户决定是预览还是直接渲染输出MP4或透明叠加层视频。

兼容平台~Claude Code~Codex CLI✓Cursor✓Gemini CLI
npx skills add https://github.com/TheAngryPit/TheAngrySkills/tree/HEAD/skills/mirrors-hyperframes/hyperframes-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)直接路由至此,无需询问运行形态问题;故事板和配套会话对于这么短的内容帮助不大。渲染仍由用户把关:检查与证据快照通过后,按照 ../hyperframes/references/brief-contract.md 的规范询问规范的“先预览还是直接渲染?”问题。当 BRIEF.md 存在时,在导演提问前先阅读它。

一个短小设计驱动的动态图形。资产优先:在开始设计镜头之前先决定资产策略并获取真实素材,然后围绕已有素材设计镜头,再通过复用目录能力进行合成。所有产物放入 PROJECT_DIR = videos/<项目名称>/(在第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: [],直接从规划跳转到设计。

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

规划 阶段的第一个决策是:是否需要搜索? 这个分叉将类别分为两组;然后选择具体类别——对于搜索驱动型,根据搜索返回的内容类型。每个类别是一个 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 最新版本的差异,如果有任何技能过时,则更新全局集合。

约束: 永远不要在 workspace 根目录执行 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[](news / web / tweet / image;两极查询)。具体的搜索驱动类别(webpage / news / tweet / asset-fusion)在第二步根据返回的内容类型确认,并在第三步最终确定。
  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> + 就地定制;仅手动编写间隙 + asset-fusion 特殊处理。输出 compositions/index.html,遵循 HF 契约(暂停的 GSAP 时间线在 window.__timelines 上,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 --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步(批准)
批准的渲染已存在验证输出,然后报告

设计笔记(维护者——执行时不读取此部分)

  • 资产优先的理由: 素材获取前置,为镜头设计提供信息(RWA 流程:分析 → 搜索 → 审查 → c…

[截断以适应翻译]

相关技能