huashu-douyin-script

Douyin Viral Script Creation

The complete workflow from competitor video breakdown to script generation. Turn "imitating viral hits by feel" into "AI systematic breakdown + structured replication."

Environment Requirements

• uv(Python package manager)
• yt-dlp(Douyin video download, requires pip install yt-dlp or brew install yt-dlp）
• GEMINI_API_KEY environment variable (for Gemini video analysis, obtained from https://aistudio.google.com/apikey )
• GEMINI_BASE_URL environment variable (optional, custom API endpoint such as proxy/relay; if not set, the official endpoint is used)
• Chrome browser already logged in to Douyin (used to extract download cookies)

Path Convention: In the following text, SKILL_DIR refers to the absolute path of the directory where this SKILL.md is located. Before running the script, first use dirname or the Glob tool to determine the actual location of SKILL.md, and replace SKILL_DIR。

6-Step Workflow

Step 1: Collect Input

Collect the following information from the user:

Required：

• Douyin video links (1-5 benchmark/competitor videos)
• Product information (name, core selling points, target audience, price)
• Script type: seeding video or Qianchuan ad material

Optional：

• Product images (used as visual reference in the script)
• Target duration (default 30 seconds for seeding, default 15 seconds for Qianchuan)
• Brand tone requirements
• Campaign objective (livestream traffic/Product detail page/follow conversion)

If the user has only provided part of the information, proactively ask for the missing items.

---

Step 2: Download Videos

Run the download script:

uv run SKILL_DIR/scripts/download_douyin.py \
  --urls "URL1" "URL2" \
  --output-dir _temp/douyin-downloads

Parameter Description：

• --urls: Supports short links, page links, and share text (automatically extracts the URL)
• --output-dir: defaults to the current working directory _temp/douyin-downloads/
• --cookies-browser: defaults to chrome, options include edge/firefox

When Download Fails：

1. Prompt the user to confirm that Chrome is logged in to Douyin
2. Suggest manually downloading the video and placing it in _temp/douyin-downloads/
3. If douyin-mcp-server is available, try downloading via MCP

---

Step 3: Gemini Video Analysis (Can Be Parallelized)

For each successfully downloaded video, call Gemini video analysis:

uv run SKILL_DIR/scripts/analyze_video.py \
  --video "_temp/douyin-downloads/douyin-1-xxx.mp4" \
  --prompt "PROMPT_BELOW" \
  --model flash \
  --resolution medium \
  --output "_temp/douyin-downloads/analysis-1.md"

Use the flash model + medium resolution(sufficient for short videos, cost-saving).

Multiple videos can be analyzed in parallel(use run_in_background=true）。

Viral Analysis Prompt(pass in the --prompt parameter):

作为资深抖音电商视频分析师，请对这个视频进行7维度深度拆解。
特别注意：前3秒是最关键的部分，需要逐帧级别的详细拆解。

## 1. 钩子分析（前3秒）⭐ 最关键
前3秒 = 文案钩子 + 视觉钩子，两条线都要详细分析。

### 1a. 文案钩子
- 钩子类型（反常识/痛点/数据/场景/悬念/利益）
- 钩子文案完整转录
- 文案与产品的关联度（强关联/弱关联）

### 1b. 视觉钩子（逐帧描述）
- 第0秒画面：暂停在最开始，描述这一帧的构图、色调、主体
- 视觉钩子类型（视觉奇观/产品堆叠/画面突变/动作冲击/文字弹出/第一人称POV）
- 具体画面描述：景别、色调、运镜方式、特效、人物表情和动作
- 视觉信息密度：画面中同时出现了多少信息元素

### 1c. 文案×视觉配合
- 文案和画面是否同步强化同一个信息
- 声音设计：前3秒有无音效/BGM变化/人声语气变化
- 综合钩子强度评分（1-10）及理由

## 2. 分镜结构
用表格拆解每个镜头：
| 时间 | 景别 | 画面内容 | 旁白/字幕 | 转场方式 |

## 3. 节奏设计
- 快切片段时间点
- 节奏变化模式（快-慢-快/渐进加速/脉冲式）
- BGM与画面的配合度

## 4. 视觉元素
- 色调和滤镜风格
- 字幕样式和出现时机
- 产品展示方式
- 构图特点

## 5. 转化设计
- CTA类型和出现时机
- 价格锚定策略
- 紧迫感营造手段
- 转化路径（视频→?→?）

## 6. 合规检查
- 是否存在绝对化用语
- 功效表述是否合规
- 有无潜在审核风险

## 7. 可复制要素
- 可直接复制的：钩子句式、分镜结构、视觉风格、CTA话术
- 不可复制的：独特场景、特定达人、品牌势能

请用中文输出，尽量详细。

---

Step 4: Viral Formula Extraction ← User Confirmation Node

When there are competitor videos → Summarize the analysis results:

Read all analysis-*.md files, and also read references/proven-formulas.md for verified formulas as a reference, then have Claude summarize and extract:

1. Category Viral Commonalities: success factors shared by multiple videos
2. Hook Formula: the most effective hook types and sentence templates
3. Best Storyboard Structure: the standard storyboard flow suitable for this category
4. Rhythm Template: Recommended rhythm design plan
5. Conversion Path: Optimal CTA strategy
6. Risk Alert: Compliance issues to avoid

When there are no competitor videos → Directly use the validated formula:

Read references/proven-formulas.md, and select the closest category formula as the baseline according to the product category. Remind the user: a script without competitor analysis may lack category specificity, so it is recommended to supplement competitor videos later.

Save summaryto _temp/douyin-downloads/[产品名]-爆款分析汇总.md

Show to the user for confirmation：

• Confirm whether the analysis is accurate
• Confirm the script type (seeding/Qianchuan)
• Supplement product information (if Step 1 was not fully provided)

Formula Accumulation: After the analysis is completed, append the formula for the new category to references/proven-formulas.md, and keep accumulating.

---

Step 5: Script + Storyboard Generation

Generate the script based on the viral formula + product information + colloquial style samples.

Preparation Before Generation：

1. Read references/script-style-samples.md to obtain colloquial style examples
2. Read references/analysis-dimensions.md for the seeding/Qianchuan difference table
3. Read the viral analysis summary from Step 4

Script Generation Prompt Template：

Seeding Video Script

你是抖音电商短视频编导，擅长带货类种草内容。

## 任务
为以下产品生成一个{时长}秒的种草视频脚本。

## 产品信息
{产品名称、核心卖点、目标人群、价格、品牌信息}

## 爆款公式（基于竞品分析）
{Step 4提炼的爆款公式}

## 口语风格要求
参考以下真实脚本的风格特征：
- 极度口语化：用说话的方式写字，短句为主（不超过15字）
- 具体数据锚点：用具体数字，不用「很多」「大量」
- 感官描述：调动视觉/触觉/味觉/嗅觉
- 情感触发：身份认同、焦虑激活、场景共鸣
- 品牌背书简化：一句话带过
- 价格锚定+紧迫感

真实脚本范例：
{从script-style-samples.md选取同品类或风格接近的1-2个样本}

## 输出要求

### Part A：完整脚本
- 开头3秒必须有强钩子（参考分析中最有效的钩子类型）
- 中间展示核心卖点（最多3个，多了观众记不住）
- 结尾有明确CTA
- 全文口语化，像朋友推荐
- 不使用绝对化用语，符合抖音广告审核规范
- 标注每段预估时长

### Part B：分镜表格（前3秒必须详细描述视觉钩子）
| 镜号 | 时长 | 景别 | 画面内容 | 旁白/字幕 | 拍摄建议 |

⚠️ 前3秒的分镜必须包含：
- 视觉钩子类型（视觉奇观/产品堆叠/画面突变/动作冲击/文字弹出/第一人称POV）
- 具体画面描述：构图、色调、运镜、特效、表情动作
- 第一帧设计：暂停在第0秒时这一帧能否吸引点击
- 文案×画面配合：声音和画面是否同步强化同一个信息

Qianchuan Ad Material Script

你是千川投放素材编导，擅长高转化信息流广告。

## 任务
为以下产品写一条{时长}秒千川投放素材脚本。

## 产品信息
{产品名称、核心卖点、目标人群、价格、投放目标}

## 爆款公式（基于竞品分析）
{Step 4提炼的爆款公式}

## 口语风格要求
{同种草脚本的风格要求}

## 千川素材特殊要求
- 前3秒必须有强钩子（数据型或痛点型，不要用问句开头）
- 信息密集，卖点直给
- CTA要硬：明确引导点击/进直播间/下单
- 不使用绝对化用语，不做未经验证的功效承诺
- 符合千川审核规范

## 输出
### Part A：完整脚本（标注时长）
### Part B：分镜表格
| 镜号 | 时长 | 画面内容 | 旁白/字幕 | 素材建议 |

Save scriptto _temp/douyin-downloads/[产品名]-种草脚本.md or [产品名]-千川素材脚本.md

---

Step 6: AI-Tone Review ← User Confirmation Node

Perform a video script-specific review of the generated script, with 5 checks:

Check 1: Degree of Colloquialism

Refer to the rules of the 视频脚本口语化审校 skill:

• ❌ "Next, we will proceed to..." → ✅ "Let's..."
• ❌ "Perform the operation" → ✅ "Click"
• ❌ "In summary" → ✅ Summarize directly
• Mainly use short sentences (no more than 15 characters)
• Read it aloud once, and rewrite any places where you stumble

Check 2: Hook Strength

• Whether the first 3 seconds are attractive enough
• Whether it matches the target audience
• Whether it creates curiosity/urgency/resonance

Check 3: Rhythm and Duration

• Whether the duration annotation for each segment is reasonable
• Whether the total duration is within the target range
• Whether the information density is moderate (neither overloaded nor empty)

Check 4: Advertising Review Compliance Check (Key!)

This is the step most likely to cause materials to be rejected. Even if certain expressions appear in the product's official promotional copy, they may still be rejected by platform review during ad delivery.

4a. Absolute terms(must be deleted):

• ❌ Best/No. 1/100%/Absolute/Only/Top-tier/Lowest on the entire internet

4b. Time + Efficacy Promise(High risk! Most commonly blocked):

• ❌ "Relieves sensitivity in 60 seconds" → ✅ "After using it, your mouth feels much more comfortable"
• ❌ "Fades spots by 83% in 28 days" → ✅ "With consistent use, the spots really did fade"
• ❌ "Takes effect in 7 days" → ✅ "After using it for a while, you can see the change"
• Rule:Specific time + specific efficacy = must be rewritten. Remove the time or remove the efficacy promise, and replace it with a vague physical sensation description
• Even if the data comes from official product/clinical reports, it cannot be used directly in ad creative

4c. Efficacy claim wording：

• ❌ Cure/root out/permanent/completely solve → ✅ Relieve/help improve/feel much better
• ❌ Whitening/acne removal/anti-aging → ✅ Brighten/improve acne-prone skin/make skin condition better (pay special attention to cosmetics)
• ❌ Anti-inflammatory/sterilizing/antibacterial → ✅ Feel fresh and clean (non-drug products cannot use medical terminology)

4d. Comparison and disparagement：

• ❌ "Better than brand XX" "crushes all competitors"
• ❌ "The hospital costs thousands of dollars" → ⚠️ Can be used but must not imply replacing medical treatment

4e. Inducement and falsehood：

• ❌ "You'll lose out if you don't buy" "Miss it and wait another year" (false urgency)
• ❌ Unlabeled actors playing users/experts

Rewriting principles: Use first-person physical experience instead of third-person data. "After I used it, I felt..." is much safer than "Clinically proven...".

Check 5: AI-flavor check

Refer to ai-taste-proofreading the skill's 6 major AI-tone rules:

• ❌ Full of clichés: "In today's era" "It is worth noting that"
• ❌ AI sentence patterns: continuous use of "not... but..." "not only... but also..."
• ❌ Written vocabulary: "significantly improve" "fully utilize"
• ❌ Mechanical structure: overuse of "first, second, finally"
• ❌ Neutral attitude: "it depends on the actual situation"
• ❌ Lack of detail: many big words, few specific details

After reviewshow the revision list to the user for confirmation, then apply the revisions.

---

File saving rules

All intermediate products and final outputs are saved in 写作/_temp/douyin-downloads/：

_temp/douyin-downloads/
├── douyin-1-[ID].mp4             # 下载的视频
├── douyin-2-[ID].mp4
├── analysis-1.md                  # 视频分析结果
├── analysis-2.md
├── [产品名]-爆款分析汇总.md       # 多视频汇总
├── [产品名]-种草脚本.md           # 最终种草脚本
└── [产品名]-千川素材脚本.md       # 最终千川脚本

Reference resources

Resource	Path	Purpose
Analysis dimension framework	references/analysis-dimensions.md	7-dimension analysis + seeding vs Qianchuan
Verified hit formulas	references/proven-formulas.md	Category formula library, baseline when there are no competitor videos
Colloquial style samples	references/script-style-samples.md	Few-shot examples for script generation
Video download script	scripts/download_douyin.py	Douyin video download (yt-dlp)
Gemini video analysis	scripts/analyze_video.py	Video understanding and breakdown (built-in)
AI-flavor review rules	Embedded in Step 6	6 major AI-tone identifications
Colloquial review	Embedded in Step 6	Colloquial rewriting rules

Quick use

When there are competitor videos("Help me break down these Douyin videos and generate a script"):

1. Collect links and product information (Step 1)
2. Download + analysis can be executed in parallel (Step 2-3)
3. Show analysis summary, confirm direction (Step 4)
4. Generate script, review after confirmation (Step 5-6)
5. Append the new category formula to references/proven-formulas.md

When there are no competitor videos("Help me write a seeding script for XX product"):

1. Collect product information (Step 1, skip video links)
2. Skip Step 2-3
3. From references/proven-formulas.md select the category formula (Step 4)
4. Generate script, confirm and then proofread (Step 5-6)

Total time: about 15-20 minutes with video, about 5-10 minutes without video.

---

Produced by Huashu | AI Native Coder · Indie Developer WeChat Official Account "Huashu" | 300K+ followers | AI tools and productivity improvement Representative work: Kitten Fill Light (AppStore paid chart Top1) · "One Book to Master DeepSeek"