Skip to content
Back to search

ecommerce-video-skills

MarketplaceWorks with Claude CodeGitHub

12 个电商短视频 Agent Skills:3秒钩子、卖点分镜、图生视频提示词、edge-tts 配音、字幕花字、ffmpeg 自动成片、抖音/TikTok Shop/视频号导出、直播切片、多语言配音、封面A/B · Claude Code / Codex / Cursor

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/xianyu110--ecommerce-video-skills/badge.svg)](/listings/xianyu110--ecommerce-video-skills)

HTML

<a href="/listings/xianyu110--ecommerce-video-skills"><img src="/api/listings/xianyu110--ecommerce-video-skills/badge.svg" alt="findsafeskills safety rating" /></a>

Install

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

npx skills add xianyu110/ecommerce-video-skills          # 一行安装(skills CLI)
# 或在 Claude Code 里:/plugin marketplace add xianyu110/ecommerce-video-skills

手动安装:

git clone https://github.com/xianyu110/ecommerce-video-skills.git && cd ecommerce-video-skills
mkdir -p ~/.claude/skills && cp -r skills/* ~/.claude/skills/     # Claude Code(或项目内 .claude/skills/)
mkdir -p ~/.codex/skills  && cp -r skills/* ~/.codex/skills/      # Codex
mkdir -p .cursor/skills   && cp -r skills/* .cursor/skills/       # Cursor(项目内)
pip install -r requirements.txt                                    # pillow numpy edge-tts;另需 ffmpeg(含 libass)

每个 skill 文件夹自带所需脚本,互不依赖,只复制需要的即可。

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/marketplace.json · Manifest · 34 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. {
  2. "name": "ecommerce-video-skills",
  3. "owner": {
  4. "name": "xianyu110",
  5. "url": "https://github.com/xianyu110"
  6. },
  7. "metadata": {
  8. "description": "13 Agent Skills for ecommerce short videos: viral remake/breakdown, hooks, storyboards, image-to-video prompts, edge-tts voice-over, subtitles, ffmpeg auto-assembly, platform export, live clips, reviews, dubbing and cover A/B",
  9. "version": "0.2.0"
  10. },
  11. "plugins": [
  12. {
  13. "name": "ecommerce-video-skills",
  14. "description": "Chinese-first ecommerce short-video toolkit (13 skills, including viral remake) for Douyin, TikTok Shop, WeChat Channels, Xiaohongshu, Taobao and Amazon — with a working ffmpeg + edge-tts + subtitle pipeline.",
  15. "source": "./",
  16. "strict": false,
  17. "skills": [
  18. "./skills/ai-voiceover-edge-tts",
  19. "./skills/cover-title-ab",
  20. "./skills/ffmpeg-auto-assemble",
  21. "./skills/hook-3s-script",
  22. "./skills/image-to-video-shots",
  23. "./skills/live-stream-clips",
  24. "./skills/multi-model-shot-prompts",
  25. "./skills/multilingual-dubbing",
  26. "./skills/platform-spec-export",
  27. "./skills/selling-point-storyboard",
  28. "./skills/subtitles-and-text-effects",
  29. "./skills/unboxing-comparison-review",
  30. "./skills/viral-remake"
  31. ]
  32. }
  33. ]
  34. }
README.md · README · 215 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. <div align="center">
  2. # 🎬 Ecommerce Video Skills
  3. **One product photo → a ready-to-post 9:16 ecommerce video. 13 Agent Skills for hooks, viral remake, storyboards, edge-tts voice-over and a local ffmpeg render — no API key.**<br>
  4. **13 个电商短视频 Agent Skills · 一张商品图 → 带配音、字幕、BGM 的 9:16 带货视频**<br>
  5. **13 Agent Skills for ecommerce short videos — 抖音 · TikTok Shop · 视频号 · 小红书 · 淘宝主图视频 · Amazon**
  6. [![Agent Skills](https://img.shields.io/badge/Agent%20Skills-13-8b5cf6)](#-skills--技能列表)
  7. [![Claude Code](https://img.shields.io/badge/Claude%20Code-ready-d97757)](#-安装)
  8. [![Codex](https://img.shields.io/badge/Codex-ready-111111)](#-安装)
  9. [![Cursor](https://img.shields.io/badge/Cursor-ready-2563eb)](#-安装)
  10. [![ffmpeg](https://img.shields.io/badge/ffmpeg-local%20render-007808)](skills/ffmpeg-auto-assemble/SKILL.md)
  11. [![edge-tts](https://img.shields.io/badge/edge--tts-free%20voice-0ea5e9)](skills/ai-voiceover-edge-tts/SKILL.md)
  12. [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
  13. [![姊妹仓库](https://img.shields.io/badge/%E5%A7%8A%E5%A6%B9%E4%BB%93%E5%BA%93-ecommerce--image--skills-f97316)](https://github.com/xianyu110/ecommerce-image-skills)
  14. [中文](#-中文) · [English](#-english) · [效果 Demo](#-效果--demo) · [Skills](#-skills--技能列表) · [Related](#-related--相关链接)
  15. <br>
  16. <img src="https://upload.maynor1024.live/file/1791169827501_evs-one-photo-demo.gif" width="300" alt="ecommerce-video-skills demo: one product photo rendered into a 15s 9:16 video by scripts/assemble.py">
  17. <sub>👆 输入只有<b>一张</b>手机随手拍的商品图;配音、字幕花字、转场、BGM 全由 <code>scripts/assemble.py</code> 本地渲染(14.6 秒,1080×1920,无需 API Key)· <a href="https://upload.maynor1024.live/file/1791169831745_evs-one-photo-demo-9x16.mp4">下载 MP4</a><br>
  18. 👆 Input: <b>one</b> phone photo. Voice-over, captions, transitions and BGM rendered locally by <code>scripts/assemble.py</code> — no API key.</sub>
  19. <img src="https://upload.maynor1024.live/file/1791169828136_evs-one-photo-to-video.jpg" width="860" alt="one product photo in, 15-second 9:16 video out">
  20. ```bash
  21. npx skills add xianyu110/ecommerce-video-skills
  22. ```
  23. </div>
  24. ---
  25. ## 🇨🇳 中文
  26. 把「写脚本 → 找钩子 → 分镜 → 图生视频 → 配音 → 字幕花字 → 剪辑 → 导出 → 封面」拆成 **13 个可单独安装的 Agent Skill**。丢几张商品图给 Claude Code / Codex / Cursor,它会写钩子和分镜、出多模型镜头提示词,并且**真的在本地把视频剪出来**。
  27. > 💡 怎么区分同名项目:本仓库的成片步骤是**本地 Python + ffmpeg 渲染**(edge-tts 配音免 Key),**不需要任何 API Key、不依赖云端视频服务**;图生视频模型只是可选项。<br>
  28. > Not to be confused with other repos of the same name (e.g. `iart-ai/ecommerce-video-skills`): this one renders the final video **locally with ffmpeg — no API key, no cloud service required**.
  29. **和一堆提示词的区别:**
  30. - 🎬 **爆款拆解复刻**:丢链接或转写 → 拆 5-beat 结构 → 换成你的商品 → 直接出 storyboard.json
  31. - 🎞 **能跑的流水线**:`storyboard.json` → edge-tts 逐句配音 → Ken Burns 镜头 → xfade 转场 → ASS 字幕/花字 → BGM 自动闪避 → 两遍响度标准化(≈ -14 LUFS)→ MP4 + SRT。纯 Python + ffmpeg,无需剪辑软件、无需 API Key。
  32. - 🔒 **商品一致性锁**:图生视频提示词第一步先锁定形状/颜色/Logo,减少「视频很酷但商品变了」。
  33. - 🧠 **模型中立**:同一份分镜适配 Seedance / 可灵 / Veo / Runway / 海螺 / 万相 …;**不编造任何模型的价格或参数**,每个镜头都有本地 Ken Burns 兜底。
  34. - 📐 **平台规格 + 安全区**:抖音 / TikTok Shop / 视频号 / 小红书 / 淘宝主图视频 / Amazon 一键导出,字幕自动避开底部商品卡和右侧按钮。
  35. - 🌏 **出海友好**:同一份 storyboard 加 `line_en` 等字段,`--lang en` 直接渲染英文版(东南亚、日韩、拉美音色已列好)。
  36. - ⚖️ **合规意识**:钩子/评测模板内置广告法绝对化用语检查、「只写测过的数据」、公平对比规则。
  37. ### 📦 安装
  38. ```bash
  39. npx skills add xianyu110/ecommerce-video-skills # 一行安装(skills CLI)
  40. # 或在 Claude Code 里:/plugin marketplace add xianyu110/ecommerce-video-skills
  41. ```
  42. 手动安装:
  43. ```bash
  44. git clone https://github.com/xianyu110/ecommerce-video-skills.git && cd ecommerce-video-skills
  45. mkdir -p ~/.claude/skills && cp -r skills/* ~/.claude/skills/ # Claude Code(或项目内 .claude/skills/)
  46. mkdir -p ~/.codex/skills && cp -r skills/* ~/.codex/skills/ # Codex
  47. mkdir -p .cursor/skills && cp -r skills/* .cursor/skills/ # Cursor(项目内)
  48. pip install -r requirements.txt # pillow numpy edge-tts;另需 ffmpeg(含 libass)
  49. ```
  50. 每个 skill 文件夹自带所需脚本,互不依赖,只复制需要的即可。
  51. ### ⚡ 30 秒跑通示例
  52. ```bash
  53. python scripts/assemble.py examples/aura-bottle/storyboard.json -o out/aura.mp4 # 中文版
  54. python scripts/assemble.py examples/aura-bottle/storyboard.json --lang en --voice en-US-AndrewNeural -o out/aura-en.mp4 --build build/en
  55. python scripts/export_platform.py out/aura.mp4 --platform douyin tiktok-shop channels xiaohongshu taobao-main amazon
  56. python scripts/cover_ab.py out/aura.mp4 --images build/still00.png build/still03.png --titles "冰水撑不到中午?|早上的冰,晚上还在"
  57. ```
  58. ### 🚀 对 agent 这样说
  59. ```text
  60. 用 viral-remake 拆这条抖音爆款,换成我的保温杯复刻一条 15 秒分镜
  61. 用 hook-3s-script 给这个保温杯写 8 个前三秒开场,标出推荐 Top 3
  62. 用 selling-point-storyboard 按 ./photos 里的图做一条 15 秒抖音分镜,并输出 storyboard.json
  63. 用 ffmpeg-auto-assemble 把 storyboard.json 渲染成片,然后导出抖音和小红书版本
  64. 把这条视频本地化成美国英语和印尼语版本(multilingual-dubbing)
  65. 这是 3 小时直播录像和字幕,帮我切 8 条 30 秒高光(live-stream-clips)
  66. ```
  67. ### 🧭 流水线
  68. ```text
  69. 商品图 ──► hook-3s-script ──► selling-point-storyboard ──► storyboard.json
  70. │ ▲ │
  71. │ └── viral-remake(爆款链接/转写 → 拆 5-beat → 复刻分镜)
  72. └► image-to-video-shots ◄── multi-model-shot-prompts(可选:任意视频模型出镜头)
  73. ▼
  74. ai-voiceover-edge-tts ─► subtitles-and-text-effects ─► ffmpeg-auto-assemble ─► MP4 + SRT
  75. │
  76. platform-spec-export ◄──────────────────────────────────────┤
  77. cover-title-ab ◄────────────────────────────────────────────┤
  78. multilingual-dubbing(--lang en / id / th …)◄──────────────┘
  79. 直播录像 ─► live-stream-clips ─► 9:16 切片 开箱/评测 ─► unboxing-comparison-review
  80. ```
  81. ---
  82. ## 🎞 效果 / Demo
  83. **多图示例**:6 张商品图 → 17 秒成片(`examples/aura-bottle`):
  84. <img src="https://upload.maynor1024.live/file/1791117575952_evs-aura-demo.gif" width="300" alt="17s 9:16 product video rendered from 6 images by scripts/assemble.py">
  85. | 中文成片(帧) | English version (frames) |
  86. |---|---|
  87. | <img src="https://upload.maynor1024.live/file/1791117345401_evs-aura-gallery.jpg" width="420" alt="zh frames"> | <img src="https://upload.maynor1024.live/file/1791117349101_evs-aura-gallery-en.jpg" width="420" alt="en frames"> |
  88. | [▶ MP4 中文](https://upload.maynor1024.live/file/1791117346796_evs-aura-bottle-9x16-zh.mp4) · 仓库内 [docs/media/aura-bottle-9x16.mp4](docs/media/aura-bottle-9x16.mp4) | [▶ MP4 English](https://upload.maynor1024.live/file/1791117344714_evs-aura-bottle-9x16-en.mp4) |
  89. **封面 A/B**(`cover-title-ab`,用干净底图 + 3 种标题/版式):
  90. <img src="https://upload.maynor1024.live/file/1791209582741_ab_sheet.jpg" width="640" alt="cover A/B sheet">
  91. > 规格:1080×1920 · 30fps · H.264 + AAC · ≈ -14 LUFS · 17.0 秒 · 配音 edge-tts `zh-CN-YunxiNeural` / `en-US-AndrewNeural` · BGM 由 `make_bgm.py` 实时合成(免版权)。<br>
  92. > 商品「AURA」是 [ecommerce-image-skills](https://github.com/xianyu110/ecommerce-image-skills) 用 AI 生成的虚构商品,「24h 保冰」等卖点仅作演示。
  93. ---
  94. ## 🧩 Skills / 技能列表
  95. | Skill | 中文说明 | 脚本 |
  96. |---|---|---|
  97. | [`image-to-video-shots`](skills/image-to-video-shots/SKILL.md) | **主图转视频**:商品图 → 图生视频镜头提示词(运镜/动作/约束)+ 商品一致性锁 + 本地 Ken Burns 兜底 | assemble.py |
  98. | [`viral-remake`](skills/viral-remake/SKILL.md) | **爆款拆解复刻**:链接/转写 → 8 维拆解 + 5-beat → 3 个复刻角度 → 可渲染 storyboard.json | — |
  99. | [`hook-3s-script`](skills/hook-3s-script/SKILL.md) | **3 秒钩子脚本**:9 种钩子类型 + 2026 高完播角度,一次出 6–10 版(台词+画面+花字),广告法自检 | — |
  100. | [`selling-point-storyboard`](skills/selling-point-storyboard/SKILL.md) | **卖点分镜表**:15/30/60 秒结构公式,一镜一信息,直接输出可渲染的 storyboard.json | — |
  101. | [`multi-model-shot-prompts`](skills/multi-model-shot-prompts/SKILL.md) | **多模型镜头提示词适配**:通用骨架 + 运镜词表 + 文生/首帧/首尾帧写法,不编造价格/参数 | — |
  102. | [`ai-voiceover-edge-tts`](skills/ai-voiceover-edge-tts/SKILL.md) | **AI 口播配音**:edge-tts 逐句合成、去静音、时长统计、缓存;口播稿改写规则与音色推荐 | tts_edge.py |
  103. | [`subtitles-and-text-effects`](skills/subtitles-and-text-effects/SKILL.md) | **字幕与花字**:ASS 四种样式(字幕/弹出花字/贴纸/CTA)、关键词高亮、安全区 | make_subs.py |
  104. | [`ffmpeg-auto-assemble`](skills/ffmpeg-auto-assemble/SKILL.md) | **ffmpeg 自动拼接成片**:一条命令出片(配音、转场、字幕、BGM 闪避、响度标准化) | assemble.py 等 5 个 |
  105. | [`platform-spec-export`](skills/platform-spec-export/SKILL.md) | **TikTok Shop / 抖音 / 视频号规格导出**:9:16 / 3:4 / 1:1 / 16:9,模糊填充或裁切,安全区预览 | export_platform.py |
  106. | [`live-stream-clips`](skills/live-stream-clips/SKILL.md) | **直播切片**:时间戳 / 字幕关键词 / 停顿提议三种选段,批量导出竖屏切片 | live_clip.py |
  107. | [`unboxing-comparison-review`](skills/unboxing-comparison-review/SKILL.md) | **开箱 / 对比评测模板**:结构、拍摄清单、公平对比规则、storyboard 示例 | make_cards.py |
  108. | [`multilingual-dubbing`](skills/multilingual-dubbing/SKILL.md) | **多语言本地化配音**:本地化改写 + 各市场音色 + `--lang` 一键渲染多语言版本 | assemble.py |
  109. | [`cover-title-ab`](skills/cover-title-ab/SKILL.md) | **封面与标题 A/B**:自动挑清晰帧/干净底图 + 多标题版式,对比图与测试记录表 | cover_ab.py |
  110. ---
  111. ## 🔑 需要模型 / API 吗?
  112. 不需要。这些 skill 在任何能读 `SKILL.md` 的 agent 里都能用,本地剪辑脚本**不需要任何 API Key**;只有在你想用图生视频模型生成镜头时才需要对应模型的账号。第三方模型/接口入口见文末 [Related](#-related--相关链接)。
  113. ---
  114. ## 👭 姊妹仓库 / Sister repo
  115. - **[ecommerce-image-skills](https://github.com/xianyu110/ecommerce-image-skills)** —— 12 个电商出图 Skill(白底主图、场景图、卖点图、A+、小红书封面、详情长图…)。**先出图,再用本仓库把图变成视频**:本仓库示例视频的素材就来自它。
  116. - **[gptimage2.asia](https://gptimage2.asia/?utm_source=github&utm_medium=readme&utm_campaign=ecommerce-video-skills)** —— 在线使用 GPT Image 2.5,无需 API Key,快速做出视频要用的商品图 / run GPT Image 2.5 online.
  117. ## 🤝 Contributing
  118. 详见 [CONTRIBUTING.md](CONTRIBUTING.md)。欢迎 PR:新的平台规格(附官方链接)、更好的钩子/分镜模板、更多脚本。请保持每个 skill 自包含(`skills/<name>/SKILL.md` + `scripts/`);修改 `scripts/` 后运行 `python tools/sync_scripts.py` 同步到各 skill。
  119. ## 📜 致谢与许可
  120. MIT © xianyu110。内容为原创编写;参考项目(MoneyPrinterTurbo · MIT、shuohao-skills · Apache-2.0、reelbench-skills · Apache-2.0、ffmpeg-skill · MIT 等)只借鉴了结构思路,未复制文本或代码,详见 [docs/credits.md](docs/credits.md)。edge-tts 为 LGPL-3.0 依赖;FFmpeg 由用户自行安装。平台规则经常变化,上传前请以各平台官方说明为准。
  121. ---
  122. ## 🇺🇸 English
  123. Thirteen installable Agent Skills that take an ecommerce product from **a few photos to a finished 9:16 short video** — hooks, storyboards, model-agnostic image-to-video prompts, free edge-tts voice-over, styled subtitles, **a working local ffmpeg render pipeline**, platform exports (TikTok Shop, Douyin, WeChat Channels, Xiaohongshu, Taobao, Amazon), live-stream clipping, unboxing/comparison templates, multilingual dubbing and cover/title A/B tests. Chinese-first, English included.
  124. ```bash
  125. npx skills add xianyu110/ecommerce-video-skills # or: /plugin marketplace add xianyu110/ecommerce-video-skills
  126. pip install -r requirements.txt # + ffmpeg with libass
  127. python scripts/assemble.py examples/aura-bottle/storyboard.json --lang en --voice en-US-AndrewNeural -o out/aura-en.mp4
  128. ```
  129. - **Viral remake**: paste a Douyin/TikTok link or transcript → 5-beat breakdown → map to your product → `storyboard.json` ready to render.
  130. - **Real pipeline, no API key**: storyboard.json → per-line edge-tts → Ken Burns shots → xfade → ASS captions & pop-up titles → ducked BGM → two-pass loudnorm (≈ -14 LUFS) → MP4 + SRT.
  131. - **Model-agnostic prompts**: one shot list adapted for any image-to-video model, with a product-identity lock and a local fallback for every shot. No invented prices or model limits.
  132. - **Localisation**: add `line_en` / `sub_en` / `title_en` fields and render with `--lang en`; voices listed for US/UK/SEA/JP/KR/LATAM.
  133. - Skills: `viral-remake` · `image-to-video-shots` · `hook-3s-script` · `selling-point-storyboard` · `multi-model-shot-prompts` · `ai-voiceover-edge-tts` · `subtitles-and-text-effects` · `ffmpeg-auto-assemble` · `platform-spec-export` · `live-stream-clips` · `unboxing-comparison-review` · `multilingual-dubbing` · `cover-title-ab` (see the table above).
  134. - No API key needed for the render. Third-party model/API options are listed under [Related](#-related--相关链接).
  135. - Need product images first? `https://gptimage2.asia/` runs GPT Image 2.5 in the browser.
  136. - Images first? See the sister repo **[ecommerce-image-skills](https://github.com/xianyu110/ecommerce-image-skills)**.
  137. ---
  138. ## 🔗 Related / 相关链接
  139. > 以下为第三方服务,**与本项目无隶属关系**;标注「推广链接」的为作者的邀请/返利链接。本仓库的脚本不依赖其中任何一个。<br>
  140. > Third-party services, not affiliated with this project. Links marked *referral* are the author's affiliate links. Nothing in this repo requires them.
  141. - [claude-opus.top](https://claude-opus.top/) — Claude 国内镜像站,可把 SKILL.md 粘进对话按步骤出脚本、分镜和提示词 / Claude mirror for mainland China.
  142. - [tryallapi.com](https://tryallapi.com/register?aff=5A6A)(推广链接 / *referral*)— 一站式 OpenAI 兼容 API(视频 / 图像 / 大模型);需要在脚本里调模型时可设 `OPENAI_BASE_URL=https://tryallapi.com/v1`(任何 OpenAI 兼容网关均可)。
  143. ## 🔗 友情链接 / Friends
  144. - [LINUX DO](https://linux.do) — 新的理想型社区 / A new ideal community
  145. ## ⭐ Star History
  146. [![Star History Chart](https://api.star-history.com/svg?repos=xianyu110/ecommerce-video-skills&type=Date)](https://star-history.com/#xianyu110/ecommerce-video-skills&Date)
  147. ---
  148. <div align="center">
  149. 我是 MaynorAI 团队,分享 AI 编程、AI SaaS 工具出海、一人团队搭建经验。
  150. </div>

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.