@renoise/video-maker 0.1.3 → 0.2.0

package/skills/tiktok-content-maker/examples/dress-demo.md

@@ -1,48 +1,48 @@
-# 完整示例：Keep 弹力阻力带 15 秒带货视频
+# Full Example: Keep Resistance Loop Bands — 15s E-commerce Video
 
-## 输入
+## Input
 
-- 商品图：Keep 品牌弹力阻力带，3 条装（粉/蓝/绿），马卡龙配色
-- 模特参考：运动风女性，金发马尾，运动内衣+紧身短裤（仅供分析，不上传 Renoise）
+- Product image: Keep brand resistance loop bands, 3-pack (pink/blue/green), pastel macaron colors
+- Model reference: Athletic female, blonde ponytail, sports bra + fitted shorts (for analysis only, NOT uploaded to Renoise)
 
-## 商品分析结果
+## Product Analysis Result
 
 ```json
 {
   "product": {
-    "type": "弹力阻力带 / resistance loop bands",
-    "color": "粉色 10lb, 蓝色 15lb, 薄荷绿 20lb",
-    "material": "TPE 弹性材质，哑光质感，柔软亲肤",
-    "highlights": "三条不同阻力渐进训练，可折叠便携，马卡龙高颜值配色",
-    "brand_tone": "年轻运动，时尚健身"
+    "type": "Resistance loop bands",
+    "color": "Pink 10lb, Blue 15lb, Mint green 20lb",
+    "material": "TPE elastic, matte finish, soft and skin-friendly",
+    "highlights": "Three bands with progressive resistance for training, foldable and portable, pastel macaron color scheme",
+    "brand_tone": "Youthful athletic, trendy fitness"
   },
   "model": {
     "gender": "female",
     "age_range": "25-30",
-    "hair": "金发高马尾",
-    "outfit": "黑色运动内衣 + 黑色紧身短裤",
-    "vibe": "自信、活力、专业健身感"
+    "hair": "Blonde high ponytail",
+    "outfit": "Black sports bra + black fitted shorts",
+    "vibe": "Confident, energetic, professional fitness feel"
   },
   "scene_suggestions": [
-    "明亮现代客厅晨练",
-    "酒店房间旅行健身",
-    "卧室睡前拉伸"
+    "Bright modern living room morning workout",
+    "Hotel room travel fitness",
+    "Bedroom bedtime stretching"
   ],
   "selling_points": [
-    "三条不同阻力，渐进式训练，适合入门到进阶",
-    "小巧便携，可折叠放包里随时随地练",
-    "马卡龙色系高颜值，不卷边"
+    "Three resistance levels for progressive training, suitable for beginners to advanced",
+    "Compact and portable, folds to fit in a bag for anytime/anywhere workouts",
+    "Pastel macaron color scheme, won't roll up during use"
   ]
 }
 ```
 
-## 生成脚本
+## Generated Script
 
-### 1. Video Prompt（英文，含台词）
+### 1. Video Prompt (English, with dialogue)
 
 > The product is a set of three Keep brand elastic resistance loop bands — flat, wide, smooth matte TPE material with a soft rubbery texture, each band approximately 5cm wide and forming a closed loop. Colors: pastel pink (lightest resistance), sky blue (medium), mint green (heaviest). Each band has a small white "Keep" logo printed on the surface. The bands must match the reference image exactly in color, width, shape, material finish, and logo placement throughout every frame of the video. A fit young woman in her mid-twenties with blonde hair in a high ponytail, light tan skin, athletic build, wearing a black sports bra and black fitted shorts, holds the three pastel-colored Keep resistance bands fanned out in her hand — camera starts extreme close-up on the bands showing their flat wide shape and matte surface then whip pans up to her face as she says "Stop scrolling — I threw out all my gym equipment for these three bands." Morning sunlight from a large window catches the smooth TPE finish. Camera does a fast snap dolly in on her hands as she stretches the blue band taut, the flat wide band maintaining its shape and thickness as it stretches, she says "Ten, fifteen, twenty pounds — I started pink, now I am on green, and they never roll up on you." She has the mint green band already looped around both ankles, camera pulls back to medium shot as she performs side leg raises, the wide flat band visible around her ankles keeping its shape, she says "I do legs in my living room, arms on work trips — they fold smaller than my phone" while transitioning into a squat pulse with the pink band above her knees. Without stopping she grabs all three bands, folds them into a tiny square and tucks them into a small gym bag pocket, camera pushes in tight, then she looks straight into the camera with a knowing grin and says "Honestly the best forty bucks I have spent this year," the pastel colors pop against her black outfit, warm golden backlight creates a soft halo, frame holds steady.
 
-### 2. 台词脚本（英文）
+### 2. Dialogue Script (English)
 
 ```
 [0-3s]   "Stop scrolling — I threw out all my gym equipment for these three bands."
@@ -51,36 +51,36 @@
 [12-15s] "Honestly the best forty bucks I've spent this year."
 ```
 
-### 3. BGM/音效建议
+### 3. BGM / Sound Design Suggestions
 
-- **BGM**：高能量 trap-pop beat，BPM 125-135，bass drop 配合 0s hook
-- **音效**：
-  - [0s] 弹力带 snap 回弹声 — 配合开场冲击
-  - [3s] 快速 whoosh 转场音
-  - [8s] 运动节奏鼓点加重
-  - [12s] bass swell + 定格 hit
+- **BGM**: High-energy trap-pop beat, BPM 125-135, bass drop synced with the 0s hook
+- **Sound effects**:
+  - [0s] Band snap/recoil sound — paired with opening impact
+  - [3s] Fast whoosh transition
+  - [8s] Workout rhythm drum accent
+  - [12s] Bass swell + freeze-frame hit
 
-## Renoise 提交
+## Renoise Submission
 
 ```bash
-# 1. 上传商品图（只传商品图，不传模特图）
-node renoise-cli.mjs material upload <商品图路径>
-# → 返回 material id，例如 194
+# 1. Upload product image (product image only, NOT the model image)
+node renoise-cli.mjs material upload <product-image-path>
+# → returns material id, e.g. 194
 
-# 2. 提交任务（带商品图 material，一步到位）
+# 2. Submit task (with product image material, all-in-one)
 node renoise-cli.mjs task generate \
-  --prompt "<上面的 Video Prompt>" \
+  --prompt "<Video Prompt above>" \
   --model renoise-2.0 --duration 15 --ratio 9:16 \
   --tags ecom,keep,resistance-band \
   --materials "194:image1"
 ```
 
-## 多场景批量生成
+## Multi-Scene Batch Generation
 
-同一商品可复用 material ID，换不同场景生成多个视频：
+Reuse the same material ID for the same product, swap scenes to generate multiple videos:
 
-| 场景 | Hook 台词 | 场景关键词 |
-|------|----------|-----------|
-| 户外公园晨练 | "This tiny thing replaced my entire gym bag." | sunlit park lawn, golden hour, dewy grass |
-| 酒店旅行健身 | "Business trip day three and I still have not skipped a workout." | hotel room, city skyline, suitcase |
-| 卧室睡前拉伸 | "My nighttime routine that actually changed my body." | cozy bedroom, string lights, yoga mat |
+| Scene | Hook Dialogue | Scene Keywords |
+|-------|--------------|----------------|
+| Outdoor park morning workout | "This tiny thing replaced my entire gym bag." | sunlit park lawn, golden hour, dewy grass |
+| Hotel room travel fitness | "Business trip day three and I still have not skipped a workout." | hotel room, city skyline, suitcase |
+| Bedroom bedtime stretching | "My nighttime routine that actually changed my body." | cozy bedroom, string lights, yoga mat |

package/skills/tiktok-content-maker/references/ecom-prompt-guide.md

@@ -1,223 +1,228 @@
-# 电商短视频 Prompt 指南
+# E-commerce Short Video Prompt Guide
 
-## 15 秒电商视频 Prompt 模板
+## 15-Second E-commerce Video Prompt Template
 
-### 核心结构：一个连续 15 秒叙事段落
+### Core Structure: One Continuous 15-Second Narrative
 
-不同于 Apple Don't Blink 快速切镜风格，电商带货视频是**一个连续镜头**，通过运镜变化展示产品和模特。
+Unlike Apple's "Don't Blink" rapid-cut style, e-commerce product videos are **one continuous shot** that uses camera movement changes to showcase the product and model.
 
-**写作顺序**: 时间线叙事 + Ad-6D 元素穿插
+**Writing order**: Timeline narrative + Ad-6D elements interspersed
 
 ```
-[开场 0-3s] ⚡ HOOK — 产品必须在第 1 秒出现 + 快速运镜 + 立即开口说话。绝对不能铺垫。
-[展示 3-8s] 产品特写 + 材质细节 + 模特互动
-[场景 8-12s] 生活场景 + 使用效果 + 氛围
-[收尾 12-15s] 模特面对镜头 + 产品定格 + 自然收尾
+[Opening 0-3s] HOOK — Product MUST appear in Frame 1 + fast camera movement + start speaking immediately. Never build up slowly.
+[Showcase 3-8s] Product close-up + material details + model interaction
+[Scene 8-12s] Lifestyle scenario + usage effect + atmosphere
+[Close 12-15s] Model faces camera + product freeze frame + natural ending
 ```
 
-### 产品锚定（Prompt 开头，一句话）
+### Product Anchoring (Start of Prompt, One Sentence)
 
-产品外观靠参考图传达，prompt 里只需**一句话**说明产品是什么 + 用途：
+Product appearance is conveyed by the reference image. The prompt only needs **one sentence** stating what the product is + its use case:
 
 ```
 The product is a [brand] [product type] for [primary use case], shown in the reference image.
 The product must match the reference image exactly in every frame. Do not invent any packaging, box, or container unless the reference image shows one.
 ```
 
-**示例**：
+**Examples**:
 - `The product is a K brand lightweight gym tote bag for fitness and daily commute, shown in the reference image.`
 - `The product is a Keep peanut-shaped massage ball for back and muscle recovery, shown in the reference image.`
 
-**关键**：不要在 prompt 里重复描述产品的颜色、材质、形状、logo — 这些信息已经在参考图里了。把 prompt 空间留给 hook 和画面叙事。
+**Key**: Do not repeat product color, material, shape, or logo descriptions in the prompt — that information is already in the reference image. Save prompt space for the hook and visual narrative.
 
-### 模特一致性描述
+### Model Consistency Description
 
-紧接产品锚定段之后，锚定模特外观：
+Immediately after the product anchoring, anchor the model's appearance:
 
 ```
 A [age_range]-year-old [gender] with [hair description], [skin tone], [body type], wearing [outfit description]...
 ```
 
-**注意**：模特完全靠文字描述，不上传真人参考图（隐私检测会拦截含真人面孔的图片）。
-
-## 品类专用关键词
-
-### 服装（Clothing）
-- **面料**: flowing silk, crisp cotton, soft cashmere, stretchy knit, lightweight chiffon, structured tweed
-- **动态**: fabric sways gently, hem flutters in breeze, pleats catch light, drape follows body movement
-- **展示**: twirls to show full skirt volume, adjusts collar detail, runs fingers along seam
-- **场景**: sunlit café terrace, cherry blossom garden path, minimalist white studio, golden hour rooftop
-
-### 3C 数码（Electronics）
-- **材质**: anodized aluminum, gorilla glass surface, matte finish, chamfered edges catch light
-- **动态**: screen illuminates face, finger glides across display, device rotates to reveal thin profile
-- **展示**: holds up to camera showing screen, taps interface with precision, places on wireless charger
-- **场景**: modern desk setup, coffee shop workspace, commuter holding device, bedside nightstand
-
-### 美妆（Beauty）
-- **质感**: dewy finish, velvety matte, glossy sheen, shimmering particles, creamy texture
-- **动态**: applies with brush stroke, blends with fingertip, lips press together, eyelids flutter
-- **展示**: close-up of application, before-after glow, product swatch on skin, mirror reflection
-- **场景**: vanity mirror with ring light, bathroom morning routine, getting ready for night out
-
-### 食品（Food）
-- **质感**: steam rises, sauce glistens, crispy golden crust, juice drips, cheese stretches
-- **动态**: pours into bowl, breaks apart to reveal filling, scoops with spoon, bites with satisfaction
-- **展示**: overhead flat lay, cross-section reveal, slow-motion pour, garnish placement
-- **场景**: rustic kitchen counter, outdoor picnic, cozy dining table, street food stall
-
-### 家居（Home）
-- **材质**: warm wood grain, soft linen texture, smooth ceramic, brushed brass hardware
-- **动态**: hand caresses surface, opens drawer smoothly, arranges on shelf, light shifts across surface
-- **展示**: styled vignette, before-after room transformation, detail close-up, scale with hand
-- **场景**: morning light through curtains, minimalist living room, cozy bedroom corner, modern kitchen
-
-## 模特与产品互动动作词汇表
-
-### 通用动作
-- **展示**: holds up to camera, presents with both hands, turns to show different angle
-- **触摸**: runs fingers along, gently touches, traces the outline of
-- **穿戴**: puts on, adjusts, styles with
-- **使用**: opens, activates, applies
-- **情感**: smiles confidently, looks surprised, nods approvingly, expresses delight
-
-### 服装专用
+**Note**: Models are described entirely through text — never upload real person reference images (privacy detection will block images containing realistic human faces).
+
+## Category-Specific Keywords
+
+### Clothing
+
+- **Fabric**: flowing silk, crisp cotton, soft cashmere, stretchy knit, lightweight chiffon, structured tweed
+- **Motion**: fabric sways gently, hem flutters in breeze, pleats catch light, drape follows body movement
+- **Showcase**: twirls to show full skirt volume, adjusts collar detail, runs fingers along seam
+- **Scene**: sunlit café terrace, cherry blossom garden path, minimalist white studio, golden hour rooftop
+
+### Electronics
+
+- **Material**: anodized aluminum, gorilla glass surface, matte finish, chamfered edges catch light
+- **Motion**: screen illuminates face, finger glides across display, device rotates to reveal thin profile
+- **Showcase**: holds up to camera showing screen, taps interface with precision, places on wireless charger
+- **Scene**: modern desk setup, coffee shop workspace, commuter holding device, bedside nightstand
+
+### Beauty
+
+- **Texture**: dewy finish, velvety matte, glossy sheen, shimmering particles, creamy texture
+- **Motion**: applies with brush stroke, blends with fingertip, lips press together, eyelids flutter
+- **Showcase**: close-up of application, before-after glow, product swatch on skin, mirror reflection
+- **Scene**: vanity mirror with ring light, bathroom morning routine, getting ready for night out
+
+### Food
+
+- **Texture**: steam rises, sauce glistens, crispy golden crust, juice drips, cheese stretches
+- **Motion**: pours into bowl, breaks apart to reveal filling, scoops with spoon, bites with satisfaction
+- **Showcase**: overhead flat lay, cross-section reveal, slow-motion pour, garnish placement
+- **Scene**: rustic kitchen counter, outdoor picnic, cozy dining table, street food stall
+
+### Home
+
+- **Material**: warm wood grain, soft linen texture, smooth ceramic, brushed brass hardware
+- **Motion**: hand caresses surface, opens drawer smoothly, arranges on shelf, light shifts across surface
+- **Showcase**: styled vignette, before-after room transformation, detail close-up, scale with hand
+- **Scene**: morning light through curtains, minimalist living room, cozy bedroom corner, modern kitchen
+
+## Model-Product Interaction Vocabulary
+
+### General Actions
+- **Showcase**: holds up to camera, presents with both hands, turns to show different angle
+- **Touch**: runs fingers along, gently touches, traces the outline of
+- **Wear/Use**: puts on, adjusts, styles with
+- **Activate**: opens, activates, applies
+- **Emotion**: smiles confidently, looks surprised, nods approvingly, expresses delight
+
+### Clothing-Specific
 - twirls gracefully, walks toward camera, poses with hand on hip, flips hair to show neckline, adjusts sleeve cuff, smooths fabric over hip, turns to reveal back detail
 
-### 3C 专用
+### Electronics-Specific
 - unboxes with anticipation, swipes through interface, holds up comparing to face size, places in pocket to show portability, tilts to catch light on screen
 
-### 美妆专用
+### Beauty-Specific
 - applies with practiced motion, checks reflection, touches cheek feeling texture, pouts showing lip color, blinks showing eye makeup
 
-## 台词写作规范
+## Dialogue Writing Guidelines
 
-**核心原则**：台词必须是英文，嵌入视频 prompt 中。不单独输出字幕。
+**Core principle**: Dialogue must be in English, embedded within the video prompt. Do not output subtitles separately.
 
-**嵌入格式**（强制口型同步）：
+**Embedding format** (forced lip-sync):
 ```
 Spoken dialogue (say EXACTLY, word-for-word): "..."
 Mouth clearly visible when speaking, lip-sync aligned.
 ```
-使用 `Spoken dialogue (say EXACTLY, word-for-word):` 而不是简单的 `says "..."`，可以显著提升口型同步精度。每句台词后跟 `Mouth clearly visible when speaking, lip-sync aligned.` 确保嘴部可见。
+Using `Spoken dialogue (say EXACTLY, word-for-word):` instead of simply `says "..."` significantly improves lip-sync accuracy. Follow each dialogue line with `Mouth clearly visible when speaking, lip-sync aligned.` to ensure the mouth is visible.
 
-**风格**：闺蜜聊天感 — 像在跟朋友推荐，不像在念广告词。每句话都带具体信息（数字、对比、使用场景），没有废话。
+**Style**: Best-friend casual tone — like recommending to a friend, not reading ad copy. Every sentence carries specific information (numbers, comparisons, usage scenarios) — no filler.
 
-### Hook 台词（0-3s）— 第一句话喊停用户
+### Hook Dialogue (0-3s) — First Line to Stop the Scroll
 
-**颠覆型**（最有效）:
+**Subversive** (most effective):
 - "Stop scrolling — I threw out all my gym equipment for these three bands."
 - "This tiny thing replaced my entire gym bag."
 - "Business trip day three and I still have not skipped a workout."
 
-**个人经历型**:
+**Personal experience**:
 - "My nighttime routine that actually changed my body."
 - "The one thing I have been recommending to literally everyone."
 
-**关键**：开口必须快，配合快速运镜（whip pan / snap dolly in），不能慢热。
+**Key**: Start speaking fast, paired with fast camera movement (whip pan / snap dolly in). Never start slow.
 
-### 卖点台词（3-8s）— 具体参数 + 使用体验
+### Selling Point Dialogue (3-8s) — Specific Specs + Personal Experience
 
 - "Ten, fifteen, twenty pounds — I started pink, now I am on green, and they never roll up on you."
 - "Three resistance levels, folds flat, weighs literally nothing — this is my entire travel gym."
-- 必须包含：具体数字 + 个人使用感受 + 差异化优势
+- Must include: specific numbers + personal usage experience + differentiating advantage
 
-### 场景台词（8-12s）— 在哪用 + 便携/多功能
+### Scene Dialogue (8-12s) — Where to Use + Portability / Versatility
 
 - "I do legs in my living room, arms on work trips — they fold smaller than my phone."
 - "Park, backyard, hotel balcony — I have zero excuses now."
-- 必须包含：至少 2 个使用场景 + 便携性/多功能性
+- Must include: at least 2 usage scenarios + portability/versatility
 
-### 收尾台词（12-15s）— 自然个人推荐，不硬推销
+### Closing Dialogue (12-15s) — Natural Personal Recommendation, No Hard Sell
 
-**好的收尾**（推荐）:
+**Good closings** (recommended):
 - "Honestly the best forty bucks I have spent this year."
 - "Trust me just start — future you will be so grateful."
 - "Best thing I ever packed."
 - "You are welcome."
 
-**避免的收尾**（太生硬）:
+**Avoid these closings** (too pushy):
 - ~~"Link below — grab yours before they sell out."~~
 - ~~"Click the link for a special discount."~~
-- ~~"库存不多了，想要的赶紧！"~~
+- ~~"Limited stock, hurry up!"~~
 
-## Hook 策略（前 3 秒生死线）
+## Hook Strategy (The First 3 Seconds)
 
-**数据**：63% 高 CTR 的 TikTok 视频在前 3 秒就抓住用户。用户做出"看 or 划走"决策只需 **1.7 秒**。3 秒留存率 65%+ 的视频获得 **4-7 倍**曝光。
+**Data**: 63% of high-CTR TikTok videos capture users in the first 3 seconds. Users make the "watch or swipe" decision in just **1.7 seconds**. Videos with 65%+ 3-second retention rate get **4-7x** more impressions.
 
-### 视觉 Hook 技巧（选一个用于 prompt 开头）
+### Visual Hook Techniques (pick one for prompt opening)
 
-| 技巧 | Prompt 写法 | 效果 |
-|------|-------------|------|
-| **极速 zoom-in** | `Camera snaps in extreme close-up on the [product]` | 产品第 1 帧出现，冲击力最强 |
-| **产品滑入画面** | `The [product] slides into frame from the right` | 突然出现，制造微悬念 |
-| **手持举起** | `A hand thrusts the [product] toward the camera` | 直接、UGC 感强 |
-| **特写→全景反转** | `Extreme macro on [texture detail], camera rapidly pulls back to reveal...` | 先抓细节好奇，再揭示全貌 |
-| **Whip pan 甩入** | `Camera whip-pans with motion blur and lands on the [product]` | 节奏感强，视觉冲击 |
+| Technique | Prompt Phrasing | Effect |
+|-----------|----------------|--------|
+| **Snap zoom-in** | `Camera snaps in extreme close-up on the [product]` | Product in Frame 1, maximum impact |
+| **Product slides in** | `The [product] slides into frame from the right` | Sudden appearance creates micro-suspense |
+| **Hand thrust** | `A hand thrusts the [product] toward the camera` | Direct, strong UGC feel |
+| **Close-up → wide reveal** | `Extreme macro on [texture detail], camera rapidly pulls back to reveal...` | Hook curiosity with detail, then reveal full picture |
+| **Whip pan in** | `Camera whip-pans with motion blur and lands on the [product]` | Strong rhythm, visual impact |
 
-### Hook 核心规则
+### Hook Core Rules
 
-1. **产品必须在第 1 秒出现** — 不能先拍人走路、开门、铺环境
-2. **第 1 秒必须有运动** — 静止开场 = 被划走
-3. **模特必须在前 2 秒开口说话** — 声音比画面更能留人
-4. **Hook 台词要像在喊停朋友** — 不是念广告词
+1. **Product MUST appear in Frame 1** — never start with someone walking, opening a door, or establishing the environment
+2. **Frame 1 MUST have motion** — static opening = instant swipe
+3. **Model MUST start speaking within the first 2 seconds** — audio retains more than visuals
+4. **Hook dialogue should feel like stopping a friend** — not reading ad copy
 
-### Hook 台词公式（按效果排序）
+### Hook Dialogue Formulas (ranked by effectiveness)
 
-1. **结果前置**: "This $30 bag replaced my gym bag AND my purse." — 直接展示结果
-2. **颠覆型**: "Stop carrying two bags to the gym — you only need this one." — 挑战现有习惯
-3. **社交证明**: "200K people bought this last month and I finally get why." — FOMO
-4. **痛点提问**: "Why is your gym bag always so heavy?" — 直击痛点
-5. **个人故事**: "I was that person with three bags until I found this." — 共鸣
+1. **Result-first**: "This $30 bag replaced my gym bag AND my purse." — Show the result directly
+2. **Subversive**: "Stop carrying two bags to the gym — you only need this one." — Challenge existing habits
+3. **Social proof**: "200K people bought this last month and I finally get why." — FOMO
+4. **Pain point question**: "Why is your gym bag always so heavy?" — Hit the pain point directly
+5. **Personal story**: "I was that person with three bags until I found this." — Relatability
 
-## 运镜节奏建议（15 秒连续镜头）
+## Camera Movement Pacing (15s Continuous Shot)
 
 ```
-[0-3s]  HOOK — 产品第 1 帧出现！极速运镜 + 立即开口
-        推荐：extreme close-up snap in / whip pan / product slides into frame
-        禁止：camera slowly pushes in, 人物走路铺垫, 空镜头开场
-        节奏：1-2 秒内完成第一个运镜变化
+[0-3s]  HOOK — Product in Frame 1! Fast camera movement + start speaking immediately
+        Recommended: extreme close-up snap in / whip pan / product slides into frame
+        Avoid: camera slowly pushes in, person walking as buildup, empty establishing shot
+        Pacing: Complete the first camera change within 1-2 seconds
 
-[3-8s]  SHOWCASE — 特写 → 中景切换，展示产品细节
-        推荐：fast snap dolly in on details,
+[3-8s]  SHOWCASE — Close-up → medium shot transition, showcase product details
+        Recommended: fast snap dolly in on details,
               camera orbits or slides to reveal texture
 
-[8-12s] SCENE — 拉远到中景/全景，展示使用场景
-        推荐：camera pulls back to reveal full scene,
+[8-12s] SCENE — Pull back to medium/wide shot, show usage scenario
+        Recommended: camera pulls back to reveal full scene,
               natural movement as model interacts with environment
 
-[12-15s] CLOSE — 回到中景，面对镜头，定格
-         推荐：camera pushes in tight, then settles,
+[12-15s] CLOSE — Return to medium shot, face camera, freeze
+         Recommended: camera pushes in tight, then settles,
                model faces camera, product in frame,
-               frame holds steady（最后这个定格很重要）
+               frame holds steady (this final hold is important)
 ```
 
-## BGM 音乐指令（Prompt 内指定）
+## BGM Instructions (Specified in Prompt)
 
-视频模型可以在视频中生成背景音乐。**必须在 prompt 末尾加上 BGM 指令**：
+The video model can generate background music within the video. **Always add a BGM instruction at the end of the prompt**:
 
 ```
 Background music: [genre/mood description], [tempo], [energy level].
 ```
 
-**BGM 选择指南**：
+**BGM Selection Guide**:
 
-| 商品类型 | 推荐 BGM | Prompt 写法 |
-|----------|----------|-------------|
-| 运动/健身 | 节奏感强的电子/lo-fi | `Background music: upbeat electronic lo-fi beat, medium-fast tempo, energetic and motivating.` |
-| 美妆/护肤 | 温暖 R&B / chill pop | `Background music: warm chill R&B, slow-medium tempo, soft and intimate.` |
-| 3C 数码 | 干净 minimal / tech | `Background music: clean minimal electronic, medium tempo, modern and sleek.` |
-| 时尚服装 | Indie pop / trendy | `Background music: trendy indie pop, medium tempo, stylish and confident.` |
-| 家居 | Acoustic / ambient | `Background music: warm acoustic guitar, slow tempo, cozy and relaxing.` |
-| 食品 | Jazz / feel-good | `Background music: feel-good jazz, medium tempo, cheerful and appetizing.` |
+| Product Category | Recommended BGM | Prompt Phrasing |
+|-----------------|-----------------|-----------------|
+| Sports / Fitness | Rhythmic electronic / lo-fi | `Background music: upbeat electronic lo-fi beat, medium-fast tempo, energetic and motivating.` |
+| Beauty / Skincare | Warm R&B / chill pop | `Background music: warm chill R&B, slow-medium tempo, soft and intimate.` |
+| Electronics | Clean minimal / tech | `Background music: clean minimal electronic, medium tempo, modern and sleek.` |
+| Fashion | Indie pop / trendy | `Background music: trendy indie pop, medium tempo, stylish and confident.` |
+| Home | Acoustic / ambient | `Background music: warm acoustic guitar, slow tempo, cozy and relaxing.` |
+| Food | Jazz / feel-good | `Background music: feel-good jazz, medium tempo, cheerful and appetizing.` |
 
-**关键**：BGM 要配合视频节奏 — Hook 段需要能量感，收尾段可以稍缓。音乐风格要匹配产品调性。
+**Key**: BGM should match the video pacing — the hook segment needs energy, the closing can ease up. Music style should match the product's brand tone.
 
-## Prompt 写作风格：导演口述式（Director Dictation）
+## Prompt Writing Style: Director Dictation
 
-Prompt 应写成导演在片场口述指令的风格 — 6-10 句英文，每句只做一件事。避免把多个动作堆在一句长句里。
+Prompts should be written as if a director is dictating on set — 6-10 English sentences, each doing only one thing. Avoid packing multiple actions into one long sentence.
 
-**好的写法**（每句一个动作/镜头指令）：
+**Good writing** (one action/camera instruction per sentence):
 ```
 Camera snaps in on a close-up of the pink peanut massage ball sitting on a yoga mat.
 A 25-year-old woman with a high ponytail and black leggings walks into frame.
@@ -229,33 +234,33 @@ Camera pulls back to a medium shot showing the full living room scene.
 ...
 ```
 
-**不好的写法**（一句话塞太多动作）：
+**Bad writing** (too many actions crammed in one sentence):
 ```
 A woman enters carrying a pink ball while the camera pans and she says "..." as she lies down and rolls.
 ```
 
-## Prompt 质量检查清单
-
-- [ ] 纯英文导演口述式段落（6-10 句，每句一件事）
-- [ ] **开头有产品锚定**（一句话：产品是什么 + 用途 + 匹配参考图 + 无包装锁）
-- [ ] 紧接有模特外观锚定描述
-- [ ] **台词用 `Spoken dialogue (say EXACTLY, word-for-word):` 格式**（英文，4 句，闺蜜聊天感）
-- [ ] 每句台词后跟 `Mouth clearly visible when speaking, lip-sync aligned.`
-- [ ] Hook 台词在第一句，配合快速运镜
-- [ ] 收尾台词自然不硬推销
-- [ ] 包含具体的产品材质描述词
-- [ ] 运镜变化至少 3 次
-- [ ] 包含光线/氛围描述
-- [ ] 模特与产品有明确互动
-- [ ] 结尾 frame holds steady
-- [ ] 整体节奏：快开 → 细展 → 场景 → 定格
-- [ ] **末尾有 BGM 指令**（`Background music: [genre], [tempo], [energy]`）
-- [ ] Hook 段产品在第 1 帧出现，不铺垫
-
-## Renoise 提交注意事项
-
-- **必须上传商品图**作为 material（image1），产品还原度显著提升
-- **不上传真人模特图**，隐私检测会拦截（报错 PrivacyInformation）
-- 模特外观完全靠 prompt 文字描述控制
-- 商品图最好用干净白底纯产品图，避免有营销文字覆盖的图
-- 批量生成时复用同一 material ID，换场景/台词即可
+## Prompt Quality Checklist
+
+- [ ] Pure English director-dictation style paragraph (6-10 sentences, one thing per sentence)
+- [ ] **Product anchoring at the start** (one sentence: what the product is + use case + match reference image + no-packaging lock)
+- [ ] Model appearance anchoring description immediately after
+- [ ] **Dialogue uses `Spoken dialogue (say EXACTLY, word-for-word):` format** (English, 4 lines, best-friend casual tone)
+- [ ] `Mouth clearly visible when speaking, lip-sync aligned.` after each dialogue line
+- [ ] Hook dialogue in the first sentence, paired with fast camera movement
+- [ ] Closing dialogue is natural, no hard sell
+- [ ] Includes specific product material/texture descriptors
+- [ ] At least 3 camera movement changes
+- [ ] Includes lighting/atmosphere description
+- [ ] Model has clear physical interaction with product
+- [ ] Ending frame holds steady
+- [ ] Overall pacing: fast open → detailed showcase → scene → freeze
+- [ ] **BGM instruction at the end** (`Background music: [genre], [tempo], [energy]`)
+- [ ] Hook segment has product in Frame 1, no buildup
+
+## Renoise Submission Notes
+
+- **Must upload product image** as material (image1) — product accuracy improves significantly
+- **Never upload real person/model images** — privacy detection will block them (error: PrivacyInformation)
+- Model appearance is controlled entirely by prompt text description
+- Product images should ideally be clean white-background product photos, avoid images with marketing text overlays
+- For batch generation: upload the product image once, reuse the material ID and swap scenes/dialogue

package/skills/video-download/SKILL.md

@@ -3,7 +3,7 @@ name: video-download
 description: >
   Downloads videos from YouTube, TikTok, Douyin, Bilibili, Instagram, XiaoHongShu and 1000+ platforms.
   Primary: yt-dlp. Fallback: agent-browser + GreenVideo for Douyin/TikTok when yt-dlp fails.
-  Use when user says "download video", "save video", "下载视频", "抓取视频", "无水印下载",
+  Use when user says "download video", "save video", "grab video", "watermark-free download",
   or pastes a video URL. Do NOT use for AI video generation or video editing.
 allowed-tools: Bash
 metadata:

package/hooks/session-start.sh

@@ -1,17 +0,0 @@
-#!/usr/bin/env bash
-
-# SessionStart hook: check API key and guide user through setup if missing.
-
-set -euo pipefail
-
-# If API key is already configured, nothing to do
-if [ -n "${RENOISE_API_KEY:-}" ]; then
-  exit 0
-fi
-
-# API key is missing — tell Claude the minimal facts, let it handle the UX
-jq -n '{
-  systemMessage: "RENOISE_API_KEY is not set. Guide the user to configure it in .claude/settings.local.json under the env block. Get the key at https://www.renoise.ai . Do NOT ask the user to paste the key in the conversation. Do NOT proceed with video tasks until configured."
-}'
-
-exit 0