Communitygithub.com

shivamsingh-007/Skill-is-All-you-Need

用于创建、生成、编辑、动画、渲染任何视频、动画、动态图形、解说片、标题卡、叠加层或 HyperFrames HTML 作品集。请勿用于浏览器自动化或使用其他框架进行屏幕录制。

Skill-is-All-you-Need 是什么?

该技能专为使用 HyperFrames 框架进行视频和动画创作而设计。它提供了一个完整的能力地图,用于路由各种视频制作任务,包括产品发布视频、网站转视频、GitHub PR 转视频、无脸解说视频,以及向现有讲话视频添加嵌入式字幕或图形叠加层。技能的核心是一个决策表,根据输入类型(如 URL、主题、PR)和目标时长(约 3 分钟以下或更长)将请求路由到专门的子工作流。HyperFrames 的工作模式要求渲染过程是确定性的、自包含的,禁止在渲染时进行网络调用或使用 `Date.now()` / `Math.random()` 等非确定性操作。该技能不支持 NLE 风格的视频编辑、屏幕录制或 AI 生成的虚拟形象,但适用于通过 HTML 组件生成动态图形、产品展示和解释性视频。

兼容平台✓Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/shivamsingh-007/Skill-is-All-you-Need/tree/HEAD/04-video-production/hyperframes

在你喜欢的 AI 中提问

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

文档

HyperFrames — 请先阅读此内容

从这里开始任何 HyperFrames 任务 — 尤其是在没有项目智能体配置(CLAUDE.md / AGENTS.md / .cursorrules)的情况下。以下是能力地图和视频路由。

能力地图 — 为每个意图选择对应技能

你想要…前往
制作一个视频(来自 URL、简报、主题、GitHub PR、现有素材或一个要动画化的元素)下面的视频路由器(§ 视频路由)
创作/编辑 HTML 作品集 — data-* 约定、片段、轨道、子作品集、变量/hyperframes-core
动画 — 原子运动规则、场景蓝图、过渡效果、运行时适配器(GSAP / Lottie / Three.js / Anime.js / CSS / WAAPI / TypeGPU)/hyperframes-animation
创意指导 — design.md、调色板、排版、旁白、节拍规划、音频响应/hyperframes-creative
媒体预处理 — TTS 配音、背景音乐、字幕、背景去除、隐藏式字幕/hyperframes-media
CLI 开发循环 — 初始化、lint、验证、检查、预览、渲染、发布、诊断/hyperframes-cli
安装注册表块/组件(hyperframes add)/hyperframes-registry

作品集创作约定(每个有时序的元素需要 data-start / data-duration / data-track-index;有时序的元素需要 class="clip";GSAP 时间线需暂停并在 window.__timelines 上注册;仅使用确定性逻辑 — 禁止 Date.now() / Math.random() / 网络)在此不重复 — 它位于 /hyperframes-core 中。在编写作品集 HTML 之前,请先阅读该内容。

HyperFrames 无法做到的事项 — 请先检查此项

HyperFrames 创作一个 HTML 作品集并将其渲染为 MP4。这种模型有严格的边界限制。超出这些边界的需求不在范围内,因此应拒绝(或指向正确的工具),而不是尝试使用工作流。以下限制源于架构,而非单个请求:

  • 渲染是确定性和自包含的。 每个值、资源和文本片段在创作时就已经固定;渲染过程中不进行网络调用或实时数据获取(核心规则:禁止 Date.now() / Math.random() / 网络)。"在渲染时实时刷新数据" 已超出范围 — 请在创作时一次性获取数据并将其固定下来,或直接拒绝。
  • 现有视频只能叠加,不能编辑。 HyperFrames 在源视频片段之上合成帧 — /embedded-captions 添加字幕层,/graphic-overlays 添加设计好的图形卡片(下三分之一、数据说明、标题)— 底层视频片段原样播放,但不会对编码的视频流进行后处理。修改视频素材本身(其时间、色彩、构图、顺序或音频)是 NLE 风格的编辑,已超出范围。
  • Remotion 导入是单向的。 /remotion-to-hyperframes 将 Remotion 框架的 源码转换为 HyperFrames。没有逆向转换(HyperFrames → Remotion,或 → 任何其他框架 — 超出范围);非 Remotion 的 React/Web 动画源码没有可转换的 Remotion 源码 — 请通过 /general-video 重新创建。
  • 无法生成它没有的输入。 不支持屏幕/会话录制、摄像头拍摄、AI 双脸/口型同步虚拟形象生成。如果素材或资源尚不存在,HyperFrames 无法凭空生成 — 请要求用户提供(或使用正确的捕获工具)来获取。

其他所有内容 — 来自 URL、简报、主题、PR、要注释的素材或单个要动画的元素的视频 — 均在范围内;请通过下面的路由进行分配。


视频路由

此部分仅了解顶层工作流。它不加载工作流内部阶段、领域技能(hyperframes-* — 请参阅上面的能力地图)或技术参考。

决策表

输入类型(意图)是主要维度;输出时长仅是上限,而非门槛。 对于匹配的输入,专业化工作流可处理最多约 3 分钟的内容 — _进入哪个_工作流由意图(输入类型,对于文本还有主题)决定,而非时长。时长仅影响高端:真正较长的内容(3-5 分钟的教程,5 分钟以上的深度分析)属于不同风格,路由到 /general-video。在 <=~3 分钟的范围内,第三个维度区分了两个基于文本的工作流 — 主题:是正在_营销_的产品还是正在_解释_的话题(请参见下方步骤 3 中的消歧规则)。

长度 / 输入产品发布(URL/简报/脚本)通用网站/URLGitHub PR / 代码变更主题/文章/笔记(无产品、无 URL)现有视频(讲话者)†
≤ 约 3 分钟/product-launch-video/website-to-video/pr-to-video/faceless-explainer/embedded-captions · /graphic-overlays †
3-5 分钟 教程/general-video/general-video/general-video/general-video/embedded-captions · /graphic-overlays †
5 分钟以上 深度分析/general-video/general-video/general-video/general-video/embedded-captions · /graphic-overlays †
静态/循环/general-video/general-video/general-video/general-video/general-video

今天的覆盖范围:≤ 约 3 分钟的区间为产品发布 / 通用网站 / GitHub-PR / 主题输入提供了专用工作流(URL 先按_类型_再按_意图_拆分 — 请参见步骤 3),现有视频列在任何长度下 — 由 /embedded-captions(隐藏式字幕/副标题)或 /graphic-overlays(设计好的图形叠加层)覆盖,按意图拆分(请参见步骤 2)。每个其他单元格都是 /general-video — 通用的 HTML 作品集创作流程(与输入和长度无关):所有长于约 3 分钟的内容(3-5 分钟 / 5 分钟以上的行)以及每个静态/循环格式。路由器从不遇到可创建视频的死胡同;唯一真正的“通用/无”答案是超出 HyperFrames 本身的请求(例如,对已完成视频文件的 NLE 风格编辑 — 重定时、重新着色、重新构图、重新排序、音频)。

† 现有素材按意图拆分,而非长度。 隐藏式字幕/副标题 → /embedded-captions;设计好的图形叠加层/封装 — 下三分之一、数据说明、有标题的卡片、引文 — → /graphic-overlays。两者都会叠加在视频片段之上,底层片段保持不变;两者都不编辑素材本身。

流派短路(优先于表格)。 一个简短(约 10 秒以下)、无旁白、以设计为主导的动态图形 — 动态文字、统计/图表动画、标志动画、下三分之一/叠加层、或动画推文/标题/截取的页面高亮 — 无论输入如何,都路由到 /motion-graphics。这是一个输出流派,而非输入类型,因此当需求明确是运动优先且无旁白时(请参见步骤 2),它优先于上述的输入类型表。较长或有旁白的作品按输入类型路由,或路由到 /general-video。

迁移现有作品集(特殊情况)

上表用于根据输入创建视频。还有一个工作流在此之外:如果用户明确要求将现有的 Remotion (React) 作品集移植/转换/迁移到 HyperFrames → /remotion-to-hyperframes。这是源码翻译,而非从输入创建,因此它没有 INTPUT × LENGTH 单元格。仅在明确的迁移语言时路由至此(“移植我的 Remotion 项目”,“转换这个 Remotion 作品”,“将其重写为 HyperFrames”)— 简单提及 Remotion 不会触发路由;默认回到创建表或 /hyperframes-core。

路由流程

  1. 确定 INPUT 类型 + 目标长度。 路由需要知道视频是关于什么的 — 其主题和输入。如果主题未指定(例如,“制作一个关于我们产品的视频”但没有 URL、命名产品、主题或可用资产),或者输入类型未知,在进入任何工作流之前请先询问 — 先澄清;不要在调用工作流技能之后再问,因为提交到工作流本身就是路由决策。最多问两个澄清问题:
    • “你的输入是什么 — 一个产品(URL 或简报)、一个通用网站/URL、一个 GitHub PR / 代码变更、一个要解释的主题或文章、还是一个需要添加字幕的现有讲话视频?”
    • “目标长度 — 大约 3 分钟或以下,还是更长(3-5 分钟的教程 / 5 分钟以上的深度分析)?”
    • 规格默认值 — 直接说明,不要询问(这些_不_影响路由,因此永远不要阻塞路由):宽高比 16:9(引擎也支持 9:16 竖屏 — 仅当用户指定了竖屏目的地如 TikTok / Reels / Shorts 时才切换);旁白/字幕语言 = 用户的语言。仅当用户提出异议时才确认;所选工作流会在其步骤 0 中重新确认自身细节。
  2. 首先按 INPUT 类型(意图)选择;时长仅是上限,而非门槛。
    • 简短以设计为主导的动态图形(流派短路,优先于输入表) — 运动本身即是信息:动态文字、统计/数字递增、图表动画、标志动画、下三分之一/叠加层、或动画推文/标题/截取的页面高亮;通常约 10 秒以下,无旁白/配音 → /motion-graphics。这是一个输出流派,而非输入类型 — 当需求明确是一个快速、无旁白、设计主导的运动作品时,无论输入如何,都路由至此。对相同素材进行较长或有旁白的处理_不是_此流派(按输入类型路由,或 /general-video)。
    • 现有讲话视频(用户有一个片段并希望在其上添加内容)→ 按意图拆分,任意长度(输入类型优先于长度):隐藏式字幕/副标题(口头词语的可读文本) → /embedded-captions;设计好的图形叠加层 — 下三分之一、数据说明、有标题的信息卡片、引文、图形封装编辑 → /graphic-overlays。(编辑素材本身 — 重定时、重新着色、重新构图、重新排序、音频 — 属于 NLE 风格,超出范围;请参见 § HyperFrames 无法做到的事项。)
    • GitHub PR / 代码变更(一个 github.com/<owner>/<repo>/pull/<N> 链接,一个 owner/repo#N 引用,或“这个 PR”) → /pr-to-video(最多约 3 分钟)。
    • 其他情况(产品 URL / 简报 / 主题文本):意图通过步骤 3 选择工作流,并且它处理最多约 3 分钟的范围 — 一个 15-30 秒的简短宣传片和一个约 100 秒的解说视频都按意图路由,而非按长度。仅当目标明显长于约 3 分钟(3-5 分钟的教程,5 分钟以上的深度分析)时,才路由到 /general-video(与长度无关的回退 — 请参见步骤 4)。切勿将真正较长的内容强制放入 ≤~3 分钟的工作流 — 意图在区间内决定,/general-video 覆盖其余内容。
  3. 消歧 ≤~3 分钟的 URL/文本输入(意图拆分)。 两个拆分:
    • URL 类型 + 意图 — URL 不再自动为 PLV 胜出;其_类型_然后_意图_决定:GitHub PR 链接(.../pull/<N>,owner/repo#N,“这个 PR”) → /pr-to-video;否则一个网站 URL 按意图拆分 — 营销/发布/推广特定产品或 SaaS → /product-launch-video;通用网站 → 视频(网站导览、作品集/博客/落地页展示、来自网站自身视觉效果的社交剪辑、或仅仅是“将这个网站转化为视频”) → /website-to-video。两者都使用 Headless Chrome 爬取;PR URL 通过 gh 读取。当确实不清楚网站 URL 是产品发布还是通用网站视频时,问一个问题。
    • 产品 vs 主题(文本,无 URL) — 决定性问题是视频是关于什么,而非输入格式:
      • 一个特定的产品 / 公司 / SaaS / 应用 / 网站正在被营销、发布或推广 → /product-launch-video。
      • 一个概念 / 主题 / 文章 / 工作原理正在被解释,没有产品且没有 URL → /faceless-explainer。
      • 决胜局:“推广/发布/销售/我们的产品”表述 → PLV。“解释/教授/工作原理/什么是 X”且无产品 → 无脸。无脸的风格始终是 pin-and-paper。
      • 一个被命名的网站但没有粘贴 URL 仍然是 PLV。 一个提及产品或其网站的脚本(“我们的网站是 acme.io”,“推广 <品牌>”)会路由到 PLV,即使没有可点击的链接 — PLV 可以搜索该网站并爬取其品牌资源(除非用户选择退出 → 无捕获预设模式)。不粘贴 URL 并不使其成为无脸/无捕获任务。对于提供脚本的字面引用 vs 重构选择是 PLV 内部的事,且永远不会改变路由。
      • 冲突线索 → 询问,不要猜测。 如果提供的来源是产品自己的营销材料(其落地页、关于其平台的推广博客),然而用户明确要求去除推广 — 对底层概念的_中立_解释,非广告 — 则将其视为真正有歧义(视频是…)

相关技能