hyperframes-cli
作者 heygen-comhyperframes-cli 是 HyperFrames 的 CLI 技能，用于在终端中构建、验证、预览和渲染视频项目。可用于项目脚手架搭建、composition 代码检查、编辑预览、转写、TTS、诊断，以及在 AI 辅助的视频编辑工作流中实现可重复的 hyperframes-cli 用法。
该技能得分 83/100，属于目录中很稳妥的候选项：触发场景清晰，CLI 工作流具体，而且操作细节足够多，能让代理在使用时少猜很多。需要注意的是，仓库只有一个 SKILL.md，没有配套脚本或参考文件，因此上手仍会有一定摩擦；它适合收录，但自动化支撑并不算深。
- 触发条件和范围都很明确：描述里列出了 init、lint、preview、render、transcribe、tts、doctor、browser、info、upgrade、compositions、docs 和 benchmark 等具体命令与用途。
- 工作流写得比较完整：清楚说明了 scaffold → write → lint → preview → render 的流程，并解释了为什么在预览前先做 lint 很重要。
- 提供了具体命令示例，提升了可触发性，包括适用于 CI/agent 的非交互式 init，以及多种模板和媒体选项。
- 仓库支持较弱：SKILL.md 中没有脚本、参考资料、资源或安装命令，因此实际采用主要依赖这份文档本身。
- 摘录中提到可能需要参考另一个技能（“see the hyperframes skill”），这意味着用户可能需要安装或先理解相关技能，才能完整走通整个流程。
hyperframes-cli 技能概览
hyperframes-cli 是 HyperFrames 的命令行技能，用于从终端构建、检查、预览和渲染视频项目。它最适合需要可重复 hyperframes 工作流的创作者、编辑和 agent，而不是一次性提示：先搭建项目、再验证 composition、在预览中检查，最后更少靠猜测地输出成片。
hyperframes-cli 是做什么的
hyperframes-cli skill 主要聚焦 HyperFrames 项目的操作层：初始化、lint、预览、渲染、转写、文本转语音、诊断和升级流程。如果你在找 hyperframes-cli for Video Editing，那么当工作依赖结构化 composition、媒体处理或可批量执行的终端命令时，就该用这个 skill。
为什么要安装它
hyperframes-cli 的核心价值在于一致性。它能降低配置摩擦，给你一套已知的工作流，并且通过 lint 在你花时间预览或渲染之前尽早发现错误。这使它在项目落地常常会被缺少上下文、项目结构不清晰或需要手动建文件这些问题卡住时，尤其有用。
最适合的用户和项目
这个 skill 适合已经有，或愿意创建，HyperFrames 项目，并希望采用命令驱动流水线的用户。它在 AI 辅助视频编辑、基于模板的 motion design、composition 校验和 agent 式项目搭建方面最强。它不是通用视频编辑器；它是面向 HyperFrames 相关工作的项目工具。
如何使用 hyperframes-cli 技能
安装并运行工具链
通过 skill 上下文走 hyperframes-cli install 流程，然后使用 npx hyperframes 运行 CLI。基础要求是 Node.js 22+ 和 FFmpeg。如果这些缺失，甚至在 skill 真正开始前，安装质量就会下降，所以先确认环境。
从真实项目目标开始
一个好的 hyperframes-cli usage 提示会明确输出内容、源素材和约束。例如：“从 clip.mp4 和 voice.mp3 制作一个 30 秒的产品预告，使用 product-promo template，保持节奏有冲击力，并且在 preview 前先 lint。”这比“做一个宣传视频”更好，因为 skill 可以把你的意图映射到 scaffold、composition 和 render 步骤上。
先读对文件
想快速上手 hyperframes-cli guide，先看 SKILL.md，再检查它创建或预期存在的项目文件。最有用的通常是工作项目里的 scaffolded composition 入口、配置文件和媒体引用。由于这个仓库刻意保持精简，SKILL.md 里的 CLI 说明就是主要事实来源。
按正确顺序执行工作流
按照 init -> lint -> preview -> render 的顺序来。先 lint，因为它能在你浪费时间渲染之前，发现缺失的 data-composition-id、重叠轨道和未注册的 timeline。如果你是在 CI 或 agent 场景里使用这个 skill，优先使用非交互式初始化，并把输入写明确切，避免工具去猜项目意图。
hyperframes-cli 技能 FAQ
hyperframes-cli 只适合 AI agent 吗？
不是。它也适合人类用户，但 hyperframes-cli skill 在你想要可预测的终端工作流时尤其有帮助。如果你本来就习惯手动编辑 composition，这个 skill 仍然能通过减少搭建和校验错误带来价值。
什么时候不该用 hyperframes-cli？
如果你需要的是通用视频编辑器、完整可视化时间线工具，或者与 HyperFrames 无关的工作流，就不要用它。hyperframes-cli guide 适用于 HyperFrames 原生项目；它并不是用来替代更广泛的 NLE 软件或通用媒体处理工具的。
它对新手友好吗？
如果你能跟着命令行工作流走，并且愿意从 template 开始，那它对新手是友好的。最容易的路径是先用一个已知示例执行 init，再在尝试自定义 render 之前先 lint 和 preview。如果你想要的是拖拽式体验，它就没那么友好。
它和普通提示词有什么不同？
普通提示词可以请求帮助，而 hyperframes-cli 提供的是一条可重复的操作路径：搭建、校验、预览、渲染和排障。当你需要在多次编辑中保持可预测输出，而不是只得到一次性的创意回复时，这一点就很关键。
如何改进 hyperframes-cli 技能
给 skill 提供具体的视频输入
最强的 hyperframes-cli usage 输入会明确时长、画幅比例、源素材、目标 template 和期望的剪辑风格。例如：“12 秒竖屏开场、一个配音轨、两个插入镜头、使用 kinetic-type、避免强烈 motion blur”——这样的信息足够结构化，能让 skill 做出更好的判断。
在渲染前先减少失败模式
大多数糟糕结果都来自 composition 意图过于模糊、媒体引用缺失，或者跳过了 lint。要提升 hyperframes-cli skill 的结果，就要先确认文件名、检查 template 是否匹配，并在 render 前先看 preview，排查时序或轨道重叠问题。如果第一版看起来不对，先修正 composition 结构，再去调整文案。
通过预览驱动迭代
把 preview 当作反馈回路来用。一次只提一个改动：节奏更紧、换 template、字体排版更干净、开头更短，或者调整旁白时间点。这样通常比要求完全重写更有效，因为 skill 可以保留已经可用的结构，同时继续打磨那些没有对上 brief 的部分。