Communitygithub.com

SingleGrain-Team/video-skills

构建动态图形:屏幕录制画面与清单并排播放,清单项目在录制的对应步骤发生时自动勾选,最终所有项目打勾并短暂停留。适用于将屏幕录制(产品演示、教程、安装指南等)与带时间戳的步骤列表结合,生成“步骤逐步完成”影片。输入为录制视频、带时间戳的步骤标签、标题和可选调色板;输出为1920x1080 H.264 MP4文件及可编辑的 HyperFrames 项目。

video-skills 是什么?

该技能用于制作“清单叠加”动态图形:左侧播放屏幕录制,右侧显示步骤清单,每个步骤在录制对应时刻自动勾选。最后停留在一个完全勾选的清单上。它支持多平台(Claude Code、Cursor、Codex 等),输入包括本地视频文件、3-7个带时间戳的步骤、标题、可选副标题和调色板。工作流程包括编写 spec.json、运行生成脚本、使用 hyperframes 校验并渲染。若未提供时间戳,技能会自动分析录制帧来推断。输出为 1920x1080 H.264 MP4 和可编辑的 HyperFrames 项目目录,方便重新生成或编辑。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/SingleGrain-Team/video-skills/tree/HEAD/skills/checklist-overlay

在你喜欢的 AI 中提问

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

文档

清单叠加

屏幕录制在左侧,清单在右侧。每个项目在对应步骤在屏幕上发生的瞬间打勾。最后一个勾选完成后,影片在完全勾选的清单上停留片刻。

输入

输入说明
录制一个本地视频文件,理想宽高比为16:9。无音频也可。
步骤3到7项:{ "label": "...", "at": <录制中的秒数> }。标签为简短的祈使短语(约2-4个词)。
标题一行文本。说明结果(例如“5步将技能添加到您的代理中”)。
副标题可选,一行文本。
调色板可选,十六进制颜色覆盖:bg, surface, panel, ink, muted, accent, border, accentInk。默认深色主题配橙色强调色。确保 accentInk 在 accent 上足够深以便阅读。

如果用户未提供时间戳,则对录制进行逐帧分析(使用 ffmpeg 每1-2秒提取帧,观察它们),并选择每个步骤明显完成或正在进行的第一个帧。请勿猜测。

工作流程

  1. 加载 /hyperframes、/hyperframes-core、/hyperframes-cli 以获取项目合约。
  2. 编写 spec.json:
    { "title": "...", "subtitle": "...", "palette": { "accent": "#ff6b2b" },
      "steps": [ { "label": "打开应用", "at": 1.5 }, { "label": "搜索", "at": 7.9 } ] }
    
  3. 将合成生成到项目目录中: node <skill>/scripts/create.mjs spec.json <recording.mp4> <project-dir> [--hold 2.2] 它会复制录制文件,提取最后一帧(以便录制结束后画面保持静止),并写入适应录制尺寸的 index.html。总时长 = 录制时长 + 停留时间(默认2.2秒)。
  4. npx --yes hyperframes check 必须通过,错误和警告均为0。
  5. 进行验证(见下文),然后渲染:npx --yes hyperframes render --workers 2 --quality delivery --output final.mp4。

时间规则

  • 勾选必须在步骤发生的那一刻,绝不提前。填充和勾选的绘制从 t = at 开始;绘制在大约0.3秒后完成。在 at 之前,项目不得显示为已勾选状。
  • 时间戳为录制时间,录制从合成时间0开始,因此 at 直接使用。如果裁剪录制,则每个 at 也相应偏移。
  • 在上一勾选完成后不久,下一个项目上可以显示“下一项”轮廓。它仅为轮廓,不填充,也不显示勾选。
  • 勾选之间至少间隔1.5秒,以便每个勾选可被感知。如果两个步骤过于接近,请合并它们。
  • 最后一个勾选应至少在录制结束前1.5秒处放置,或者通过 --hold 增加停留时间,使完成的清单至少可见2秒。
  • 计数器(n / N)、进度条和帧环脉冲均基于相同的 at 值,因此保持同步。

布局(16:9 录制)

1920x1080 画布,56像素边距。标题和副标题位于顶部;录制帧作为主要部分,宽约1250像素(约占宽度的65%),清单面板为其右侧的一列,宽520像素,与帧同高,项目均匀等分高度。这确保录制中的UI文本可读。请勿将帧宽缩小到1100像素以下;对于更高比例的画面,生成器会按宽高比缩放帧。非16:9录制:检查帧是否仍在标题下方适合,或者先裁剪录制。

标签在32像素字号下最多换行两行;请保持在约26个字符以内。

验证

在渲染的 final.mp4 上执行以下操作,而不仅仅在快照上:

  1. 对每个步骤,提取 at 前0.08秒和一帧,以及 at 后0.45秒的一帧:ffmpeg -ss <t> -i final.mp4 -frames:v 1 f.png
  2. 检查这些帧。之前:项目未勾选,计数器为 i-1。之后:项目已填充并带有勾选,计数器为 i,进度条已前进。
  3. 在最终停留期间提取一帧(约在结束前0.2秒):所有项目均已勾选,计数器显示 N / N,进度条已满。
  4. 检查录制中的文本是否清晰可读,没有标签被裁剪。如有问题,修正 spec.json 或调色板并重新生成。
  5. 使用 ffprobe 检查文件:1920x1080,h264,时长 = 录制时长 + 停留时间。

交付

报告 final.mp4 的路径、时长以及使用的步骤时间戳。保留项目目录(index.html、assets/、spec.json),以便稍后可以使用不同的标签或调色板重新生成影片。如果用户希望在 Studio 中编辑,先打开 npx hyperframes preview。

Individual skills in this repo

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

SingleGrain-Team/video-skills

Make a 30-45 second launch film for a product by staging it inside one persistent, neutral chat window. A user types a request, the assistant answers and calls the product as a connected tool, a progress card runs, a follow-up triggers a second tool action, and the result lands as a count-up headline number before closing on the logo, tagline and call to action. Use when you need a launch, feature or integration announcement video for something that plugs into AI assistants (a skill, MCP server, plugin, connector, CLI). Delivers a rendered 1920x1080 MP4 plus an editable single-file HyperFrames project.

SingleGrain-Team/video-skills

Build a 15-20 second product launch film that shows the product's real screen on a laptop built from plain CSS (no 3D model, no generation model) in a dark studio, scrolls the page, zooms into the interface for one key action such as typing a search, and resolves to the logo lockup. Use when someone has a full-page screenshot or screen recording of their product, one action worth showing, and a logo, and wants a short silent-friendly launch teaser rendered as a 1920x1080 MP4 with an editable HyperFrames project.

SingleGrain-Team/video-skills

Builds a 6-8 second logo sting in which the brand mark rides inside a refracting liquid bead (distorted past legibility), the bead swells, holds still for a beat, then ruptures into droplets and leaves the logo lockup (mark plus wordmark) crisp and upright on screen. Delivered as a 1920x1080 H.264 MP4 plus the editable HyperFrames project, with no 3D model, stock footage or generation model. Use it for brand intros and outros, product-launch openers, channel stings and any "reveal our logo" moment, from an SVG or PNG logo (including raster-only logos), a wordmark string and a palette.

SingleGrain-Team/video-skills

Make a 20-30 second launch film for a product that is not tied to one interface, such as a CLI, package, plugin or agent skill. The identical prompt or command is typed into four visually different surfaces in turn (a wide terminal, a tall chat card, a floating palette, an editor cell), the film then hard-cuts into a fast reel of real outputs on a beat or fixed tempo grid, and it closes on the command in a large pill. Delivered as a rendered 1920x1080 MP4 plus the editable HyperFrames project. Music is optional - with a track the cuts land on detected beats, without one they land on a 120 bpm grid.

SingleGrain-Team/video-skills

Make a roughly 30-second film that explains a code change (a pull request, release or uncommitted diff) to people who will never read the diff. It opens by showing the real diff scrolling past too fast to follow, cuts to a plain-language summary, fires four capability beats each pinned to a real code snippet, and closes on how to get it (install command and URL). Delivered as a 1920x1080 H.264 MP4 plus the editable HyperFrames project. Use when asked to turn a PR, changelog or release into a launch or explainer video.

SingleGrain-Team/video-skills

Render a 5-6 second motion graphic in which an oversized condensed headline (2-4 words) punches in behind a presenter, using a background-removed cutout of the presenter layered on top of the lettering. A hard cut then removes the presenter while the same headline holds the exact same size and position, and a short supporting line appears for a reading hold. Use it for talking-head intros, chapter openers, launch announcements and social hooks when you have one presenter clip, a headline, a supporting line and a palette. Built on HyperFrames; delivers a 1920x1080 H.264 MP4 plus the editable project.

SingleGrain-Team/video-skills

Builds a 10-14 second product sting out of a short run of UI moments (an entry screen, a single counting metric, a navigation list, one click that opens a menu, then an endcard) cut together so every cut carries the previous motion forward and the piece reads as one continuous camera move. Delivered as a 1920x1080 H.264 MP4 plus an editable single-file HyperFrames project. Use it for app launches, feature teasers, social bumpers and site intros when you have a product's logo, a couple of screenshots, one headline number and its real nav labels, and want polished UI motion without narration.

相关技能