solo-video-promo

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

/video-promo

Generate a promo video plan from a project's PRD. Produces a 30-45 second video script with shot-by-shot storyboard. Detects Montage-tool or Remotion in the project and outputs compatible config when found.

根据项目的PRD生成促销视频方案。产出包含逐镜分镜故事板的30-45秒视频脚本。若检测到项目中使用Montage-tool或Remotion，将输出兼容的配置。

MCP Tools (use if available)

MCP工具（如有可用请使用）

```
project_code_search(query, project)
```
— find UI components, screens, features to showcase
```
project_info(name)
```
— get project stack and details
```
kb_search(query)
```
— find video production methodology

If MCP tools are not available, fall back to Glob + Grep + Read.

```
project_code_search(query, project)
```
— 查找可用于展示的UI组件、界面、功能
```
project_info(name)
```
— 获取项目技术栈及详细信息
```
kb_search(query)
```
— 查找视频制作方法论

若MCP工具不可用，则退而使用Glob + Grep + Read。

Steps

步骤

Parse project from
```
$ARGUMENTS
```
.
- Read PRD (
```
docs/prd.md
```
  ), README, or CLAUDE.md for product info.
- If empty: ask via AskUserQuestion.
Detect video tooling in the project:
- Check
```
package.json
```
  for
```
remotion
```
  ,
```
@remotion/cli
```
  → Remotion project
- Check for
```
montage.config.*
```
  ,
```
pnpm montage
```
  → Montage-tool project
- Check for
```
ffmpeg
```
  usage in scripts → FFmpeg pipeline
- If none found: output plain storyboard (no specific tooling config)
Extract key screens/features to showcase:
- If MCP available:
```
project_code_search("main screen OR hero OR dashboard", project)
```
  — find showcase-worthy UI
- Otherwise: Glob for screenshots, mockups, or UI component files
- Read PRD for top 3-5 features to demonstrate
Forced reasoning — video strategy: Before scripting, write out:
- Goal: What should the viewer DO after watching? (download, sign up, visit)
- Hook type: Question? Surprising stat? Pain point? Bold claim?
- Demo moments: 3 key product moments to show on screen
- Emotion arc: Frustration → Discovery → Relief/Delight

Generate video script (30-45 seconds):

markdown

## Video Script: {Project Name}

**Duration:** 30-45 seconds
**Format:** Vertical (9:16) for Reels/TikTok/Shorts
**Style:** Screen recording + text overlays

### HOOK (0:00-0:03) — 3 seconds
**Audio:** "{hook line — question or bold statement}"
**Visual:** {what appears on screen — text overlay on gradient/blurred BG}

### PROBLEM (0:03-0:10) — 7 seconds
**Audio:** "{describe the pain in user's words}"
**Visual:** {show the frustrating current state — competitor UX, manual process, etc.}

### DEMO (0:10-0:25) — 15 seconds
**Audio:** "{narrate what the product does}"
**Visual:**
- Shot 1 (5s): {first feature demo — screen recording}
- Shot 2 (5s): {second feature demo}
- Shot 3 (5s): {wow moment — the key differentiator}

### CTA (0:25-0:30) — 5 seconds
**Audio:** "{call to action}"
**Visual:** {product logo + URL + download badge}

Generate tooling config (if applicable):

If Remotion detected:

markdown

## Remotion Component Spec

Component: `PromoVideo.tsx`
Duration: 900 frames (30fps × 30s)

Sequences:
- HookSequence (0-90): Text animation on gradient
- ProblemSequence (90-300): Screen recording import
- DemoSequence (300-750): 3 feature recordings with transitions
- CTASequence (750-900): Logo + URL fade in

Assets needed:
- screen-recording-problem.mp4
- screen-recording-feature-1.mp4
- screen-recording-feature-2.mp4
- screen-recording-feature-3.mp4
- logo.png
- background-music.mp3

If montage tool detected:

markdown

## Montage Config

Clips:
- problem-clip.mp4 (7s)
- demo-feature-1.mp4 (5s)
- demo-feature-2.mp4 (5s)
- demo-wow-moment.mp4 (5s)

Music: {suggest genre/BPM for beat-sync}
Transitions: crossfade (0.5s)
Text overlays: hook, CTA

Write plan to

docs/video-promo.md

markdown

# Video Promo Plan: {Project Name}

**Generated:** {YYYY-MM-DD}
**Duration:** 30-45 seconds
**Format:** Vertical 9:16
**Tooling:** {Remotion / Montage-tool / Manual}

## Script
{full script from step 5}

## Assets Checklist
- [ ] Screen recording: {feature 1}
- [ ] Screen recording: {feature 2}
- [ ] Screen recording: {wow moment}
- [ ] Logo (transparent PNG)
- [ ] Background music (royalty-free, upbeat)

## Tooling Config
{config from step 6, or "Record manually and edit in CapCut/iMovie"}

---
*Generated by /video-promo. Record assets, then render.*

Output summary — script overview, assets needed, suggested next steps.

解析项目：从
```
$ARGUMENTS
```
中解析项目信息。
- 读取PRD（
```
docs/prd.md
```
  ）、README或CLAUDE.md以获取产品信息。
- 若上述文件为空：通过AskUserQuestion询问用户。
检测项目中的视频工具：
- 检查
```
package.json
```
  中是否有
```
remotion
```
  、
```
@remotion/cli
```
  → 判定为Remotion项目
- 检查是否存在
```
montage.config.*
```
  、
```
pnpm montage
```
  → 判定为Montage-tool项目
- 检查脚本中是否使用
```
ffmpeg
```
  → 判定为FFmpeg工作流
- 若未检测到任何工具：输出纯文本故事板（无特定工具配置）
提取需展示的关键界面/功能：
- 若MCP可用：调用
```
project_code_search("main screen OR hero OR dashboard", project)
```
  — 查找适合展示的UI
- 若不可用：通过Glob查找截图、线框图或UI组件文件
- 读取PRD，提取3-5个需演示的核心功能
强制推理 — 视频策略：在编写脚本前，需明确：
- 目标：观看者看完视频后应采取什么行动？（下载、注册、访问）
- 钩子类型：问题？惊人数据？痛点？大胆宣言？
- 演示时刻：3个需在屏幕上展示的核心产品时刻
- 情感弧线：挫败感 → 发现 → 释然/愉悦

生成视频脚本（30-45秒）：

markdown

## 视频脚本：{项目名称}

**时长：**30-45秒
**格式：**竖屏（9:16），适配Reels/TikTok/Shorts
**风格：**屏幕录制 + 文字叠加

### 钩子（0:00-0:03）— 3秒
**音频：**"{钩子台词 — 问题或大胆陈述}"
**视觉：**{屏幕显示内容 — 渐变/模糊背景上的文字叠加}

### 痛点（0:03-0:10）— 7秒
**音频：**"{用用户的语言描述痛点}"
**视觉：**{展示令人沮丧的当前状态 — 竞品UX、手动流程等}

### 演示（0:10-0:25）— 15秒
**音频：**"{旁白介绍产品功能}"
**视觉：**
- 镜头1（5秒）：{首个功能演示 — 屏幕录制}
- 镜头2（5秒）：{第二个功能演示}
- 镜头3（5秒）：{惊喜时刻 — 核心差异化优势}

### 行动号召（0:25-0:30）— 5秒
**音频：**"{行动号召语}"
**视觉：**{产品Logo + 网址 + 下载徽章}

生成工具配置（如适用）：

若检测到Remotion：

markdown

## Remotion组件规格

组件：`PromoVideo.tsx`
时长：900帧（30fps × 30秒）

序列：
- HookSequence（0-90帧）：渐变背景上的文字动画
- ProblemSequence（90-300帧）：导入屏幕录制内容
- DemoSequence（300-750帧）：3个功能录制片段，带转场效果
- CTASequence（750-900帧）：Logo + 网址淡入

所需资源：
- screen-recording-problem.mp4
- screen-recording-feature-1.mp4
- screen-recording-feature-2.mp4
- screen-recording-feature-3.mp4
- logo.png
- background-music.mp3

若检测到Montage-tool：

markdown

## Montage配置

片段：
- problem-clip.mp4（7秒）
- demo-feature-1.mp4（5秒）
- demo-feature-2.mp4（5秒）
- demo-wow-moment.mp4（5秒）

音乐：{建议适合节拍同步的流派/BPM}
转场：淡入淡出（0.5秒）
文字叠加：钩子、行动号召

将方案写入
docs/video-promo.md
：

markdown

# 促销视频方案：{项目名称}

**生成日期：**{YYYY-MM-DD}
**时长：**30-45秒
**格式：**竖屏9:16
**工具：**{Remotion / Montage-tool / 手动制作}

## 脚本
{步骤5中的完整脚本}

## 资源清单
- [ ] 屏幕录制：{功能1}
- [ ] 屏幕录制：{功能2}
- [ ] 屏幕录制：{惊喜时刻}
- [ ] Logo（透明PNG格式）
- [ ] 背景音乐（无版权、节奏明快）

## 工具配置
{步骤6中的配置，或“手动录制并在CapCut/iMovie中编辑”}

---
*由/video-promo生成。请录制资源后进行渲染。*

输出摘要 — 脚本概述、所需资源、建议后续步骤。

Notes

注意事项

Script assumes screen recording as primary footage — no actor needed
For iOS apps: use Simulator recording or device mirroring
For web: use browser screen recording
Music: suggest royalty-free sources (Artlist, Epidemic Sound, YouTube Audio Library)
This skill generates the PLAN — actual video rendering is manual or via Montage-tool/Remotion

脚本默认以屏幕录制为主要素材 — 无需演员
针对iOS应用：使用模拟器录制或设备投屏
针对网页：使用浏览器屏幕录制功能
音乐：建议使用无版权资源（Artlist、Epidemic Sound、YouTube音频库）
本工具仅生成方案 — 实际视频渲染需手动操作或通过Montage-tool/Remotion完成

Common Issues

常见问题

No video tooling detected

未检测到视频工具

Cause: Project doesn't use Remotion or Montage-tool. Fix: Skill outputs plain storyboard by default. Record manually and edit in CapCut/iMovie, or add Remotion to the project.

**原因：**项目未使用Remotion或Montage-tool。 **解决方法：**工具默认输出纯文本故事板。可手动录制并在CapCut/iMovie中编辑，或向项目中添加Remotion。

Script too long for short-form video

脚本过长，不适用于短视频

Cause: Too many features to showcase. Fix: Pick TOP 3 features only. 30-45 seconds = ~75-100 words of narration. Less is more.

**原因：**需展示的功能过多。 **解决方法：**仅挑选TOP 3功能。30-45秒对应约75-100字旁白。少即是多。

No screenshots or UI to record

无截图或可录制的UI

Cause: Product not built yet or no visual interface. Fix: Use mockups, wireframes, or describe intended visuals in the storyboard. Record after MVP is built.

**原因：**产品尚未开发完成或无可视化界面。 **解决方法：**使用线框图、原型图，或在故事板中描述预期视觉效果。待MVP完成后再进行录制。