前言¶

电商和本地门店常见需求是：主图旁边要一条能讲清楚卖点的主图视频，或一条能直接发抖音、小红书的种草短片。传统做法要拍素材、写脚本、配音、剪辑，周期和成本都压在运营或小团队身上。若你已经在用 Agent 处理文案和素材整理，更希望把「从商品图到成片」收成一条可重复的工作流，而不是每次从零搭时间线。

下面介绍 SkillHub 上的 商品视频工作室（@beatra-ai/product-video-studio）：从一张商品图出发，生成带口播的 9:16 竖屏视频，适合上架、主图视频和门店推广等场景。

这是什么¶

商品视频工作室 是 beatra 发布的企业来源 Skill（SkillHub 分类：design-media，当前版本 0.2.1）。坐标为 @beatra-ai/product-video-studio。

它解决的是：在不上传拍摄素材、不手工剪辑的前提下，用一张商品图加上你补充的商品信息，产出一条可发布的竖屏带货短视频。官方说明中的处理顺序是：先做 9:16 竖屏首帧，再根据画面可见细节与商品信息撰写口播文案，选配声音后合成成片。

SkillHub 标签标明 requires_api_key=false，即按页面说明安装使用时不需要单独配置 API Key（具体以你当前 Agent 环境与 Skill 包内说明为准）。

核心功能¶

以下能力均来自 SkillHub 官方简介，未在页面上单独展开的能力不写入。

1. 竖屏首帧：以你提供的商品图为输入，生成 9:16 竖屏画面的首帧，适配短视频竖屏规格。
2. 口播文案：结合图中可见细节与你提供的商品信息，生成适合口播的带货文案。
3. 配音与成片：选择合适的声音完成配音，输出一条带口播、可直接用于发布的视频。

适用方向在官方文案中包括：新品上架、商品主图视频、种草短视频、门店推广，以及把随手拍的商品照片变成带货视频。

安装与启用¶

SkillHub 页面给出的安装方式是：让当前 Agent 按官方安装文档执行，目标 Skill 为 @beatra-ai/product-video-studio。

1、安装 SkillHub CLI（若尚未安装）¶

先检查是否已安装：

command -v skillhub && skillhub --version

未安装时，可按 SkillHub 安装文档执行完整安装（CLI + 默认 Skill）：

curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash

仅需要 CLI 时：

curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only

2、安装本 Skill 到当前 Agent 的 skills 目录¶

安装时必须用 --dir 指向当前 Agent 识别的 skills 目录，否则默认会装到 ./skills/，Agent 可能无法加载。常见路径如下（摘自 SkillHub 安装文档）：

• Cursor：~/.cursor/skills/
• Claude Code：~/.claude/skills/
• Codex：~/.codex/skills/ 或项目下的 .agents/skills/

安装命令示例（将 <skills 目录> 换成你环境中的实际路径）：

skillhub install beatra-ai/product-video-studio --dir <skills 目录>

也可在对话中直接发给 Agent 的提示（与 SkillHub 技能页一致）：

请根据 https://skillhub.cn/install/skillhub.md，安装 `@beatra-ai/product-video-studio`。

安装后按你所用 Client 的要求重启或刷新 Agent，使新 Skill 生效。Cursor、Codex CLI、Claude Code 的差异主要体现在 skills 目录路径 上，安装步骤本身均遵循上述 skillhub install 与官方 install 文档。

典型用法¶

公开页面未提供带固定参数的命令行示例；本 Skill 基于通用 SKILL.md 格式，实际交互在 Agent 对话中完成。可按官方描述的工作流复现如下。

1. 准备输入：一张清晰的商品图（主图、实拍或门店照片均可），以及口播需要的商品信息（名称、卖点、价格或活动、适用人群等——以你在对话中提供给 Agent 的内容为准）。
2. 启用 Skill：确认 @beatra-ai/product-video-studio 已安装并被 Agent 加载。
3. 发起任务：在对话中说明要生成竖屏带货视频，附上商品图，并写明希望强调的信息；若需要特定音色或风格，在同一轮说明中提出（具体可选声音以 Skill 运行时的能力为准，页面未枚举时不臆造选项列表）。
4. 验收成片：按 Skill 输出获取生成的视频文件或路径，检查画面比例是否为竖屏、口播是否与商品信息一致，再用于上架或发布。

经过上面的步骤，你完成的是「图 + 商品信息 → 9:16 口播成片」的闭环，而不是在剪辑软件里从零搭轨道。

适用场景与注意¶

适合谁

• 需要快速做商品主图视频、上新短视频的电商运营或店主。
• 内容团队要把已有商品图扩展成口播种草片，但不想每次走完整拍摄剪辑流程。
• 已在 Cursor、Claude Code、Codex 等环境使用 Skills，希望把带货视频生成嵌进现有 Agent 工作流。

使用上需注意

• 成片质量依赖商品图清晰度、以及你补充的商品信息是否准确完整；图中看不清的细节，口播不应指望凭空补全。
• 版本以 SkillHub 为准（当前 0.2.1）；升级可用 skillhub 按同一 --dir 策略更新，具体子命令以 install 文档为准。
• 企业来源 Skill，使用前请确认你所在环境对 SkillHub 与企业技能包的合规要求。
• 页面统计（截至资料抓取）：SkillHub 评分 100000，下载 14049 次，可作为选用参考，不代表单次生成效果保证。

结尾¶

商品视频工作室把「竖屏首帧 → 口播文案 → 配音成片」串成一条从商品图出发的链路，适合把主图和随手拍照片快速变成可发布的带货短视频。安装与坐标以 SkillHub 为准。

• SkillHub 技能页：https://www.skillhub.cn/skills/beatra-ai/product-video-studio
• 官方 API 坐标页：https://api.skillhub.cn/beatra-ai/product-video-studio
• 安装说明：https://skillhub.cn/install/skillhub.md