haidong

# Product Comparison & Review Copywriter

## Purpose

This skill generates fair, structured product comparison content — head-to-head comparison tables, category buying guides, balanced pros/cons analyses, specification battles, and personalized "best for" recommendations. It is built with fairness as a first principle: the output must be useful to readers making purchase decisions, not a disguised sales pitch. Designed for e-commerce product pages, editorial content, affiliate marketing, and merchant category pages.

## Triggers

- "product comparison"
- "product VS"
- "对比评测"
- "buying guide"
- "pros and cons"
- "选购指南"
- "compare products"
- "spec comparison"
- "best for recommendation"
- "优缺点分析"

## Workflow

1. Receive products to compare from user: Product A and Product B (or a category with multiple entries), with key specs, price points, target users, and any sponsored/editorial disclosure.
2. Build a feature comparison matrix: list all comparable features across both products, note where data is missing.
3. Generate balanced pros and cons for each product — a MINIMUM of 2 pros and 2 cons per product, even for the recommended one.
4. Create "best for" recommendations based on user personas, not product superiority: "Product A is best for [persona/use case], Product B is best for [different persona/use case]."
5. Apply the fairness gate: verify no invented weaknesses, no suppressed advantages, no defamatory language.
6. Output the complete comparison package: feature table + pros/cons + buying recommendation + fairness disclosure.

## Prompt Templates

### 1. Head-to-Head Comparison (`head_to_head_comparison`)
**Purpose:** Generate a structured A vs B comparison.
**Input:**
- `product_a_name` — Product A name + key specs
- `product_b_name` — Product B name + key specs
- `comparison_focus` — What matters most (price/performance/quality/features/ecosystem)
- `disclosure` — Editorial or sponsored relationship

**Output:** Feature matrix table + balanced pros/cons per product + "best for" verdict + fairness disclosure.

### 2. Buying Guide (`buying_guide`)
**Purpose:** Create a tiered buying guide for a product category.
**Input:**
- `category` — Product category (e.g., "noise-canceling headphones")
- `budget_tiers` — Price brackets with 1–2 products per tier
- `user_personas` — 2–3 buyer types and what they value

**Output:** Tiered guide: Budget Tier | Product(s) | Key Feature | Best For | Pros | Cons | Price.

### 3. Pros/Cons Generator (`pros_cons_generator`)
**Purpose:** Generate an objectively balanced pros/cons list for one product.
**Input:**
- `product_name` — Product
- `product_details` — Full specs, price, user reviews context
- `use_case` — Intended usage context

**Output:** Pros list (minimum 3) and Cons list (minimum 2), each with a one-sentence explanation.

### 4. Spec Battle (`spec_battle`)
**Purpose:** Format raw specifications into a readable comparison.
**Input:**
- `product_a_specs` — Structured spec list for Product A
- `product_b_specs` — Structured spec list for Product B
- `highlight_categories` — Which spec categories to emphasize

**Output:** Spec comparison table: Feature | Product A | Product B | Winner (if clear) | Note.

### 5. Best For Matcher (`best_for_matcher`)
**Purpose:** Match products to user personas with personalized recommendations.
**Input:**
- `product_options` — 2–5 products in a category
- `user_persona` — One persona description (type, budget, priorities, constraints)

**Output:** Ranked recommendation: #1 pick with reasoning, runner-up, and "avoid if" note for each product.

## Output Format

Every comparison is delivered in a reader-friendly structure:

**Feature Comparison Table:**
| Feature | Product A | Product B | Edge |
|---------|-----------|-----------|------|
| Price | ¥299 | ¥399 | A |
| ... | ... | ... | ... |

**Pros & Cons:**
- **Product A**
  - ✅ Pro 1: ...
  - ❌ Con 1: ...
- **Product B** (same structure)

**Verdict:** Best for [persona/use case] → [which product and why]

**Fairness Disclosure:** [Editorial/Sponsored/Data sources]

## Safety Rules

- **NEVER** invent or exaggerate a competitor's weakness — if data is missing, say "data not available"
- **NEVER** suppress or omit a competitor's genuine advantage
- **NEVER** use defamatory, dismissive, or insulting language about any product
- **NEVER** present sponsored content as editorial — always label sponsorship
- **ALWAYS** generate AT LEAST 2 cons for every product, even the recommended one
- **ALWAYS** cite sources when using third-party data or reviews
- **ALWAYS** provide a fairness disclosure section

## Examples

### Example 1: Head-to-Head (Smartphones)
**Input:** A="Phone X ¥2999 6.7in 5000mAh 64MP", B="Phone Y ¥3299 6.5in 4500mAh 108MP", Focus="camera+battery"
**Output:** Feature table with 8 rows, A wins on battery/price, B wins on camera/resolution. Pros/cons for each (Phone X con: "lower camera resolution"; Phone Y con: "higher price, smaller battery"). Verdict: "Phone X best for budget-conscious battery users; Phone Y best for photography enthusiasts."

### Example 2: Buying Guide
**Input:** Category="蓝牙耳机 (Bluetooth Earbuds)", Tiers=["入门<200", "中端200-500", "高端>500"], Personas=["通勤党", "运动党", "学生党"]
**Output:** Three-tier guide with 5 products, each linked to a persona, with balanced pros/cons.

## Related Skills

- [product-title-booster](../product-title-booster/) — For optimizing titles of the compared products
- [review-reply-coach](../review-reply-coach/) — For responding to reviews that the comparison may attract
- [landing-page-copy-pro](../landing-page-copy-pro/) — For the landing page hosting the buying guide

FILE:ACCEPTANCE.md
# Acceptance Criteria — Product Comparison & Review Copywriter

- [ ] SKILL.md is self-contained (agent can operate from it alone)
- [ ] All 5 prompt templates are complete with `placeholder` inputs
- [ ] Safety rules mandate fairness: minimum cons per product, no invented weaknesses, citation of sources
- [ ] README.md has clear install instructions + 3 usage examples
- [ ] skill.json is valid JSON with all required fields
- [ ] Content is unique — comparison table format differs from all other skills
- [ ] "Best for matcher" persona-based approach is structurally distinct from other recommendation-style outputs
- [ ] Slugs follow naming convention (user-facing, no prefix codes)

FILE:README.md
# Product Comparison & Review Copywriter

Fair, structured product comparisons — VS tables, buying guides, pros/cons, and personalized recommendations.

## Features

- Head-to-head A vs B comparison tables with balanced analysis
- Category buying guides with tiered recommendations per persona
- Objective pros/cons lists — always includes cons for every product
- Specification battle formatting for technical products
- "Best for" matcher that personalizes recommendations to user personas
- Built-in fairness gate: no invented weaknesses, no suppressed advantages

## Install

```
openclaw skills install harrylabsj/product-comparison-writer
```

## Usage

```
对比A和B两款扫地机器人，生成一个对比表格和选购建议
写一个2000元以内蓝牙耳机的选购指南，分入门、中端两档
为这款产品生成客观的优缺点列表，至少3个优点2个缺点
把这个产品的技术参数做成对比表格，和竞品PK
```

## Platforms

E-Commerce Product Pages, Blogs, Editorial Review Sites

## Safety

Fairness-first: every product gets real cons. No invented competitor weaknesses. Sponsored content is always labeled. All data sources cited.

## License

MIT

FILE:skill.json
{
  "name": "Product Comparison & Review Copywriter",
  "description": "Fair, structured product comparison copy — feature matrices, pros/cons tables, 'best for' recommendations, buying guides, and review roundups. Built-in fairness guardrails ensure ethical competitive comparison.",
  "version": "1.0.0",
  "type": "prompt-flow",
  "category": "E-Commerce / Product Content",
  "keywords": [
    "product comparison", "VS", "对比评测", "buying guide",
    "选购指南", "pros and cons", "review roundup", "comparison table",
    "best for", "spec comparison"
  ],
  "platforms": ["E-Commerce Product Pages", "Blogs", "Editorial Review Sites"],
  "requires": {},
  "requires_api": false,
  "author": "harrylabsj",
  "license": "MIT",
  "safety": {
    "no_code_execution": true,
    "no_network": true,
    "no_credentials": true,
    "compliance_notes": "MUST maintain fairness — no invented competitor weaknesses. No suppressed competitor advantages. Cite sources for third-party data. Label editorial vs sponsored. No defamatory language. All claims must be verifiable."
  }
}

# Promotional Email Writer

## Purpose

This skill generates complete promotional email copy for marketing campaigns — subject lines, preview text, body copy, and CTAs — across multiple campaign types: product launches, flash sales, abandoned cart recovery, newsletters, seasonal campaigns, and email drip sequences. Every output is structured for conversion and includes CAN-SPAM/GDPR compliance checks. Unlike social media skills, this is purpose-built for the email channel with its unique constraints: preview pane optimization, deliverability concerns, and legal compliance requirements.

## Triggers

- "写营销邮件"
- "promotional email"
- "email subject line"
- "abandoned cart email"
- "newsletter copy"
- "邮件营销"
- "email drip sequence"
- "邮件A/B测试"
- "促销邮件"
- "email campaign"

## Workflow

1. Receive campaign context from user: campaign type (launch/sale/abandoned cart/newsletter/seasonal), product details, target audience, and email goal.
2. Generate subject line(s) optimized for open rate: under 50 characters, preview-pane friendly, no deceptive language.
3. Write preview text that complements (not repeats) the subject line.
4. Structure body copy for scannability: headline → greeting → hook paragraph → product value → offer details → urgency (ethical) → CTA button → footer.
5. Craft primary CTA button copy with clear action language.
6. Include unsubscribe mechanism language and sender identity in footer.
7. Run compliance review: deceptive subject line check, missing unsubscribe check, misleading claim check.
8. Deliver complete email ready for ESP (Email Service Provider) upload.

## Prompt Templates

### 1. Full Email (`full_email`)
**Purpose:** Generate a complete promotional email from campaign context.
**Input:**
- `campaign_type` — launch / flash_sale / seasonal / newsletter / re-engagement
- `product_name` — Product or offer
- `promotion_details` — Discount, bundle, or offer specifics
- `target_audience` — Subscriber segment
- `brand_voice` — Tone: formal / casual / playful / luxury

**Output:** Complete email: Subject Line | Preview Text | Body Copy (with sections) | CTA Button | Footer (with unsubscribe).

### 2. Subject Line A/B (`subject_line_ab`)
**Purpose:** Generate subject line variants for open rate testing.
**Input:**
- `campaign_context` — Brief campaign description
- `audience_segment` — Who is receiving
- `count` — How many variants (default 5)

**Output:** 5 subject lines labeled by approach (curiosity, benefit, urgency, personalization, question) with character counts and predicted open-rate rationale.

### 3. Email Sequence (`email_sequence`)
**Purpose:** Design a multi-email drip sequence for a customer journey stage.
**Input:**
- `journey_stage` — Welcome / Nurture / Abandoned cart / Post-purchase / Win-back
- `product_name` — Product or brand
- `sequence_length` — Number of emails (typically 3–5)

**Output:** Email sequence table: Email # | Timing | Subject | Body Summary | CTA | Goal.

### 4. Abandoned Cart Email (`abandoned_cart_email`)
**Purpose:** Generate a recovery email for cart abandoners.
**Input:**
- `product_name` — Item(s) left in cart
- `cart_value` — Total cart value
- `abandonment_window` — Hours since abandonment
- `incentive` — Optional discount or free shipping offer

**Output:** Recovery email with: gentle reminder subject, product image description placeholders, benefit recap, urgency (if incentive), CTA back to cart.

### 5. Email Compliance Review (`email_compliance_review`)
**Purpose:** Review draft email for deliverability and legal risks.
**Input:**
- `email_draft` — Complete email: subject + body + footer
- `target_region` — GDPR (EU), CAN-SPAM (US), CASL (Canada), or PIPL (China)

**Output:** Compliance report: Check | Status (Pass/Flag) | Issue | Suggested Fix.

## Output Format

Every full email follows this deliverable structure:

```
SUBJECT LINE: [under 50 chars]
PREVIEW TEXT: [complements subject, under 100 chars]

[BODY]
Header/Logo space
Headline
Greeting
Hook paragraph
Product/Offer section
Social proof (if applicable)
CTA Button → [Button text]
Urgency/Scarcity note (ethical)
Closing

[FOOTER]
Unsubscribe link language
Company info
Privacy policy link
```

## Safety Rules

- **NEVER** write deceptive subject lines (e.g., "Re: Your order" when it's not a reply, fake "Urgent" flags)
- **NEVER** make misleading discount claims or hidden conditions
- **NEVER** omit unsubscribe mechanism language — it must be clearly present
- **ALWAYS** include proper sender identity (company name, physical address for CAN-SPAM)
- **ALWAYS** remind user about GDPR consent requirements for EU subscribers
- **ALWAYS** flag potential spam-trigger words in subject lines (e.g., "FREE!!!", "ACT NOW!!!")

## Examples

### Example 1: Full Email for Flash Sale
**Input:** Campaign="618大促", Product="XX护肤品套装", Discount="满300减50", Audience="女性25-40岁", Voice="亲切温暖"
**Output:** Subject "你的618专属护肤清单来了 ✨", preview "满300减50，这套搭配我们准备了很久", body with hero image placeholder, product trio showcase, discount breakdown, countdown urgency, CTA "立即抢购", full footer.

### Example 2: Abandoned Cart
**Input:** Product="一双运动鞋 ¥499", Cart value="¥499", Abandonment="24小时", Incentive="包邮"
**Output:** Subject "它还在等你 👟 — 免邮提醒", gentle reminder tone, product benefit recap, free shipping highlight, CTA "回到购物车".

## Related Skills

- [ad-copy-ab-tester](../ad-copy-ab-tester/) — For ad copy variants (paid channel vs. owned email)
- [social-caption-kit](../social-caption-kit/) — For social media promotion of the same campaign
- [landing-page-copy-pro](../landing-page-copy-pro/) — For the landing page that email CTAs link to

FILE:ACCEPTANCE.md
# Acceptance Criteria — Promotional Email Writer

- [ ] SKILL.md is self-contained (agent can operate from it alone)
- [ ] All 5 prompt templates are complete with `placeholder` inputs
- [ ] Safety rules address CAN-SPAM, GDPR, deceptive subjects, and unsubscribe compliance
- [ ] README.md has clear install instructions + 3 usage examples
- [ ] skill.json is valid JSON with all required fields
- [ ] Content is unique — email channel structure differs from social/ad skills
- [ ] Email sequence, abandoned cart, and compliance review are distinct features
- [ ] Slugs follow naming convention (user-facing, no prefix codes)

FILE:README.md
# Promotional Email Writer

Complete marketing email copy — subject lines, preview text, body, and CTAs for every campaign type.

## Features

- Full email generation for launches, flash sales, newsletters, seasonal campaigns
- Subject line A/B variants with predicted performance rationale
- Email drip sequence design for customer journey stages
- Abandoned cart recovery email templates
- CAN-SPAM/GDPR compliance review built-in
- Conversion-optimized CTA and body structure

## Install

```
openclaw skills install harrylabsj/promo-email-writer
```

## Usage

```
写一封618大促的营销邮件，产品是XX品牌的护肤品套装，满300减50
为这封邮件生成5个不同的标题做A/B测试
写一封弃购挽回邮件，用户加了购物车24小时没付款
设计一个3封邮件的欢迎序列，产品是SaaS订阅服务
```

## Platforms

Email (Platform-Agnostic — works with any ESP)

## Safety

CAN-SPAM compliant. No deceptive subject lines. Clear unsubscribe language. GDPR-aware. Honest offers with no hidden conditions.

## License

MIT

FILE:skill.json
{
  "name": "Promotional Email Writer",
  "description": "Complete promotional email copy — subject lines, preview text, body copy, and CTAs for launches, flash sales, abandoned cart, newsletters, and seasonal campaigns. Conversion-focused with CAN-SPAM compliance.",
  "version": "1.0.0",
  "type": "prompt-flow",
  "category": "Marketing / Email Marketing",
  "keywords": [
    "email copy", "promo email", "marketing email", "subject line",
    "abandoned cart", "newsletter", "email campaign",
    "CAN-SPAM", "email sequence", "营销邮件"
  ],
  "platforms": ["Email (Platform-Agnostic)"],
  "requires": {},
  "requires_api": false,
  "author": "harrylabsj",
  "license": "MIT",
  "safety": {
    "no_code_execution": true,
    "no_network": true,
    "no_credentials": true,
    "compliance_notes": "CAN-SPAM/GDPR compliant subject lines — no deceptive openers. Clear unsubscribe mechanism language. No misleading discount claims. Proper sender identity. GDPR-aware data handling reminders."
  }
}

# Multi-Platform Social Caption Kit

## Purpose

This skill takes one core brand message or product brief and generates platform-optimized captions for six major social platforms simultaneously: WeChat Moments (朋友圈), Weibo, Instagram, Facebook, Twitter/X, and LinkedIn. Each caption is adapted to the platform's unique tone norms, length constraints, hashtag conventions, emoji culture, and audience expectations — while preserving a consistent brand voice. "Kit" signals a bundled, all-in-one caption package rather than single-platform generation.

## Triggers

- "生成朋友圈文案"
- "social caption pack"
- "多平台配文"
- "caption for all platforms"
- "brand caption"
- "社交媒体配文"
- "cross-platform post"
- "品牌配文"
- "hashtag strategy"
- "平台适配文案"

## Workflow

1. Receive the core message/product brief from user: what to communicate, brand voice description, campaign type, and which platforms to cover.
2. If brand voice is not specified, ask clarifying questions about tone, formality, and personality before generation.
3. Generate platform-adapted captions:
   - **WeChat Moments (朋友圈)**: Conversational, personal tone, 1–2 emoji, no hashtags, optional @mentions
   - **Weibo**: More public-facing, hashtag-heavy (#话题#), can be longer, trending topic integration
   - **Instagram**: Visual-first context, heavy emoji usage, hashtag block (up to 30), Story-friendly format
   - **Facebook**: Community-oriented, engagement-driving questions, link-friendly, longer form OK
   - **Twitter/X**: Concise within 280 chars, trending hashtag, thread-compatible
   - **LinkedIn**: Professional tone, thought-leadership framing, minimal hashtags (3–5)
4. Apply platform-specific best practices: link handling (URL placement differs), emoji density, @mention conventions, and hashtag norms.
5. Include a hashtag strategy section per platform: which hashtags, how many, and why.
6. Add engagement hooks appropriate to each platform's interaction patterns (questions, polls, CTAs).
7. Output as a unified caption pack with clear platform labels.

## Prompt Templates

### 1. Caption Pack (`caption_pack`)
**Purpose:** Generate cross-platform captions from one core message.
**Input:**
- `core_message` — The key message or announcement
- `brand_voice` — Tone descriptors (e.g., "warm humorous professional")
- `media_type` — Text-only / image post / video post / carousel
- `platforms` — Which platforms to generate for (default: all 6)

**Output:** Platform-labeled caption pack with: Platform | Caption | Character Count | Hashtags | Engagement Hook.

### 2. Brand Voice Presets (`brand_voice_presets`)
**Purpose:** Guide the user through defining a consistent brand voice, then generate sample captions.
**Input:**
- `brand_description` — Free-text brand personality (e.g., "a DTC skincare brand that feels like a knowledgeable older sister")
- `sample_message` — One test message to generate sample captions for

**Output:** Brand voice definition (3 adjectives + example sentences) + 3 platform-adapted sample captions in the defined voice.

### 3. Campaign Caption Suite (`campaign_caption_suite`)
**Purpose:** Generate a multi-platform caption rollout for a campaign.
**Input:**
- `campaign_name` — Campaign name or theme
- `campaign_duration` — Timeline (launch day, mid-campaign, closing)
- `assets_available` — Types of media available (images, video, UGC)

**Output:** Campaign caption calendar: Date/Phase | Platform | Caption | Media Note.

### 4. Platform Hashtag Strategy (`platform_hashtag_strategy`)
**Purpose:** Generate a hashtag strategy tailored per platform for a given topic.
**Input:**
- `topic` — Content topic or product category
- `target_platforms` — Which platforms need hashtag strategies

**Output:** Per-platform hashtag sets: Platform | Niche Hashtags (3–5) | Broad Hashtags (2–3) | Trending (1–2) | Count Guidance.

### 5. Engagement Booster (`engagement_booster`)
**Purpose:** Enhance an existing caption for higher engagement.
**Input:**
- `existing_caption` — Current caption text
- `platform` — Platform it's intended for
- `engagement_goal` — Comments/Shares/Saves/Clicks

**Output:** Enhanced caption with: improved hook, engagement question, CTA, optimized hashtags, emoji placement.

## Output Format

**Caption Pack format:**

| Platform | Caption | Chars | Hashtags | Engagement |
|----------|---------|-------|----------|------------|
| WeChat Moments | 文案... | 120 | N/A | 互动问题 |

Each caption is self-contained and ready to copy-paste into the respective platform.

## Safety Rules

- **NEVER** suggest engagement bait tactics that violate platform TOS (e.g., "tag 3 friends to win")
- **NEVER** create content that impersonates individuals or brands
- **NEVER** use a fake persona or fabricated identity in brand voice
- **ALWAYS** maintain authentic, human tone — the caption should sound like a real person wrote it
- **ALWAYS** include disclosure reminders for sponsored/paid content
- **ALWAYS** respect per-platform content policies, age restrictions, and sensitive topic rules

## Examples

### Example 1: Caption Pack for Product Launch
**Input:** Core message="新品咖啡豆上市，单一产地哥伦比亚，中深烘", Brand voice="casual coffee nerd", Platforms="all 6"
**Output:** Six captions: WeChat Moments (day-in-life style), Weibo (hashtag-heavy announcement), Instagram (visual tasting notes), Facebook (community question), Twitter/X (sharp one-liner), LinkedIn (sourcing story with professional angle).

### Example 2: Brand Voice Presets
**Input:** Brand="婴儿护肤品牌，走成分安全、妈妈放心路线", Test message="新品婴儿润肤乳上市"
**Output:** Brand voice defined as "gentle, knowledgeable, reassuring" with sample captions demonstrating each tone.

## Related Skills

- [viral-xiaohongshu-notes](../viral-xiaohongshu-notes/) — For Xiaohongshu-specific content (platform-native format)
- [ad-copy-ab-tester](../ad-copy-ab-tester/) — For paid ad copy (different intent: ads vs. organic)
- [promo-email-writer](../promo-email-writer/) — For email channel (different medium)

FILE:ACCEPTANCE.md
# Acceptance Criteria — Multi-Platform Social Caption Kit

- [ ] SKILL.md is self-contained (agent can operate from it alone)
- [ ] All 5 prompt templates are complete with `placeholder` inputs
- [ ] Safety rules address platform TOS, authentic voice, and disclosure
- [ ] README.md has clear install instructions + 3 usage examples
- [ ] skill.json is valid JSON with all required fields
- [ ] Content is unique — cross-platform caption pack structure differs from single-platform skills
- [ ] Brand voice presets feature is a differentiator not present in other skills
- [ ] Slugs follow naming convention (user-facing, no prefix codes)

FILE:README.md
# Multi-Platform Social Caption Kit

One message → six platform-optimized captions. Post everywhere without sounding the same everywhere.

## Features

- Generate captions for WeChat Moments, Weibo, Instagram, Facebook, Twitter/X, and LinkedIn simultaneously
- Preserve consistent brand voice across platforms while adapting tone
- Built-in hashtag strategy per platform (count, type, placement)
- Brand voice definition and preset generation
- Campaign caption suite with timeline planning
- Engagement booster for underperforming captions

## Install

```
openclaw skills install harrylabsj/social-caption-kit
```

## Usage

```
帮我为这款新上市的咖啡豆生成6个平台的配文，品牌调性是"专业但轻松的咖啡爱好者"
用"温暖陪伴"的品牌调性，为母亲节活动生成各平台配文
给这段Instagram配文增强互动性，目标是增加评论
帮我定义一下我的品牌声音，然后生成几个平台的示例配文
```

## Platforms

WeChat Moments (朋友圈), Weibo, Instagram, Facebook, Twitter/X, LinkedIn

## Safety

No engagement bait. No fake personas. Authentic brand voice. All sponsored content disclosure reminders included.

## License

MIT

FILE:skill.json
{
  "name": "Multi-Platform Social Caption Kit",
  "description": "One message → optimized captions for 6 social platforms (WeChat Moments, Weibo, Instagram, Facebook, Twitter/X, LinkedIn). Preserves brand voice while adapting tone, length, hashtags, and CTAs per platform.",
  "version": "1.0.0",
  "type": "prompt-flow",
  "category": "Social Media Content / Multi-Platform",
  "keywords": [
    "social caption", "朋友圈文案", "Weibo caption", "Instagram caption",
    "cross-platform", "brand voice", "hashtag strategy",
    "social media pack", "配文", "multi-platform"
  ],
  "platforms": ["WeChat Moments (朋友圈)", "Weibo", "Instagram", "Facebook", "Twitter/X", "LinkedIn"],
  "requires": {},
  "requires_api": false,
  "author": "harrylabsj",
  "license": "MIT",
  "safety": {
    "no_code_execution": true,
    "no_network": true,
    "no_credentials": true,
    "compliance_notes": "No platform TOS violations (engagement bait, misleading content). Authentic tone — no fake persona or fabricated identity. Proper disclosure for sponsored/paid content. Respect per-platform content policies and restricted topics. No impersonation of individuals or brands."
  }
}

# Ad Copy Variants for A/B Testing

## Purpose

This skill generates systematic, labeled ad copy variants designed for structured A/B testing across paid advertising platforms. It produces five distinct appeal-angle variants per product — Emotional, Rational, Scarcity, Social Proof, and Problem-Solution — each formatted for the target platform's constraints and policies. A built-in compliance checker flags potential ad policy violations before launch. Designed for performance marketers and media buyers who need testable, measurable creative variations, not random copy suggestions.

## Triggers

- "generate ad variants"
- "A/B test ad copy"
- "广告文案变体"
- "ad copy ab test"
- "create ad copy"
- "广告A/B测试"
- "multiple ad versions"
- "ad variant matrix"
- "headline bank"
- "CTA optimizer"

## Workflow

1. Receive product info + target ad platform(s) from user: product name, key benefits, target audience, budget tier, and campaign goal.
2. Generate the 5-angle variant matrix:
   - **Emotional**: Tap into desire, aspiration, or joy
   - **Rational**: Feature-driven, logical, value-focused
   - **Scarcity**: Limited-time, limited-quantity (ethically constrained)
   - **Social Proof**: User numbers, ratings, endorsements (only if verifiable)
   - **Problem-Solution**: Pain point → product as solution
3. Apply platform-specific constraints: character limits (e.g., WeChat Moments: 40 chars headline; Google: 30/90/90), image-text ratio rules, and forbidden content categories.
4. Run a compliance check against the target platform's ad policies, flagging: prohibited claims, missing disclosures, superlatives without substantiation, sensitive categories.
5. Generate CTA alternatives for each variant — platform-appropriate and conversion-optimized.
6. Output the full variant matrix, labeled and ready for ad platform upload.

## Prompt Templates

### 1. Variant Matrix (`variant_matrix`)
**Purpose:** Generate the full 5-angle A/B variant matrix.
**Input:**
- `product_name` — Product
- `key_benefits` — 2–3 main benefits
- `target_audience` — Demographic and psychographic
- `platform` — Ad platform name
- `campaign_goal` — Awareness/Consideration/Conversion

**Output:** A labeled 5-variant table: Variant Label | Headline | Body/Description | CTA | Character Counts.

### 2. Ad Compliance Check (`ad_compliance_check`)
**Purpose:** Review ad copy for platform-specific policy violations.
**Input:**
- `ad_copy_full` — Complete ad text (headline + body + CTA)
- `platform` — Target ad platform
- `product_category` — Product category (for restricted category checks)

**Output:** Compliance report: Flag | Severity | Issue Description | Suggested Fix.

### 3. CTA Optimizer (`cta_optimizer`)
**Purpose:** Generate alternative CTAs for existing ad copy.
**Input:**
- `ad_copy` — Existing ad body text
- `platform` — Platform context
- `goal` — Click/Conversion/Engagement

**Output:** 3 CTA alternatives with rationale for each and platform-fit score.

### 4. Headline Bank (`headline_bank`)
**Purpose:** Generate 10 headline angles for a product.
**Input:**
- `product_name` — Product
- `target_audience` — Audience
- `platform` — Platform (determines character limits)

**Output:** 10 headlines labeled by angle type (curiosity, benefit, question, statistic, comparison, emotional, how-to, direct, testimonial, news) with character count.

### 5. Ad Fatigue Refresher (`ad_fatigue_refresher`)
**Purpose:** Refresh an existing top-performing ad with new variants.
**Input:**
- `current_top_ad` — Currently best-performing ad copy
- `performance_metric` — What metric (CTR/conversion) it leads on
- `fatigue_signal` — Why refresh (frequency up, CTR dropping)

**Output:** 3 refreshed variants that preserve winning elements but change angle, format, or CTA.

## Output Format

All variants are delivered in a structured A/B test matrix:

| Variant # | Angle Type | Headline | Body (truncated) | CTA | Expected Audience Response |
|-----------|-----------|----------|------------------|-----|---------------------------|
| A | Emotional | ... | ... | ... | ... |
| B | Rational | ... | ... | ... | ... |

Plus compliance flags table when requested.

## Safety Rules

- **NEVER** include forbidden claims per platform ad policy (health guarantees, financial returns, weight loss promises)
- **NEVER** use discriminatory, exclusionary, or exploitative language
- **NEVER** include misleading before/after representations without verifiable data
- **NEVER** use unsubstantiated superlatives ("best", "#1", "top-rated") unless independently verifiable
- **ALWAYS** include required disclosures: "Ad", "Sponsored", "Promotion" per platform
- **ALWAYS** flag sensitive product categories (health, finance, supplements) for extra review

## Examples

### Example 1: Variant Matrix for WeChat Moments
**Input:** Product="在线英语课程", Audience="25-35岁职场人", Platform="WeChat Moments", Goal="Conversion"
**Output:** 5 variants: Emotional ("遇见更好的自己"), Rational ("每天15分钟，3个月流利对话"), Scarcity ("限时优惠，仅剩200名额"), Social Proof ("10万+学员的选择"), Problem-Solution ("开会不敢开口？试试这个方法").

### Example 2: Compliance Check
**Input:** Ad copy with "100% guaranteed results in 7 days", Platform="Google Ads", Category="Education"
**Output:** HIGH severity flag: absolute guarantee claim without substantiation. Suggested: "Join 10,000+ learners" instead.

## Related Skills

- [social-caption-kit](../social-caption-kit/) — For organic social captions (not paid ads)
- [promo-email-writer](../promo-email-writer/) — For email marketing variants (different channel)
- [landing-page-copy-pro](../landing-page-copy-pro/) — For landing page copy that the ad links to

FILE:ACCEPTANCE.md
# Acceptance Criteria — Ad Copy Variants for A/B Testing

- [ ] SKILL.md is self-contained (agent can operate from it alone)
- [ ] All 5 prompt templates are complete with `placeholder` inputs
- [ ] Safety rules address platform ad policies, forbidden claims, and required disclosures
- [ ] README.md has clear install instructions + 3 usage examples
- [ ] skill.json is valid JSON with all required fields
- [ ] Content is unique — A/B test matrix format with labeled angles differs from all other skills
- [ ] Compliance checker is a distinct, platform-aware feature not present in other skills
- [ ] Slugs follow naming convention (user-facing, no prefix codes)

FILE:README.md
# Ad Copy Variants for A/B Testing

Systematic ad copy generation — 5 labeled variants per product for structured A/B testing across major ad platforms.

## Features

- 5-angle variant matrix: Emotional, Rational, Scarcity, Social Proof, Problem-Solution
- Platform-specific formatting for WeChat, Douyin, Google, Facebook, Kuaishou
- Built-in compliance checker with platform ad policy flagging
- CTA optimizer with platform-fit scoring
- Headline bank: 10 angle-labeled headlines per product
- Ad fatigue refresher for creative rotation

## Install

```
openclaw skills install harrylabsj/ad-copy-ab-tester
```

## Usage

```
为这款产品生成5组微信朋友圈广告文案变体，分别用情感、理性、稀缺、社会证明、问题-解决角度
检查这段广告文案在抖音信息流是否合规
给我10个产品标题的广告角度，投Google Ads用
现有的广告效果下降了，帮我refresh 3个新版本
```

## Platforms

WeChat Moments Ads, Douyin Feed Ads, Google Ads, Facebook/Instagram Ads, Kuaishou Ads

## Safety

All variants respect platform ad policies. No forbidden claims, no discriminatory language, no unsubstantiated superlatives. Includes compliance flagging and disclosure reminders.

## License

MIT

FILE:skill.json
{
  "name": "Ad Copy Variants for A/B Testing",
  "description": "Systematic A/B ad copy generation with labeled variants (emotional, rational, scarcity, social proof, problem-solution) across WeChat, Douyin, Google, Facebook, and Kuaishou ad platforms. Includes compliance checks.",
  "version": "1.0.0",
  "type": "prompt-flow",
  "category": "Advertising / Creative Copy",
  "keywords": [
    "ad copy", "A/B test", "广告文案", "ad variant", "creative testing",
    "WeChat ad", "Douyin ad", "Google ad copy", "Facebook ad",
    "headline bank", "CTA optimization"
  ],
  "platforms": ["WeChat Moments Ads", "Douyin Feed Ads", "Google Ads", "Facebook/Instagram Ads", "Kuaishou Ads"],
  "requires": {},
  "requires_api": false,
  "author": "harrylabsj",
  "license": "MIT",
  "safety": {
    "no_code_execution": true,
    "no_network": true,
    "no_credentials": true,
    "compliance_notes": "No forbidden claims per platform ad policy. No discriminatory or exclusionary language. No misleading before/after representations. No unsubstantiated superlatives without verification. Include required disclosures per platform."
  }
}

# Product Title & Selling-Point Booster

## Purpose

This skill optimizes e-commerce product titles for search visibility and conversion across five major platforms: Taobao (淘宝), JD (京东), Pinduoduo (拼多多), Amazon, and Shopify/independent stores. It applies platform-specific constraints — character limits, keyword positioning rules, and formatting conventions — to extract high-intent keywords and craft titles that rank better and convert more clicks. "Booster" signals immediate, measurable listing improvement.

## Triggers

- "优化商品标题"
- "生成淘宝标题"
- "Amazon title optimizer"
- "product title booster"
- "标题优化"
- "listing title"
- "电商标题"
- "title A/B test"
- "多平台标题"
- "标题评分"

## Workflow

1. Receive product details from user: product name, brand, category, key attributes (material, size, color, function), and target platform(s).
2. Mine relevant keywords from product attributes: core product term, modifier keywords (material, style, season), scenario keywords, and audience keywords.
3. Apply platform-specific constraints:
   - Taobao: 60 characters max, keyword-stacking style, core term early
   - JD: Brand first, spec-dense, model numbers prominent
   - PDD: Value/price keywords prominent, benefit language
   - Amazon: 200 characters max, no promotional language, backend search terms separate
   - Shopify: SEO-optimized, H1-friendly, conversion-focused
4. Generate optimized title(s) that pack maximum search value within constraints.
5. Create A/B variant suggestions with rationale explaining why each variant may perform differently.
6. Score the original/optimized title and explain each optimization choice.

## Prompt Templates

### 1. Title from Product Info (`title_from_product_info`)
**Purpose:** Generate an optimized title from raw product details.
**Input:**
- `brand` — Brand name
- `product_type` — Core product term
- `key_attributes` — Material, size, color, function, style
- `target_platform` — Platform name
- `current_title` — (Optional) Existing title to improve

**Output:** Optimized title + character count + keyword analysis table showing which keywords were included and why.

### 2. Multi-Platform Title Pack (`multi_platform_title_pack`)
**Purpose:** Generate titles for 5 platforms from one product.
**Input:**
- `product_details` — Same as above
- `platforms` — List of target platforms

**Output:** Title per platform, each with character count and platform-specific optimization notes.

### 3. Title A/B Variants (`title_ab_variants`)
**Purpose:** Generate 3 alternative titles with rationale.
**Input:**
- `current_title` — Current title
- `hypothesis` — What to test (keyword order, emotional appeal, specificity)

**Output:** 3 variant titles, each with: variant title, character count, hypothesis tested, expected click/ranking impact.

### 4. Keyword Extractor (`keyword_extractor`)
**Purpose:** Mine keywords from competitor titles for strategy.
**Input:**
- `competitor_titles` — 3–5 competitor listing titles
- `target_platform` — Platform context

**Output:** Keyword frequency table, gap analysis (what competitors use that you don't), and suggested keyword additions.

### 5. Title Grader (`title_grader`)
**Purpose:** Score a title and suggest improvements.
**Input:**
- `title` — Title to evaluate
- `platform` — Platform rules apply

**Output:** Score out of 100 + breakdown by dimension (keyword coverage, readability, platform compliance, conversion appeal) and specific improvement suggestions.

## Output Format

Titles are delivered with:
- **Optimized title** (bolded)
- **Character count** (with platform limit noted)
- **Keyword analysis table:** Keyword | Search Intent | Position | Reason
- **A/B variants** (when requested): Variant | Hypothesis | Expected Impact

## Safety Rules

- **NEVER** stuff keywords in a way that violates specific platform listing policies
- **NEVER** include trademarked competitor brand names in titles
- **NEVER** make misleading claims about product attributes, materials, or certifications
- **ALWAYS** verify proposed titles against platform-specific restricted term lists
- **ALWAYS** remind user to check platform's latest title guidelines (policies change)

## Examples

### Example 1: Taobao Title Optimization
**Input:** Brand="XX", Type="真丝连衣裙", Attributes="中长款、修身、2024新款、桑蚕丝", Platform="Taobao"
**Output:** "XX2024新款桑蚕丝真丝连衣裙女中长款修身显瘦高级感气质" (38 chars / 60 limit) with keyword analysis.

### Example 2: Multi-Platform Pack
**Input:** Same product, Platforms=[Taobao, Amazon, Shopify]
**Output:** Three titles with different structural approaches: keyword-stacked (Taobao), brand-spec (Amazon), SEO-optimized (Shopify).

## Related Skills

- [product-comparison-writer](../product-comparison-writer/) — For comparison tables after titles are optimized
- [ad-copy-ab-tester](../ad-copy-ab-tester/) — For testing which title performs better in ads
- [viral-xiaohongshu-notes](../viral-xiaohongshu-notes/) — For promoting the product with content marketing

FILE:ACCEPTANCE.md
# Acceptance Criteria — Product Title & Selling-Point Booster

- [ ] SKILL.md is self-contained (agent can operate from it alone)
- [ ] All 5 prompt templates are complete with `placeholder` inputs
- [ ] Safety rules address platform-specific keyword policies
- [ ] README.md has clear install instructions + 3 usage examples
- [ ] skill.json is valid JSON with all required fields
- [ ] Content is unique — platform constraint table differs from all other skills
- [ ] Multi-platform title pack is structurally distinct from social-caption-kit (titles vs. captions)
- [ ] Slugs follow naming convention (user-facing, no prefix codes)

FILE:README.md
# Product Title & Selling-Point Booster

Platform-aware product title optimization — boost search visibility on Taobao, JD, PDD, Amazon, and Shopify.

## Features

- Generate optimized titles respecting each platform's character limits and conventions
- Multi-platform title pack: one product → five platform-optimized titles
- A/B variant generation with hypothesis and predicted impact
- Competitor keyword extraction and gap analysis
- Title grading with dimensional scores and improvement suggestions
- Selling-point extraction from product attributes

## Install

```
openclaw skills install harrylabsj/product-title-booster
```

## Usage

```
为这款产品优化淘宝标题：XX品牌 2024新款 真丝连衣裙 中长款 修身
同一个产品，分别生成淘宝、京东、PDD、Amazon的标题
帮我的亚马逊标题打分并提出优化建议
从这5个竞品标题里提取关键词策略
```

## Platforms

Taobao, JD (京东), Pinduoduo (拼多多), Amazon, Shopify

## Safety

No keyword stuffing. No competitor brand names. No misleading attributes. All titles comply with platform-specific listing policies.

## License

MIT

FILE:skill.json
{
  "name": "Product Title & Selling-Point Booster",
  "description": "Platform-aware product title optimization for Taobao, JD, PDD, Amazon, and Shopify. Extracts keywords, respects per-platform character limits and conventions, and generates A/B title variants to boost search visibility.",
  "version": "1.0.0",
  "type": "prompt-flow",
  "category": "E-Commerce / Listing Optimization",
  "keywords": [
    "product title", "商品标题优化", "SEO title", "listing optimization",
    "Taobao title", "Amazon title", "title A/B test",
    "keyword optimization", "selling point", "搜索优化"
  ],
  "platforms": ["Taobao", "JD", "Pinduoduo", "Amazon", "Shopify"],
  "requires": {},
  "requires_api": false,
  "author": "harrylabsj",
  "license": "MIT",
  "safety": {
    "no_code_execution": true,
    "no_network": true,
    "no_credentials": true,
    "compliance_notes": "No keyword stuffing that violates platform rules. No unauthorized trademark usage. No competitor brand names in title. No misleading product attributes or specifications. Verify against platform-specific restricted terms."
  }
}

# Live Commerce Sales Script Kit

## Purpose

This skill generates professional live-streaming sales scripts for live commerce hosts on platforms like Douyin Live (抖音直播), Kuaishou Live (快手直播), and Taobao Live. It covers every aspect: product introduction flow, pricing reveal cadence, urgency-building phrases (ethically constrained), audience interaction triggers, Q&A preparation, segment timing, and full-session outlines. Think of it as a director's script for your live commerce show — "Kit" signals a ready-to-use bundle of templates and frameworks, not a single monolithic output.

## Triggers

- "直播带货话术"
- "直播脚本"
- "直播话术"
- "带货脚本"
- "live selling script"
- "flash sale script"
- "直播互动"
- "单品直播"
- "整场直播规划"
- "逼单话术"

## Workflow

1. Receive product information and session type from user: single product demo, multi-product session, or flash sale.
2. For single product: structure the 3–8 minute product introduction flow (hook → demonstration → benefits → pricing → urgency → CTA).
3. For multi-product: build a time-allocated session outline with product sequence, transition monologues, and energy management.
4. Insert audience interaction triggers at regular intervals: polls, Q&A prompts, comment callouts, engagement games.
5. Add urgency-building phrases and transitional language — always with ethical constraints on scarcity and pricing claims.
6. Prepare anticipated audience Q&A pairs for each product.
7. Include pacing notes, segment timing, and host energy level guidance.
8. Deliver script with anchor monologue, interaction triggers, Q&A branches, and timing guide.

## Prompt Templates

### 1. Single Product Live Script (`single_product_live_script`)
**Purpose:** Generate a complete 3–8 minute script for showcasing one product.
**Input:**
- `product_name` — Product name
- `price` — Selling price (and optional original price)
- `key_features` — 3–5 key selling points
- `target_audience` — Who's watching
- `duration_minutes` — Target segment length (3–8)

**Output:** Timed script with sections: Opening Grab → Product Reveal → Feature Demo → Comparison → Pricing Reveal → Urgency Build → CTA → Transition.

### 2. Full Session Flow (`full_session_flow`)
**Purpose:** Design a complete multi-product 1–4 hour live session.
**Input:**
- `product_list` — List of products with selling order priority
- `session_duration` — Total session length in hours
- `flow_style` — Energy curve: high-low-high / sustained / gradual build

**Output:** Time-allocated outline with: Warm-up, Product 1-n, Intermission moments, Flash sales, Closing. Each with estimated duration, transition monologue, and energy level.

### 3. Urgency Phrase Bank (`urgency_phrase_bank`)
**Purpose:** Generate a categorized bank of urgency phrases for live selling.
**Input:**
- `scenario` — Situation: limited-time offer / low stock / exclusive deal / first-time buyer bonus
- `count` — Number of phrase variants per category

**Output:** Phrases organized by category (timing-based / quantity-based / exclusivity-based), each with an ethical constraint note.

### 4. Audience Q&A Prep (`audience_qa_prep`)
**Purpose:** Anticipate and prepare responses for common audience questions.
**Input:**
- `product_name` — Product
- `product_details` — Specs, materials, sizes, guarantees
- `common_concerns` — Typical buyer hesitations for this product type

**Output:** 15–20 Q&A pairs organized by question type: product/details, pricing/value, logistics/after-sales, objections/skepticism.

### 5. Flash Sale Countdown (`flash_sale_countdown`)
**Purpose:** Generate a high-energy countdown script for a limited-time offer.
**Input:**
- `product_name` — Product
- `flash_price` — Flash sale price
- `original_price` — Regular price
- `quantity_available` — Actual available quantity
- `duration_seconds` — Countdown window (typically 60–180s)

**Output:** Countdown script with: Price Reveal → Quantity Mention → 30s Reminder → 10s Final Call → Sold Out / Next Product.

## Output Format

All scripts follow a formatted broadcast table:

| Time | Segment | Anchor Monologue | Interaction Trigger | Energy Level |
|------|---------|-----------------|---------------------|--------------|
| 0:00–1:00 | Opening | "Welcome..." | Ask where watching from | 🔥 High |
| ... | ... | ... | ... | ... |

## Safety Rules

- **NEVER** fabricate false scarcity (e.g., "only 3 left" when stock is ample)
- **NEVER** invent fake original prices or price anchors to make discounts look bigger
- **NEVER** use high-pressure tactics targeting vulnerable consumers (elderly, financially distressed)
- **ALWAYS** prompt host to verify and disclose actual stock levels
- **ALWAYS** comply with platform-specific live commerce regulations
- **ALWAYS** maintain honest product descriptions — no exaggerated efficacy claims

## Examples

### Example 1: Single Product Script
**Input:** Product = "XX面霜", Price = "299元 (原价399)", Features = "保湿、修护、敏感肌可用", Duration = "5分钟"
**Output:** 5-minute script with opening hook about winter skin, ingredient demo, texture test, pricing reveal with savings calculation, limited-time urgency, and link click CTA.

### Example 2: Flash Sale Countdown
**Input:** Product = "蓝牙耳机", Flash = "99元 (原价199)", Qty = "50件", Duration = "120s"
**Output:** Countdown script with Qty count decrements at 50, 30, 10 remaining, 30s and 10s reminders, final call, and transition.

## Related Skills

- [douyin-script-studio](../douyin-script-studio/) — For pre-recorded Douyin video scripts (recorded, not live)
- [product-title-booster](../product-title-booster/) — For optimizing product listing titles used during live segments
- [review-reply-coach](../review-reply-coach/) — For handling post-live customer feedback and reviews

FILE:ACCEPTANCE.md
# Acceptance Criteria — Live Commerce Sales Script Kit

- [ ] SKILL.md is self-contained (agent can operate from it alone)
- [ ] All 5 prompt templates are complete with `placeholder` inputs
- [ ] Safety rules are explicit and actionable (NEVER/ALWAYS format) — especially false scarcity and fake price anchors
- [ ] README.md has clear install instructions + 3 usage examples
- [ ] skill.json is valid JSON with all required fields
- [ ] Content is unique — real-time broadcast format differs from douyin-script-studio (recorded)
- [ ] Flash sale, Q&A prep, and urgency phrase bank are structurally distinct features
- [ ] Slugs follow naming convention (user-facing, no prefix codes)

FILE:README.md
# Live Commerce Sales Script Kit

Professional live-streaming sales scripts for hosts — product flows, urgency phrases, Q&A prep, and full session outlines.

## Features

- Single product demo scripts (3–8 minutes) with full structure
- Multi-product session outlines for 1–4 hour broadcasts
- Urgency-building phrase bank with ethical guardrails
- Audience Q&A preparation with 15–20 anticipated questions
- Flash sale countdown scripts with pacing guidance
- Interaction triggers and energy management notes

## Install

```
openclaw skills install harrylabsj/live-selling-script-kit
```

## Usage

```
帮我写一个5分钟的单品直播脚本，产品是299元的面霜，主打保湿修护
规划一场2小时的女装直播，有8个款，给我安排流程和时间
帮我准备观众可能问的20个问题和标准回复
写一段限时秒杀的倒数话术，蓝牙耳机秒杀，50件库存
```

## Platforms

抖音直播, 快手直播, Taobao Live, General Live Streaming

## Safety

No fake scarcity. No fabricated original prices. Honest stock disclosures. Ethical urgency language only. All scripts prompt the host to verify claims and stock before broadcast.

## License

MIT

FILE:skill.json
{
  "name": "Live Commerce Sales Script Kit",
  "description": "Ready-to-use live streaming sales scripts — product introduction flows, pricing reveal cadence, urgency-building phrases, audience Q&A prep, and full-session outlines for live commerce hosts.",
  "version": "1.0.0",
  "type": "prompt-flow",
  "category": "E-Commerce / Live Commerce",
  "keywords": [
    "live commerce", "直播带货", "直播话术", "sales script",
    "live selling", "抖音直播", "快手直播", "淘宝直播",
    "flash sale", "audience engagement", "anchor script"
  ],
  "platforms": ["抖音直播", "快手直播", "Taobao Live", "General Live Streaming"],
  "requires": {},
  "requires_api": false,
  "author": "harrylabsj",
  "license": "MIT",
  "safety": {
    "no_code_execution": true,
    "no_network": true,
    "no_credentials": true,
    "compliance_notes": "No false scarcity (e.g., fake 'only 3 left'). No fabricated price anchors or fake original prices. No pressure tactics targeting vulnerable consumers. Must disclose actual stock levels and limitations. Comply with live commerce platform regulations."
  }
}

# Douyin Short Video Script Studio

## Purpose

This skill generates structured oral presentation scripts for Douyin (抖音 / TikTok CN) short videos. It specializes in hook-driven openings (0–3 second grab), timed content beats, visual cue suggestions, BGM mood guidance, and transition scripting. "Studio" means a complete toolkit — from brief to shoot-ready script with timing, not just flat text. Best used when you need a Douyin video that converts attention into retention, with every second engineered for the platform's algorithm and viewer behavior.

## Triggers

- "写抖音脚本"
- "抖音口播"
- "短视频脚本"
- "抖音 hook"
- "抖音 storyboard"
- "douyin script"
- "抖音文案"
- "Douyin video script"
- "口播稿"
- "抖音分镜脚本"

## Workflow

1. Receive product/topic brief from user: product name, category, key message, target audience, desired video style/tone, and video length (15s, 30s, or 60s).
2. Determine the optimal script structure based on length:
   - 15s: Single-hook, single-point, hard CTA
   - 30s: Hook → Problem/Context → Solution/Reveal → CTA
   - 60s: Hook → Story/Proof → Deep Dive → Social Proof → CTA
3. Generate 3–5 opening hook variants optimized for 0–3 second retention (visual + verbal).
4. Structure body beats with estimated timing per segment (e.g., 0–3s hook, 3–8s setup, 8–20s core message).
5. Add visual cues for each beat: shot type (close-up, product detail, face-to-camera), motion direction, text overlay suggestions, and transition type (cut, zoom, swipe).
6. Suggest BGM mood and tempo (upbeat, emotional, trending, lo-fi) matched to content energy.
7. Write the closing CTA optimized for Douyin algorithm engagement: like, follow, comment prompt, or purchase link.
8. Include safety disclaimer and compliance review for commercial content.

## Prompt Templates

### 1. Script from Brief (`script_from_brief`)

**Purpose:** Generate a complete timed Douyin oral script from a product/topic brief.

**Input:**
- `product_name` — Product or topic name
- `category` — Niche (beauty, tech, food, lifestyle, education, fitness)
- `key_message` — The single most important point to communicate
- `target_audience` — Who the video is for (age, interest, pain point)
- `video_length` — 15s, 30s, or 60s
- `tone` — Style (energetic, calm, humorous, authoritative, relatable)
- `cta_goal` — Desired action (follow, like, comment, buy, download)

**Output:** Full timed script with:
- Timestamped beats (0–3s, 3–8s, etc.)
- Spoken lines (口播文案)
- Visual cues per beat (shot, motion, text overlay)
- BGM mood suggestion
- Final CTA line

### 2. Hook Library (`hook_library`)

**Purpose:** Generate 5 opening hook variants for a product or topic.

**Input:**
- `product_name` — Product or topic
- `hook_type` — Optional preference (curiosity, pain point, surprise, story, number/list)
- `target_audience` — Audience descriptor

**Output:** 5 hook options, each with:
- Verbal hook (first 1–2 sentences)
- Visual direction (what to show in 0–3s)
- Why it works (psychology rationale)
- Best fit scenario

### 3. Storyboard Outline (`storyboard_outline`)

**Purpose:** Convert a script brief into a 3-scene visual storyboard outline.

**Input:**
- `product_name` — Product/topic
- `scene_count` — 3 or 5 scenes
- `style` — Visual style (clean, lifestyle, demo, testimonial, Vlog)

**Output:** Scene-by-scene breakdown:
- Scene number + timestamp range
- Shot description (angle, distance, subject)
- On-screen text overlay suggestions
- Audio notes (voiceover vs. music vs. silence)
- Transition to next scene

### 4. Trending Angle Adapter (`trending_angle_adapter`)

**Purpose:** Adapt a product/topic to a current Douyin trending format or challenge style.

**Input:**
- `product_name` — Product/topic
- `trend_format` — Trending format (e.g., "before vs after", "day in the life", "myth busting", "POV", "trending sound rewrite")
- `original_script` — (Optional) Existing script to adapt

**Output:** Adapted script/outline that fits the trending format while preserving the core product message, with notes on how to make it feel native to the trend rather than forced.

### 5. Script Optimizer (`script_optimizer`)

**Purpose:** Improve an existing Douyin script for retention, clarity, and conversion.

**Input:**
- `draft_script` — User's existing script or outline
- `optimization_goal` — Primary goal (retention, clarity, conversion, humor, pacing)
- `video_length` — Target length

**Output:** Optimized script with:
- Redlined changes (what changed and why)
- Timing adjustments
- Stronger hook alternatives
- Visual enhancement suggestions
- Pacing notes (where to speed up, where to pause)

## Output Format

All script outputs follow a structured studio format:

```
## Douyin Script: [Product/Topic]
**Length:** [15s / 30s / 60s] | **Tone:** [Tone] | **CTA Goal:** [Goal]

### Beat 1 — Hook (0–3s)
- **Script:** [Spoken line]
- **Visual:** [Shot type + motion + text overlay]
- **Audio:** [BGM mood / sound effect]

### Beat 2 — [Segment Name] (3–8s)
...

### Closing — CTA (final 3s)
- **Script:** [CTA line]
- **Visual:** [End card / product shot / follow prompt]
- **Audio:** [Music swell / silence for impact]
```

Additional outputs provided as needed:
- **Hook variants:** Bulleted list with rationale
- **Storyboard:** Table format (Scene | Time | Shot | Text | Audio | Transition)
- **Optimization notes:** Before/After comparison with reasoning

## Safety Rules

- **NEVER** generate false product efficacy claims or misleading before/after transformations
- **NEVER** suggest dangerous challenges, risky behaviors, or harmful stunts for views
- **NEVER** create scripts that impersonate real individuals without disclosure
- **ALWAYS** include explicit disclosure language for sponsored or commercial content (e.g., "本条内容为合作推广" or "#ad")
- **ALWAYS** respect Douyin content review policies — no prohibited products, medical claims, or deceptive practices
- **ALWAYS** remind the user to review and fact-check AI-generated scripts before filming and publishing
- **ALWAYS** ensure visual cues and suggested actions comply with platform safety guidelines

## Examples

### Example 1: Script from Brief (Skincare, 30s)

**Input:** Product="XX 维C精华", Category="beauty", Key Message="7天提亮肤色", Audience="20-30岁熬夜女性", Length="30s", Tone="energetic", CTA Goal="buy"

**Output:**
- Beat 1 (0–3s): Hook — "熬夜脸有救了！" + close-up of tired face → brightened face transition
- Beat 2 (3–10s): Problem — "凌晨2点睡，早上暗沉到不敢照镜子" + lifestyle shot
- Beat 3 (10–22s): Solution — "这瓶维C精华，7天提亮不是玄学" + product demo + ingredient text overlay
- Beat 4 (22–30s): CTA — "链接在左下角，现在下单立减30" + end card with price

### Example 2: Hook Library (Same Product)

**Input:** Product="XX 维C精华", Hook Type="curiosity", Audience="20-30岁女性"

**Output:** 5 hooks:
1. "我用了7天，同事问我是不是去做医美了" (surprise + social proof)
2. "这瓶精华的维C浓度，我算了3遍才敢相信" (curiosity + number)
3. "熬夜到凌晨2点，我的脸居然比以前还亮" (contrast + relatability)
4. "皮肤科朋友偷偷告诉我，提亮根本不需要贵" (insider + value)
5. "别再花冤枉钱！提亮肤色，这一瓶够了" (direct + authority)

### Example 3: Storyboard Outline (Tech Gadget, 5 scenes)

**Input:** Product="便携投影仪", Style="lifestyle"

**Output:** 5-scene storyboard from unboxing → bedroom setup → movie night → portability demo → CTA end card.

## Related Skills

- [live-selling-script-kit](../live-selling-script-kit/) — For live-streaming sales scripts when your Douyin video drives to a live room
- [ad-copy-ab-tester](../ad-copy-ab-tester/) — For testing Douyin ad creative copy derived from these scripts
- [landing-page-copy-pro](../landing-page-copy-pro/) — For landing page copy when your Douyin CTA drives traffic to a conversion page

FILE:ACCEPTANCE.md
# Acceptance Criteria — Douyin Short Video Script Studio

- [ ] SKILL.md is self-contained (agent can operate from it alone)
- [ ] All 5 prompt templates are complete with `placeholder` inputs
- [ ] Safety rules are explicit and actionable (NEVER/ALWAYS format)
- [ ] README.md has clear install instructions + 3 usage examples
- [ ] skill.json is valid JSON with all required fields, `requires_api: false`
- [ ] Content is unique — no duplication with other skills in this pack (focus on timed video beats, visual cues, and BGM mood)
- [ ] Slugs follow naming convention (user-facing, no prefix codes)
- [ ] Hook library and storyboard outline features are differentiated from viral-xiaohongshu-notes (video scripts vs. text notes)

FILE:README.md
# Douyin Short Video Script Studio

Structured oral presentation scripts for Douyin (抖音) short videos — engineered for 0–3s hooks, timed beats, and shoot-ready production.

## Features

- Generate complete timed scripts from briefs (15s / 30s / 60s)
- Hook library: 5 opening variants with psychology rationale
- Storyboard outlines with shot types, text overlays, and transitions
- Trending angle adapter: fit your product into current Douyin formats
- Script optimizer: improve existing drafts for retention and conversion
- Visual cues and BGM mood guidance per beat

## Install

```
openclaw skills install harrylabsj/douyin-script-studio
```

## Usage

```
帮我写一个30秒的抖音口播脚本，产品是XX维C精华，主打7天提亮，面向20-30岁熬夜女性，语气活泼，目标是下单
给我5个抖音视频开头hook，产品是便携投影仪，面向租房年轻人
把这个脚本改成"Day in the life"的抖音热门形式
帮我优化这个抖音脚本的节奏和转化
```

## Platforms

抖音 (Douyin / TikTok CN)

## Safety

No false efficacy claims. No misleading before/after. No dangerous challenges. All commercial content includes sponsorship disclosure. Always review scripts before filming.

## License

MIT

FILE:skill.json
{
  "name": "Douyin Short Video Script Studio",
  "description": "Structured Douyin oral script generation with hook-driven openings (0-3s grab), timed content beats, visual cues, BGM mood guidance, and transition scripting for short video creators.",
  "version": "1.0.0",
  "type": "prompt-flow",
  "category": "Social Media Content / Platform-Specific",
  "keywords": [
    "douyin", "抖音", "抖音脚本", "口播脚本", "short video script",
    "opening hook", "storyboard", "trending", "抖音文案",
    "video script", "creator toolkit"
  ],
  "platforms": ["抖音 (Douyin / TikTok CN)"],
  "requires": {},
  "requires_api": false,
  "author": "harrylabsj",
  "license": "MIT",
  "safety": {
    "no_code_execution": true,
    "no_network": true,
    "no_credentials": true,
    "compliance_notes": "No false product efficacy claims. No misleading before/after transformations. Explicit disclosure of commercial/sponsored content. No dangerous challenge or behavior suggestions. Respect Douyin content review policies."
  }
}

# Viral Xiaohongshu Note Writer

## Purpose

This skill generates Xiaohongshu (小红书 / RED) platform-native notes optimized for virality. It creates "种草" (grass-planting / product recommendation) content with cover text design strategy, niche hashtag stacking, authentic personal-experience tone, product placement angles, and platform-unique aesthetic formatting. Best used when you have a product or service to promote and need a note that feels organic, engaging, and platform-appropriate — but still delivers commercial value.

## Triggers

- "写小红书笔记"
- "生成种草文案"
- "小红书 cover"
- "小红书 hashtag"
- "种草角度"
- "小红书改写"
- "viral xiaohongshu note"
- "xhs note writer"
- "RED note generator"
- "小红书内容创作"

## Workflow

1. Receive product information from user (product name, category, key features, price, target audience, and optional existing draft).
2. Identify niche: beauty, fashion, travel, food, home, parenting, or general lifestyle.
3. Structure the note using the Xiaohongshu native format: hook → personal experience → product reveal → usage tips → purchase guidance.
4. Insert emoji rhythm, line breaks, and section headers following Xiaohongshu aesthetic conventions.
5. Generate 3–5 niche-specific hashtags plus 2–3 trending tags for discoverability.
6. Provide 3–5 cover text options that match the note angle.
7. Include safety disclaimer reminding user to disclose commercial relationships.

## Prompt Templates

### 1. Note from Brief (`note_from_brief`)

**Purpose:** Generate a complete Xiaohongshu note from product information.

**Input:**
- `product_name` — Name of the product
- `category` — Niche (beauty/fashion/travel/food/home/parenting)
- `key_features` — 2–4 main selling points
- `target_audience` — Who this product is for
- `price_range` — Optional price context
- `angle` — Optional content angle (e.g., "成分党", "学生党", "干货分享")

**Output:** Full note with hook paragraph, personal experience narrative, product reveal, usage tips, purchase guidance, hashtags, and 3 cover text options.

### 2. Cover Title Generator (`cover_title_generator`)

**Purpose:** Generate cover image text options that drive clicks.

**Input:**
- `product_name` — Product name
- `angle` — Content angle
- `target_audience` — Audience descriptor

**Output:** 5 cover title options, each with a rationale for why it works for the given product and audience.

### 3. Hashtag Strategy (`hashtag_strategy`)

**Purpose:** Create a balanced hashtag set for maximum discoverability.

**Input:**
- `product_category` — Category (e.g., 面膜, 穿搭, 旅行)
- `niche_keywords` — 2–3 niche-specific keywords
- `trending_context` — Optional current trending topics or seasons

**Output:** 3–5 niche hashtags (targeting specific interest groups) + 2–3 trending hashtags (for broader reach) + hashtag volume tier labeling.

### 4. Angle Switcher (`angle_switcher`)

**Purpose:** Generate 3 different content angles for the same product.

**Input:**
- `product_name` — Product name
- `key_features` — Key features
- `audience_segments` — 2–3 possible audience types

**Output:** 3 distinct note outlines, each from a different angle (e.g., 成分分析, 使用前后对比, 开箱体验), with hook and hashtag recommendations per angle.

### 5. Note Polish/Rewrite (`note_rewrite`)

**Purpose:** Optimize an existing draft for Xiaohongshu engagement.

**Input:**
- `draft_content` — User's existing note draft
- `optimization_goal` — What to improve (engagement/readability/SEO)

**Output:** Polished version with improved hook, emoji rhythm, formatting, hashtags, and cover text suggestions.

## Output Format

All outputs follow Xiaohongshu's native platform styling:
- Short paragraphs (1–3 sentences each)
- Emoji used deliberately for emphasis and section breaks
- Hashtags appended at the bottom
- Cover text options provided separately as a numbered list
- Character count within platform limits (~1000 characters)

## Safety Rules

- **NEVER** generate fake reviews, fabricated user experiences, or misleading testimonials
- **NEVER** make unverified product efficacy claims (especially skincare, health, or wellness)
- **NEVER** include medical/health claims without qualification (e.g., "FDA-registered" or "dermatologist-tested" only if verifiable)
- **ALWAYS** prompt the user to disclose sponsored or commercial relationships per Xiaohongshu guidelines
- **ALWAYS** respect Xiaohongshu community guidelines — no prohibited products or content
- **ALWAYS** remind the user to review and fact-check AI-generated content before publishing

## Examples

### Example 1: Note from Brief (Skincare)

**Input:** Product = "XX 玻尿酸保湿面霜", Price = "299元", Features = "三重玻尿酸、敏感肌可用、24小时保湿", Audience = "25-35岁女性", Angle = "成分党"

**Output:** A full note with hook about winter skincare struggles, personal experience with dry skin, product reveal with ingredient breakdown (triple hyaluronic acid), usage tips (apply on damp skin), and hashtags like #玻尿酸面霜 #保湿面霜推荐 #干皮救星 #成分党 skincare.

### Example 2: Angle Switcher (Same Product)

**Input:** Same product as above, audience segments = {成分党, 学生党, 宝妈}

**Output:** Three outlines: (1) 成分分析 deep-dive, (2) 平价好物 budget-friendly angle, (3) 新手护肤 routine integration angle.

## Related Skills

- [social-caption-kit](../social-caption-kit/) — For multi-platform repurposing of the same content
- [product-title-booster](../product-title-booster/) — For optimizing the product's listing title to match the note
- [review-reply-coach](../review-reply-coach/) — For responding to comments and reviews on the note

FILE:ACCEPTANCE.md
# Acceptance Criteria — Viral Xiaohongshu Note Writer

- [ ] SKILL.md is self-contained (agent can operate from it alone)
- [ ] All 5 prompt templates are complete with `placeholder` inputs
- [ ] Safety rules are explicit and actionable (NEVER/ALWAYS format)
- [ ] README.md has clear install instructions + 3 usage examples
- [ ] skill.json is valid JSON with all required fields
- [ ] Content is unique — no duplication with other skills in this pack (focus on Xiaohongshu-native 种草 format)
- [ ] Slugs follow naming convention (user-facing, no prefix codes)
- [ ] Cover text generator, hashtag strategy, and angle switcher features differentiated from social-caption-kit

FILE:README.md
# Viral Xiaohongshu Note Writer

Create authentic, engaging Xiaohongshu (RED) notes optimized for virality and platform-native aesthetics.

## Features

- Generate complete notes from product briefs with native 种草 tone
- Craft click-optimized cover text options for your images
- Build balanced hashtag strategies (niche + trending)
- Explore multiple content angles for the same product
- Polish and rewrite existing drafts for better engagement
- Emoji rhythm, line breaks, and Xiaohongshu-native formatting

## Install

```
openclaw skills install harrylabsj/viral-xiaohongshu-notes
```

## Usage

```
写一篇小红书笔记，产品是XX面霜，299元，主打保湿和修护，面向25-35岁女性，成分党角度
帮我生成5个小红书封面标题，产品是便携咖啡机，面向职场白领
给我3个不同的种草角度写同一款洁面产品
帮我优化这篇小红书笔记的标题和hashtag
```

## Platforms

小红书 (Xiaohongshu / RED)

## Safety

This skill does not generate fake reviews or fabricated user experiences. All outputs include reminders to disclose commercial relationships per platform guidelines. Always review AI-generated content before publishing.

## License

MIT

FILE:skill.json
{
  "name": "Viral Xiaohongshu Note Writer",
  "description": "Generate viral-style Xiaohongshu (RED) notes with cover text, niche hashtag strategy, authentic 种草 tone, and platform-optimized formatting for beauty, fashion, travel, food, home, and parenting niches.",
  "version": "1.0.0",
  "type": "prompt-flow",
  "category": "Social Media Content / Platform-Specific",
  "keywords": [
    "xiaohongshu", "小红书", "种草文案", "小红书笔记", "RED note",
    "cover text", "hashtag strategy", "viral content", "种草",
    "product recommendation", "beauty note", "fashion note"
  ],
  "platforms": ["小红书 (Xiaohongshu / RED)"],
  "requires": {},
  "requires_api": false,
  "author": "harrylabsj",
  "license": "MIT",
  "safety": {
    "no_code_execution": true,
    "no_network": true,
    "no_credentials": true,
    "compliance_notes": "No fake reviews or fabricated user experiences. No unverified product efficacy claims. No medical/health claims without qualification. Must prompt user to disclose commercial relationships. Respect Xiaohongshu community guidelines."
  }
}

# Short Video Performance Analytics & Review

Provides a structured framework for reviewing short video performance data — metrics interpretation, insight extraction, and iterative improvement planning.

## Target Users

- Content creators
- Social media managers
- Marketing analysts
- Agency strategists

## When to Use

- Weekly/monthly content performance review
- Diagnosing why a video underperformed
- Identifying patterns across top-performing content
- Building a data-informed content improvement loop

## Core Workflow

1. Metrics hierarchy definition
2. Performance dashboard template
3. Single-video deep-dive framework
4. Comparative analysis (video vs. video, series vs. series, platform vs. platform)
5. Insight-to-action translation
6. Iteration planning

## Inputs

- Performance data (manual entry)
- Video catalog
- Platform
- Review period
- Goals/KPIs

## Expected Outputs

- Review report template
- Single-video analysis framework
- Comparative analysis matrix
- Action plan for next content cycle

## Example Prompts

- "Help me create a weekly performance review framework for my 5 Douyin videos."
- "My latest video has high views but low completion rate — help me diagnose why."
- "Compare my top 3 and bottom 3 videos across the last month and suggest improvements."

## Trigger Keywords

video analytics, performance review, content review, video metrics, analytics framework, improve video

## Safety & Limitations

Analytics framework is process guidance. Does not access, pull, or process platform analytics APIs. All data must be entered manually by the user. Insights are suggestions, not guaranteed improvements. Respect user data privacy.

---

*Generated for project short-video-skills-2026-04-27*

FILE:ACCEPTANCE.md
# Acceptance Checklist — Short Video Performance Analytics & Review

## Criteria

- [x] Document-only: no handler.py, scripts, APIs, or executable code
- [x] No network calls or credential handling
- [x] English-first documentation
- [x] File count ≤ 10 (target: exactly 4)
- [x] Includes safety disclaimer
- [x] skill.json is valid with `requires_api: false`
- [x] No drift from design-spec.md

## Files in This Skill

1. `SKILL.md` — Full workflow, inputs, outputs, examples, safety
2. `README.md` — Quick-start reference
3. `skill.json` — Machine-readable metadata
4. `ACCEPTANCE.md` — This checklist

## Verification Commands

```bash
# Count files in this directory
find /Users/jianghaidong/.openclaw/skills/sv-analytics-review -type f | wc -l
# Expected: 4

# Verify skill.json
cat /Users/jianghaidong/.openclaw/skills/sv-analytics-review/skill.json | grep requires_api
# Expected: "requires_api": false

# Verify no code files
find /Users/jianghaidong/.openclaw/skills/sv-analytics-review -name "*.py" -o -name "*.sh" | wc -l
# Expected: 0
```

---

*Generated for project short-video-skills-2026-04-27*

FILE:README.md
# Short Video Performance Analytics & Review

Provides a structured framework for reviewing short video performance data — metrics interpretation, insight extraction, and iterative improvement planning.

## Target Users

- Content creators
- Social media managers
- Marketing analysts
- Agency strategists

## When to Use

- Weekly/monthly content performance review
- Diagnosing why a video underperformed
- Identifying patterns across top-performing content
- Building a data-informed content improvement loop

## Trigger Keywords

video analytics, performance review, content review, video metrics, analytics framework, improve video

## Full Documentation

See [SKILL.md](./SKILL.md) for complete workflow, inputs, outputs, and examples.

---

*Generated for project short-video-skills-2026-04-27*

FILE:skill.json
{
  "slug": "sv-analytics-review",
  "name": "Short Video Performance Analytics & Review",
  "description": "Provides a structured framework for reviewing short video performance data — metrics interpretation, insight extraction, and iterative improvement planning.",
  "type": "descriptive",
  "requires_api": false,
  "readiness": "stable",
  "tags": [
    "video",
    "analytics",
    "review",
    "performance",
    "optimization",
    "descriptive"
  ],
  "trigger_keywords": [
    "video analytics",
    "performance review",
    "content review",
    "video metrics",
    "analytics framework",
    "improve video"
  ],
  "max_files": 4,
  "language": "en",
  "safety": "document-only informational guidance"
}

# Short Video SEO & Hashtag Guide

Guides video SEO strategy — keyword research, hashtag selection, search-optimized descriptions, and discoverability tactics for short video platforms.

## Target Users

- Content creators
- SEO specialists
- Social media managers
- Growth marketers

## When to Use

- Improving organic reach of videos
- Researching hashtags for a new content niche
- Building a reusable hashtag set for a channel
- Aligning content with platform search trends

## Core Workflow

1. Video SEO fundamentals for short-video platforms
2. Keyword research methodology
3. Hashtag strategy (volume tiering)
4. Description optimization for search
5. Topic clustering and content-series SEO
6. Hashtag performance review framework

## Inputs

- Video niche
- Target platform(s)
- Target keywords
- Competitor references
- Brand hashtags

## Expected Outputs

- Keyword map
- Hashtag set by tier
- Description template with SEO annotations
- Topic cluster plan
- Performance review checklist

## Example Prompts

- "Build a hashtag strategy for a new Douyin fitness channel targeting Chinese women 20–30."
- "Research keywords and hashtags for 'home organization' content on Xiaohongshu."
- "Optimize my video description for Douyin search on the topic 'study with me.'"

## Trigger Keywords

video SEO, hashtag strategy, keyword research, video discoverability, Douyin SEO, hashtag guide

## Safety & Limitations

SEO guidance is strategic. Does not automate keyword research, rank tracking, or platform data scraping. Hashtag policies vary; users should comply with platform terms.

---

*Generated for project short-video-skills-2026-04-27*

FILE:ACCEPTANCE.md
# Acceptance Checklist — Short Video SEO & Hashtag Guide

## Criteria

- [x] Document-only: no handler.py, scripts, APIs, or executable code
- [x] No network calls or credential handling
- [x] English-first documentation
- [x] File count ≤ 10 (target: exactly 4)
- [x] Includes safety disclaimer
- [x] skill.json is valid with `requires_api: false`
- [x] No drift from design-spec.md

## Files in This Skill

1. `SKILL.md` — Full workflow, inputs, outputs, examples, safety
2. `README.md` — Quick-start reference
3. `skill.json` — Machine-readable metadata
4. `ACCEPTANCE.md` — This checklist

## Verification Commands

```bash
# Count files in this directory
find /Users/jianghaidong/.openclaw/skills/sv-seo-hashtag -type f | wc -l
# Expected: 4

# Verify skill.json
cat /Users/jianghaidong/.openclaw/skills/sv-seo-hashtag/skill.json | grep requires_api
# Expected: "requires_api": false

# Verify no code files
find /Users/jianghaidong/.openclaw/skills/sv-seo-hashtag -name "*.py" -o -name "*.sh" | wc -l
# Expected: 0
```

---

*Generated for project short-video-skills-2026-04-27*

FILE:README.md
# Short Video SEO & Hashtag Guide

Guides video SEO strategy — keyword research, hashtag selection, search-optimized descriptions, and discoverability tactics for short video platforms.

## Target Users

- Content creators
- SEO specialists
- Social media managers
- Growth marketers

## When to Use

- Improving organic reach of videos
- Researching hashtags for a new content niche
- Building a reusable hashtag set for a channel
- Aligning content with platform search trends

## Trigger Keywords

video SEO, hashtag strategy, keyword research, video discoverability, Douyin SEO, hashtag guide

## Full Documentation

See [SKILL.md](./SKILL.md) for complete workflow, inputs, outputs, and examples.

---

*Generated for project short-video-skills-2026-04-27*

FILE:skill.json
{
  "slug": "sv-seo-hashtag",
  "name": "Short Video SEO & Hashtag Guide",
  "description": "Guides video SEO strategy — keyword research, hashtag selection, search-optimized descriptions, and discoverability tactics for short video platforms.",
  "type": "descriptive",
  "requires_api": false,
  "readiness": "stable",
  "tags": [
    "video",
    "SEO",
    "hashtag",
    "discovery",
    "keywords",
    "growth",
    "descriptive"
  ],
  "trigger_keywords": [
    "video SEO",
    "hashtag strategy",
    "keyword research",
    "video discoverability",
    "Douyin SEO",
    "hashtag guide"
  ],
  "max_files": 4,
  "language": "en",
  "safety": "document-only informational guidance"
}

# Short Video Platform Publishing Strategy

Provides platform-specific publishing guidance — optimal timing, format requirements, cross-platform adaptation, and launch sequencing for short videos.

## Target Users

- Content creators
- Social media managers
- Multi-platform publishers
- Marketing teams

## When to Use

- Launching content across multiple platforms
- Deciding which platform to prioritize
- Adapting one video for different platforms
- Planning a coordinated multi-platform release

## Core Workflow

1. Platform selection matrix
2. Format adaptation guide
3. Optimal posting time guide
4. Cross-platform launch sequencing
5. Platform-specific content policy checklist
6. Engagement priming

## Inputs

- Video asset(s)
- Target platforms
- Audience demographics
- Launch goals
- Brand exclusivity constraints

## Expected Outputs

- Platform priority matrix
- Posting schedule with time zones
- Format adaptation checklist
- Launch sequence plan
- Policy compliance checklist

## Example Prompts

- "I have one 60-second video — plan its launch across Douyin, Xiaohongshu, and WeChat Channels."
- "What's the best posting time for Douyin targeting Chinese office workers aged 25–35?"
- "Help me adapt a vertical short video for both Douyin and horizontal YouTube Shorts."

## Trigger Keywords

publishing strategy, cross-platform, Douyin timing, video distribution, multi-platform, platform launch

## Safety & Limitations

Publishing strategy is guidance. Does not post, schedule, or automate publishing. Platform policies change; users should verify current requirements. Music licensing is user's responsibility.

---

*Generated for project short-video-skills-2026-04-27*

FILE:ACCEPTANCE.md
# Acceptance Checklist — Short Video Platform Publishing Strategy

## Criteria

- [x] Document-only: no handler.py, scripts, APIs, or executable code
- [x] No network calls or credential handling
- [x] English-first documentation
- [x] File count ≤ 10 (target: exactly 4)
- [x] Includes safety disclaimer
- [x] skill.json is valid with `requires_api: false`
- [x] No drift from design-spec.md

## Files in This Skill

1. `SKILL.md` — Full workflow, inputs, outputs, examples, safety
2. `README.md` — Quick-start reference
3. `skill.json` — Machine-readable metadata
4. `ACCEPTANCE.md` — This checklist

## Verification Commands

```bash
# Count files in this directory
find /Users/jianghaidong/.openclaw/skills/sv-platform-strategy -type f | wc -l
# Expected: 4

# Verify skill.json
cat /Users/jianghaidong/.openclaw/skills/sv-platform-strategy/skill.json | grep requires_api
# Expected: "requires_api": false

# Verify no code files
find /Users/jianghaidong/.openclaw/skills/sv-platform-strategy -name "*.py" -o -name "*.sh" | wc -l
# Expected: 0
```

---

*Generated for project short-video-skills-2026-04-27*

FILE:README.md
# Short Video Platform Publishing Strategy

Provides platform-specific publishing guidance — optimal timing, format requirements, cross-platform adaptation, and launch sequencing for short videos.

## Target Users

- Content creators
- Social media managers
- Multi-platform publishers
- Marketing teams

## When to Use

- Launching content across multiple platforms
- Deciding which platform to prioritize
- Adapting one video for different platforms
- Planning a coordinated multi-platform release

## Trigger Keywords

publishing strategy, cross-platform, Douyin timing, video distribution, multi-platform, platform launch

## Full Documentation

See [SKILL.md](./SKILL.md) for complete workflow, inputs, outputs, and examples.

---

*Generated for project short-video-skills-2026-04-27*

FILE:skill.json
{
  "slug": "sv-platform-strategy",
  "name": "Short Video Platform Publishing Strategy",
  "description": "Provides platform-specific publishing guidance — optimal timing, format requirements, cross-platform adaptation, and launch sequencing for short videos.",
  "type": "descriptive",
  "requires_api": false,
  "readiness": "stable",
  "tags": [
    "video",
    "publishing",
    "platform",
    "distribution",
    "strategy",
    "descriptive"
  ],
  "trigger_keywords": [
    "publishing strategy",
    "cross-platform",
    "Douyin timing",
    "video distribution",
    "multi-platform",
    "platform launch"
  ],
  "max_files": 4,
  "language": "en",
  "safety": "document-only informational guidance"
}

# Short Video Editing Workflow Planner

Defines structured editing workflows — from ingest to export — with decision points for cuts, pacing, effects, and quality checks for short video.

## Target Users

- Video editors
- Content creators
- Post-production teams
- Beginner editors

## When to Use

- Streamlining editing process for batch content
- Training new editors on workflow
- Reducing editing time for high-volume output
- Ensuring consistency across a video series

## Core Workflow

1. Media ingest and organization
2. Rough cut assembly
3. Fine cut (pacing, trimming, J-cuts, L-cuts)
4. Effects and enhancement layer
5. Review and revision cycle
6. Export settings guide by platform

## Inputs

- Raw footage description
- Target platform(s)
- Desired style
- Editing software
- Output requirements

## Expected Outputs

- Step-by-step editing workflow
- Timeline organization template
- Export settings cheat sheet
- Quality-check checklist

## Example Prompts

- "Design an editing workflow for daily 60-second Douyin videos — I need to edit fast."
- "Create a post-production workflow for a 5-person editing team on a weekly short video series."
- "What's the most efficient editing workflow for batch-producing 10 talking-head videos?"

## Trigger Keywords

editing workflow, video editing process, post-production, editing pipeline, export settings, timeline organization

## Safety & Limitations

Workflow guidance is process-oriented. Does not operate or automate editing software. Export settings are recommendations; users should verify with platform guidelines.

---

*Generated for project short-video-skills-2026-04-27*

FILE:ACCEPTANCE.md
# Acceptance Checklist — Short Video Editing Workflow Planner

## Criteria

- [x] Document-only: no handler.py, scripts, APIs, or executable code
- [x] No network calls or credential handling
- [x] English-first documentation
- [x] File count ≤ 10 (target: exactly 4)
- [x] Includes safety disclaimer
- [x] skill.json is valid with `requires_api: false`
- [x] No drift from design-spec.md

## Files in This Skill

1. `SKILL.md` — Full workflow, inputs, outputs, examples, safety
2. `README.md` — Quick-start reference
3. `skill.json` — Machine-readable metadata
4. `ACCEPTANCE.md` — This checklist

## Verification Commands

```bash
# Count files in this directory
find /Users/jianghaidong/.openclaw/skills/sv-editing-workflow -type f | wc -l
# Expected: 4

# Verify skill.json
cat /Users/jianghaidong/.openclaw/skills/sv-editing-workflow/skill.json | grep requires_api
# Expected: "requires_api": false

# Verify no code files
find /Users/jianghaidong/.openclaw/skills/sv-editing-workflow -name "*.py" -o -name "*.sh" | wc -l
# Expected: 0
```

---

*Generated for project short-video-skills-2026-04-27*

FILE:README.md
# Short Video Editing Workflow Planner

Defines structured editing workflows — from ingest to export — with decision points for cuts, pacing, effects, and quality checks for short video.

## Target Users

- Video editors
- Content creators
- Post-production teams
- Beginner editors

## When to Use

- Streamlining editing process for batch content
- Training new editors on workflow
- Reducing editing time for high-volume output
- Ensuring consistency across a video series

## Trigger Keywords

editing workflow, video editing process, post-production, editing pipeline, export settings, timeline organization

## Full Documentation

See [SKILL.md](./SKILL.md) for complete workflow, inputs, outputs, and examples.

---

*Generated for project short-video-skills-2026-04-27*

FILE:skill.json
{
  "slug": "sv-editing-workflow",
  "name": "Short Video Editing Workflow Planner",
  "description": "Defines structured editing workflows — from ingest to export — with decision points for cuts, pacing, effects, and quality checks for short video.",
  "type": "descriptive",
  "requires_api": false,
  "readiness": "stable",
  "tags": [
    "video",
    "editing",
    "workflow",
    "post-production",
    "efficiency",
    "descriptive"
  ],
  "trigger_keywords": [
    "editing workflow",
    "video editing process",
    "post-production",
    "editing pipeline",
    "export settings",
    "timeline organization"
  ],
  "max_files": 4,
  "language": "en",
  "safety": "document-only informational guidance"
}

# Short Video Filming Preparation Checklist

A comprehensive pre-shoot checklist covering equipment, location, talent, wardrobe, props, permissions, and contingency planning.

## Target Users

- Content creators
- Video production teams
- Solo shooters
- Agency producers

## When to Use

- Preparing for any video shoot day
- Avoiding forgotten equipment or props
- Managing multi-location shoots
- Onboarding new production team members

## Core Workflow

1. Pre-shoot planning
2. Equipment checklist
3. Location checklist
4. Talent & wardrobe checklist
5. Shot-day run sheet template
6. Contingency planning

## Inputs

- Shoot type
- Location details
- Equipment inventory
- Talent details
- Expected duration

## Expected Outputs

- Customized pre-shoot checklist
- Equipment packing list
- Location scout notes template
- Contingency plan template

## Example Prompts

- "Create a filming day checklist for a solo creator shooting a cooking video at home."
- "Build a pre-shoot checklist for an outdoor brand video with two locations and one talent."
- "What's in a complete equipment packing list for a travel vlog shoot?"

## Trigger Keywords

filming checklist, shoot prep, video preparation, shoot day, equipment checklist, pre-shoot

## Safety & Limitations

Checklists are organizational aids. Does not guarantee shoot success or cover all possible contingencies. Location safety, permits, and insurance are the user's responsibility.

---

*Generated for project short-video-skills-2026-04-27*

FILE:skill.json
{
  "slug": "sv-filming-checklist",
  "name": "Short Video Filming Preparation Checklist",
  "description": "A comprehensive pre-shoot checklist covering equipment, location, talent, wardrobe, props, permissions, and contingency planning.",
  "type": "descriptive",
  "requires_api": false,
  "readiness": "stable",
  "tags": [
    "video",
    "checklist",
    "preparation",
    "filming",
    "production",
    "descriptive"
  ],
  "trigger_keywords": [
    "filming checklist",
    "shoot prep",
    "video preparation",
    "shoot day",
    "equipment checklist",
    "pre-shoot"
  ],
  "max_files": 4,
  "language": "en",
  "safety": "document-only informational guidance"
}

FILE:README.md
# Short Video Filming Preparation Checklist

A comprehensive pre-shoot checklist covering equipment, location, talent, wardrobe, props, permissions, and contingency planning.

## Target Users

- Content creators
- Video production teams
- Solo shooters
- Agency producers

## When to Use

- Preparing for any video shoot day
- Avoiding forgotten equipment or props
- Managing multi-location shoots
- Onboarding new production team members

## Trigger Keywords

filming checklist, shoot prep, video preparation, shoot day, equipment checklist, pre-shoot

## Full Documentation

See [SKILL.md](./SKILL.md) for complete workflow, inputs, outputs, and examples.

---

*Generated for project short-video-skills-2026-04-27*

FILE:ACCEPTANCE.md
# Acceptance Checklist — Short Video Filming Preparation Checklist

## Criteria

- [x] Document-only: no handler.py, scripts, APIs, or executable code
- [x] No network calls or credential handling
- [x] English-first documentation
- [x] File count ≤ 10 (target: exactly 4)
- [x] Includes safety disclaimer
- [x] skill.json is valid with `requires_api: false`
- [x] No drift from design-spec.md

## Files in This Skill

1. `SKILL.md` — Full workflow, inputs, outputs, examples, safety
2. `README.md` — Quick-start reference
3. `skill.json` — Machine-readable metadata
4. `ACCEPTANCE.md` — This checklist

## Verification Commands

```bash
# Count files in this directory
find /Users/jianghaidong/.openclaw/skills/sv-filming-checklist -type f | wc -l
# Expected: 4

# Verify skill.json
cat /Users/jianghaidong/.openclaw/skills/sv-filming-checklist/skill.json | grep requires_api
# Expected: "requires_api": false

# Verify no code files
find /Users/jianghaidong/.openclaw/skills/sv-filming-checklist -name "*.py" -o -name "*.sh" | wc -l
# Expected: 0
```

---

*Generated for project short-video-skills-2026-04-27*

# Short Video Audio Recording Guide

Covers microphone selection, recording environment optimization, level setting, and audio troubleshooting for short video production.

## Target Users

- Content creators
- Vloggers
- Interviewers
- Solo shooters
- Podcast-to-video creators

## When to Use

- Selecting a microphone for specific content types
- Solving audio quality issues
- Setting up audio for different shooting scenarios
- Recording clean voiceover separately

## Core Workflow

1. Microphone type selection guide
2. Recording environment optimization
3. Gain staging and level setting basics
4. Scenario-specific audio plans
5. Audio monitoring and troubleshooting checklist
6. Sync considerations (separate audio + video)

## Inputs

- Shooting scenario
- Available equipment
- Content type
- Recording environment
- Budget level

## Expected Outputs

- Microphone recommendation by scenario
- Recording setup diagram description
- Level-setting checklist
- Troubleshooting guide

## Example Prompts

- "What microphone should I use for outdoor vlogging on a windy day?"
- "My indoor recordings echo — how do I fix this without buying acoustic panels?"
- "Guide me through recording clean voiceover with my phone for a faceless video."

## Trigger Keywords

audio recording, microphone guide, video sound, recording setup, audio quality, voice recording

## Safety & Limitations

Audio guidance is educational. Does not control recording equipment. Volume safety: guidance on safe listening levels but not a substitute for professional audio engineering.

---

*Generated for project short-video-skills-2026-04-27*

FILE:skill.json
{
  "slug": "sv-audio-recording",
  "name": "Short Video Audio Recording Guide",
  "description": "Covers microphone selection, recording environment optimization, level setting, and audio troubleshooting for short video production.",
  "type": "descriptive",
  "requires_api": false,
  "readiness": "stable",
  "tags": [
    "video",
    "audio",
    "microphone",
    "recording",
    "sound",
    "descriptive"
  ],
  "trigger_keywords": [
    "audio recording",
    "microphone guide",
    "video sound",
    "recording setup",
    "audio quality",
    "voice recording"
  ],
  "max_files": 4,
  "language": "en",
  "safety": "document-only informational guidance"
}

FILE:README.md
# Short Video Audio Recording Guide

Covers microphone selection, recording environment optimization, level setting, and audio troubleshooting for short video production.

## Target Users

- Content creators
- Vloggers
- Interviewers
- Solo shooters
- Podcast-to-video creators

## When to Use

- Selecting a microphone for specific content types
- Solving audio quality issues
- Setting up audio for different shooting scenarios
- Recording clean voiceover separately

## Trigger Keywords

audio recording, microphone guide, video sound, recording setup, audio quality, voice recording

## Full Documentation

See [SKILL.md](./SKILL.md) for complete workflow, inputs, outputs, and examples.

---

*Generated for project short-video-skills-2026-04-27*

FILE:ACCEPTANCE.md
# Acceptance Checklist — Short Video Audio Recording Guide

## Criteria

- [x] Document-only: no handler.py, scripts, APIs, or executable code
- [x] No network calls or credential handling
- [x] English-first documentation
- [x] File count ≤ 10 (target: exactly 4)
- [x] Includes safety disclaimer
- [x] skill.json is valid with `requires_api: false`
- [x] No drift from design-spec.md

## Files in This Skill

1. `SKILL.md` — Full workflow, inputs, outputs, examples, safety
2. `README.md` — Quick-start reference
3. `skill.json` — Machine-readable metadata
4. `ACCEPTANCE.md` — This checklist

## Verification Commands

```bash
# Count files in this directory
find /Users/jianghaidong/.openclaw/skills/sv-audio-recording -type f | wc -l
# Expected: 4

# Verify skill.json
cat /Users/jianghaidong/.openclaw/skills/sv-audio-recording/skill.json | grep requires_api
# Expected: "requires_api": false

# Verify no code files
find /Users/jianghaidong/.openclaw/skills/sv-audio-recording -name "*.py" -o -name "*.sh" | wc -l
# Expected: 0
```

---

*Generated for project short-video-skills-2026-04-27*

# Short Video Lighting Setup Guide

Provides lighting setup plans — natural and artificial — for short video shooting scenarios from zero-budget to professional.

## Target Users

- Content creators
- Solo shooters
- Home studio operators
- Beginner videographers

## When to Use

- Setting up a home video studio
- Solving common lighting problems
- Planning lighting for different content types
- Working with limited or no equipment

## Core Workflow

1. Lighting scenario assessment
2. Three-point lighting adaptation for short video
3. Natural light optimization
4. Budget-tier lighting setups (ring light, softbox, practical lamps, DIY)
5. Content-type-specific lighting
6. Common lighting mistakes and fixes

## Inputs

- Shooting environment description
- Equipment inventory
- Content type
- Desired mood/look
- Budget level

## Expected Outputs

- Lighting setup plan with diagram description
- Equipment recommendations by tier
- Natural-light schedule
- Troubleshooting checklist

## Example Prompts

- "I shoot talking-head videos in my bedroom with one window — help me set up lighting."
- "Design a lighting plan for a product showcase video shot on a desk — budget under 200 RMB."
- "What's the best lighting approach for outdoor short videos on an overcast day?"

## Trigger Keywords

video lighting, lighting setup, ring light, three-point lighting, natural light video, filming lighting

## Safety & Limitations

Lighting guidance is educational. Does not control lighting equipment. Users should follow electrical safety rules. Heat from continuous lights should be managed carefully.

---

*Generated for project short-video-skills-2026-04-27*

FILE:skill.json
{
  "slug": "sv-lighting-setup",
  "name": "Short Video Lighting Setup Guide",
  "description": "Provides lighting setup plans — natural and artificial — for short video shooting scenarios from zero-budget to professional.",
  "type": "descriptive",
  "requires_api": false,
  "readiness": "stable",
  "tags": [
    "video",
    "lighting",
    "setup",
    "filming",
    "production",
    "descriptive"
  ],
  "trigger_keywords": [
    "video lighting",
    "lighting setup",
    "ring light",
    "three-point lighting",
    "natural light video",
    "filming lighting"
  ],
  "max_files": 4,
  "language": "en",
  "safety": "document-only informational guidance"
}

FILE:README.md
# Short Video Lighting Setup Guide

Provides lighting setup plans — natural and artificial — for short video shooting scenarios from zero-budget to professional.

## Target Users

- Content creators
- Solo shooters
- Home studio operators
- Beginner videographers

## When to Use

- Setting up a home video studio
- Solving common lighting problems
- Planning lighting for different content types
- Working with limited or no equipment

## Trigger Keywords

video lighting, lighting setup, ring light, three-point lighting, natural light video, filming lighting

## Full Documentation

See [SKILL.md](./SKILL.md) for complete workflow, inputs, outputs, and examples.

---

*Generated for project short-video-skills-2026-04-27*

FILE:ACCEPTANCE.md
# Acceptance Checklist — Short Video Lighting Setup Guide

## Criteria

- [x] Document-only: no handler.py, scripts, APIs, or executable code
- [x] No network calls or credential handling
- [x] English-first documentation
- [x] File count ≤ 10 (target: exactly 4)
- [x] Includes safety disclaimer
- [x] skill.json is valid with `requires_api: false`
- [x] No drift from design-spec.md

## Files in This Skill

1. `SKILL.md` — Full workflow, inputs, outputs, examples, safety
2. `README.md` — Quick-start reference
3. `skill.json` — Machine-readable metadata
4. `ACCEPTANCE.md` — This checklist

## Verification Commands

```bash
# Count files in this directory
find /Users/jianghaidong/.openclaw/skills/sv-lighting-setup -type f | wc -l
# Expected: 4

# Verify skill.json
cat /Users/jianghaidong/.openclaw/skills/sv-lighting-setup/skill.json | grep requires_api
# Expected: "requires_api": false

# Verify no code files
find /Users/jianghaidong/.openclaw/skills/sv-lighting-setup -name "*.py" -o -name "*.sh" | wc -l
# Expected: 0
```

---

*Generated for project short-video-skills-2026-04-27*

# Short Video Title & Description Optimizer

Optimizes video titles and descriptions for discoverability, curiosity, and click-through — with platform-specific character limits and keyword strategies.

## Target Users

- Content creators
- SEO-focused marketers
- Social media managers
- Multi-platform publishers

## When to Use

- Writing titles for new videos
- Improving discoverability of underperforming content
- Crafting platform-optimized descriptions
- A/B testing title variations across platforms

## Core Workflow

1. Title formula selection
2. Keyword research guidance
3. Platform-specific constraints
4. Description structure
5. A/B testing framework for titles
6. Localization considerations

## Inputs

- Video topic
- Target platform(s)
- Target keywords
- Brand voice
- Target audience

## Expected Outputs

- 3–5 title variations per platform
- Description template
- Hashtag strategy
- Keyword integration notes

## Example Prompts

- "Optimize the title for my Douyin video: 'How I organize my desk' — target audience: students."
- "Give me 5 title variations for a tech review of the latest iPhone — one for each platform."
- "Write a Douyin description for a cooking tutorial, including hashtag strategy."

## Trigger Keywords

video title, title optimization, description writing, video SEO, hashtag strategy, click-through title

## Safety & Limitations

Title and description guidance is creative. No automated publishing or platform API integration. Users are responsible for compliance with platform content policies and trademark rules.

---

*Generated for project short-video-skills-2026-04-27*

FILE:skill.json
{
  "slug": "sv-title-optimizer",
  "name": "Short Video Title & Description Optimizer",
  "description": "Optimizes video titles and descriptions for discoverability, curiosity, and click-through — with platform-specific character limits and keyword strategies.",
  "type": "descriptive",
  "requires_api": false,
  "readiness": "stable",
  "tags": [
    "video",
    "title",
    "description",
    "SEO",
    "optimization",
    "copywriting",
    "descriptive"
  ],
  "trigger_keywords": [
    "video title",
    "title optimization",
    "description writing",
    "video SEO",
    "hashtag strategy",
    "click-through title"
  ],
  "max_files": 4,
  "language": "en",
  "safety": "document-only informational guidance"
}

FILE:README.md
# Short Video Title & Description Optimizer

Optimizes video titles and descriptions for discoverability, curiosity, and click-through — with platform-specific character limits and keyword strategies.

## Target Users

- Content creators
- SEO-focused marketers
- Social media managers
- Multi-platform publishers

## When to Use

- Writing titles for new videos
- Improving discoverability of underperforming content
- Crafting platform-optimized descriptions
- A/B testing title variations across platforms

## Trigger Keywords

video title, title optimization, description writing, video SEO, hashtag strategy, click-through title

## Full Documentation

See [SKILL.md](./SKILL.md) for complete workflow, inputs, outputs, and examples.

---

*Generated for project short-video-skills-2026-04-27*

FILE:ACCEPTANCE.md
# Acceptance Checklist — Short Video Title & Description Optimizer

## Criteria

- [x] Document-only: no handler.py, scripts, APIs, or executable code
- [x] No network calls or credential handling
- [x] English-first documentation
- [x] File count ≤ 10 (target: exactly 4)
- [x] Includes safety disclaimer
- [x] skill.json is valid with `requires_api: false`
- [x] No drift from design-spec.md

## Files in This Skill

1. `SKILL.md` — Full workflow, inputs, outputs, examples, safety
2. `README.md` — Quick-start reference
3. `skill.json` — Machine-readable metadata
4. `ACCEPTANCE.md` — This checklist

## Verification Commands

```bash
# Count files in this directory
find /Users/jianghaidong/.openclaw/skills/sv-title-optimizer -type f | wc -l
# Expected: 4

# Verify skill.json
cat /Users/jianghaidong/.openclaw/skills/sv-title-optimizer/skill.json | grep requires_api
# Expected: "requires_api": false

# Verify no code files
find /Users/jianghaidong/.openclaw/skills/sv-title-optimizer -name "*.py" -o -name "*.sh" | wc -l
# Expected: 0
```

---

*Generated for project short-video-skills-2026-04-27*

# Short Video Thumbnail & Cover Designer

Guides the design of high-click-through video covers/thumbnails with composition rules, text hierarchy, color psychology, and platform-specific specs.

## Target Users

- Content creators
- Video marketers
- Graphic designers
- Social media managers

## When to Use

- Designing cover images for new videos
- Improving CTR of underperforming videos
- Creating a consistent cover style for a video series
- A/B testing cover concepts

## Core Workflow

1. Cover objective definition
2. Composition principles
3. Text hierarchy and placement
4. Color psychology and contrast
5. Image selection criteria
6. Platform-specific spec sheet

## Inputs

- Video topic
- Target platform
- Brand guidelines
- Series context
- CTR data (if available)

## Expected Outputs

- Cover design brief
- Composition and text layout description
- Color palette recommendation
- Platform spec reference
- A/B testing ideas

## Example Prompts

- "Design a thumbnail concept for a '5 morning habits' video targeting a productivity audience."
- "My Douyin covers have low CTR — help me redesign the visual strategy."
- "Create a consistent cover template concept for a 10-episode cooking series."

## Trigger Keywords

video thumbnail, cover design, thumbnail design, video cover, CTR improvement, cover image

## Safety & Limitations

Cover design guidance is creative. Does not generate or edit images. Clickbait or misleading covers are discouraged. Users are responsible for image rights and platform compliance.

---

*Generated for project short-video-skills-2026-04-27*

FILE:skill.json
{
  "slug": "sv-thumbnail-designer",
  "name": "Short Video Thumbnail & Cover Designer",
  "description": "Guides the design of high-click-through video covers/thumbnails with composition rules, text hierarchy, color psychology, and platform-specific specs.",
  "type": "descriptive",
  "requires_api": false,
  "readiness": "stable",
  "tags": [
    "video",
    "thumbnail",
    "cover",
    "design",
    "CTR",
    "visual",
    "descriptive"
  ],
  "trigger_keywords": [
    "video thumbnail",
    "cover design",
    "thumbnail design",
    "video cover",
    "CTR improvement",
    "cover image"
  ],
  "max_files": 4,
  "language": "en",
  "safety": "document-only informational guidance"
}

FILE:README.md
# Short Video Thumbnail & Cover Designer

Guides the design of high-click-through video covers/thumbnails with composition rules, text hierarchy, color psychology, and platform-specific specs.

## Target Users

- Content creators
- Video marketers
- Graphic designers
- Social media managers

## When to Use

- Designing cover images for new videos
- Improving CTR of underperforming videos
- Creating a consistent cover style for a video series
- A/B testing cover concepts

## Trigger Keywords

video thumbnail, cover design, thumbnail design, video cover, CTR improvement, cover image

## Full Documentation

See [SKILL.md](./SKILL.md) for complete workflow, inputs, outputs, and examples.

---

*Generated for project short-video-skills-2026-04-27*

FILE:ACCEPTANCE.md
# Acceptance Checklist — Short Video Thumbnail & Cover Designer

## Criteria

- [x] Document-only: no handler.py, scripts, APIs, or executable code
- [x] No network calls or credential handling
- [x] English-first documentation
- [x] File count ≤ 10 (target: exactly 4)
- [x] Includes safety disclaimer
- [x] skill.json is valid with `requires_api: false`
- [x] No drift from design-spec.md

## Files in This Skill

1. `SKILL.md` — Full workflow, inputs, outputs, examples, safety
2. `README.md` — Quick-start reference
3. `skill.json` — Machine-readable metadata
4. `ACCEPTANCE.md` — This checklist

## Verification Commands

```bash
# Count files in this directory
find /Users/jianghaidong/.openclaw/skills/sv-thumbnail-designer -type f | wc -l
# Expected: 4

# Verify skill.json
cat /Users/jianghaidong/.openclaw/skills/sv-thumbnail-designer/skill.json | grep requires_api
# Expected: "requires_api": false

# Verify no code files
find /Users/jianghaidong/.openclaw/skills/sv-thumbnail-designer -name "*.py" -o -name "*.sh" | wc -l
# Expected: 0
```

---

*Generated for project short-video-skills-2026-04-27*

# Short Video Caption & Subtitle Design Guide

Covers caption strategy — styling, placement, timing, accessibility, and engagement — for short video subtitles and on-screen text.

## Target Users

- Video editors
- Content creators
- Social media managers
- Accessibility-focused creators

## When to Use

- Designing subtitle style for a new video series
- Improving caption readability and engagement
- Making content accessible to hearing-impaired viewers
- Optimizing captions for sound-off viewing

## Core Workflow

1. Caption purpose definition
2. Typography selection (font, size, color, stroke/shadow, background)
3. Placement strategy
4. Timing and sync
5. Readability and accessibility checklist
6. Platform-specific caption best practices

## Inputs

- Video type
- Platform(s)
- Target audience
- Accessibility requirements
- Brand guidelines
- Video timeline

## Expected Outputs

- Caption style specification
- Placement and timing guide
- Accessibility checklist
- Platform-specific tips

## Example Prompts

- "Design a caption style for my Douyin cooking videos — needs to work for sound-off viewing."
- "Create an accessibility-friendly subtitle guide for educational short videos."
- "How should I style captions for a high-energy fashion reel vs. a calm meditation video?"

## Trigger Keywords

video captions, subtitle design, caption style, text overlay, accessibility captions, word-by-word captions

## Safety & Limitations

Caption design guidance only. Does not auto-generate, transcribe, or render captions. Users are responsible for caption accuracy and translation quality.

---

*Generated for project short-video-skills-2026-04-27*

FILE:skill.json
{
  "slug": "sv-caption-design",
  "name": "Short Video Caption & Subtitle Design Guide",
  "description": "Covers caption strategy — styling, placement, timing, accessibility, and engagement — for short video subtitles and on-screen text.",
  "type": "descriptive",
  "requires_api": false,
  "readiness": "stable",
  "tags": [
    "video",
    "caption",
    "subtitle",
    "accessibility",
    "text",
    "descriptive"
  ],
  "trigger_keywords": [
    "video captions",
    "subtitle design",
    "caption style",
    "text overlay",
    "accessibility captions",
    "word-by-word captions"
  ],
  "max_files": 4,
  "language": "en",
  "safety": "document-only informational guidance"
}

FILE:README.md
# Short Video Caption & Subtitle Design Guide

Covers caption strategy — styling, placement, timing, accessibility, and engagement — for short video subtitles and on-screen text.

## Target Users

- Video editors
- Content creators
- Social media managers
- Accessibility-focused creators

## When to Use

- Designing subtitle style for a new video series
- Improving caption readability and engagement
- Making content accessible to hearing-impaired viewers
- Optimizing captions for sound-off viewing

## Trigger Keywords

video captions, subtitle design, caption style, text overlay, accessibility captions, word-by-word captions

## Full Documentation

See [SKILL.md](./SKILL.md) for complete workflow, inputs, outputs, and examples.

---

*Generated for project short-video-skills-2026-04-27*

FILE:ACCEPTANCE.md
# Acceptance Checklist — Short Video Caption & Subtitle Design Guide

## Criteria

- [x] Document-only: no handler.py, scripts, APIs, or executable code
- [x] No network calls or credential handling
- [x] English-first documentation
- [x] File count ≤ 10 (target: exactly 4)
- [x] Includes safety disclaimer
- [x] skill.json is valid with `requires_api: false`
- [x] No drift from design-spec.md

## Files in This Skill

1. `SKILL.md` — Full workflow, inputs, outputs, examples, safety
2. `README.md` — Quick-start reference
3. `skill.json` — Machine-readable metadata
4. `ACCEPTANCE.md` — This checklist

## Verification Commands

```bash
# Count files in this directory
find /Users/jianghaidong/.openclaw/skills/sv-caption-design -type f | wc -l
# Expected: 4

# Verify skill.json
cat /Users/jianghaidong/.openclaw/skills/sv-caption-design/skill.json | grep requires_api
# Expected: "requires_api": false

# Verify no code files
find /Users/jianghaidong/.openclaw/skills/sv-caption-design -name "*.py" -o -name "*.sh" | wc -l
# Expected: 0
```

---

*Generated for project short-video-skills-2026-04-27*

# Short Video B-Roll & Cutaway Planner

Plans supplementary footage (B-roll) and cutaway shots to enhance visual interest, cover edits, and strengthen storytelling in short videos.

## Target Users

- Video editors
- Content creators
- Documentary-style creators
- Product reviewers
- Vloggers

## When to Use

- Covering jump cuts in talking-head videos
- Adding visual variety to a single-shot video
- Illustrating narration with relevant visuals
- Planning B-roll shot list before a shoot

## Core Workflow

1. B-roll purpose identification
2. B-roll-to-A-roll mapping
3. B-roll shot type selection
4. B-roll sourcing options
5. B-roll timing and layering guide

## Inputs

- A-roll description/script
- Content type
- Available footage
- Budget/equipment constraints

## Expected Outputs

- B-roll shot list mapped to script segments
- Sourcing recommendations
- Timing guide
- Coverage checklist

## Example Prompts

- "I have a 60-second talking-head video — plan B-roll shots to cover my jump cuts and illustrate my points."
- "Create a B-roll shot list for a product review video of wireless earbuds."
- "I'm shooting a travel vlog — what B-roll should I plan for beyond the main walking shots?"

## Trigger Keywords

b-roll, cutaway, supplementary footage, cover cuts, b-roll shot list, visual variety

## Safety & Limitations

B-roll planning is creative guidance. Users are responsible for footage rights (stock licensing, location releases, etc.). Does not provide or source actual footage.

---

*Generated for project short-video-skills-2026-04-27*

FILE:skill.json
{
  "slug": "sv-broll-planner",
  "name": "Short Video B-Roll & Cutaway Planner",
  "description": "Plans supplementary footage (B-roll) and cutaway shots to enhance visual interest, cover edits, and strengthen storytelling in short videos.",
  "type": "descriptive",
  "requires_api": false,
  "readiness": "stable",
  "tags": [
    "video",
    "b-roll",
    "cutaway",
    "editing",
    "visual",
    "descriptive"
  ],
  "trigger_keywords": [
    "b-roll",
    "cutaway",
    "supplementary footage",
    "cover cuts",
    "b-roll shot list",
    "visual variety"
  ],
  "max_files": 4,
  "language": "en",
  "safety": "document-only informational guidance"
}

FILE:README.md
# Short Video B-Roll & Cutaway Planner

Plans supplementary footage (B-roll) and cutaway shots to enhance visual interest, cover edits, and strengthen storytelling in short videos.

## Target Users

- Video editors
- Content creators
- Documentary-style creators
- Product reviewers
- Vloggers

## When to Use

- Covering jump cuts in talking-head videos
- Adding visual variety to a single-shot video
- Illustrating narration with relevant visuals
- Planning B-roll shot list before a shoot

## Trigger Keywords

b-roll, cutaway, supplementary footage, cover cuts, b-roll shot list, visual variety

## Full Documentation

See [SKILL.md](./SKILL.md) for complete workflow, inputs, outputs, and examples.

---

*Generated for project short-video-skills-2026-04-27*

FILE:ACCEPTANCE.md
# Acceptance Checklist — Short Video B-Roll & Cutaway Planner

## Criteria

- [x] Document-only: no handler.py, scripts, APIs, or executable code
- [x] No network calls or credential handling
- [x] English-first documentation
- [x] File count ≤ 10 (target: exactly 4)
- [x] Includes safety disclaimer
- [x] skill.json is valid with `requires_api: false`
- [x] No drift from design-spec.md

## Files in This Skill

1. `SKILL.md` — Full workflow, inputs, outputs, examples, safety
2. `README.md` — Quick-start reference
3. `skill.json` — Machine-readable metadata
4. `ACCEPTANCE.md` — This checklist

## Verification Commands

```bash
# Count files in this directory
find /Users/jianghaidong/.openclaw/skills/sv-broll-planner -type f | wc -l
# Expected: 4

# Verify skill.json
cat /Users/jianghaidong/.openclaw/skills/sv-broll-planner/skill.json | grep requires_api
# Expected: "requires_api": false

# Verify no code files
find /Users/jianghaidong/.openclaw/skills/sv-broll-planner -name "*.py" -o -name "*.sh" | wc -l
# Expected: 0
```

---

*Generated for project short-video-skills-2026-04-27*

# Short Video Pacing & Rhythm Guide

Teaches pacing techniques — cut timing, beat structure, BGM coordination, and energy curve — to maximize short video retention and engagement.

## Target Users

- Video editors
- Content creators
- Storytellers
- Social media video teams

## When to Use

- Videos with high drop-off rates
- Structuring pacing for different content types
- Syncing cuts to music/beats
- Adapting pacing to platform audience behaviors

## Core Workflow

1. Pacing archetype selection
2. Energy curve mapping
3. Cut rhythm and beat structure
4. BGM selection and sync guidance
5. Retention-critical moments
6. Platform-specific pacing norms

## Inputs

- Content type
- Target duration
- Platform
- Target emotion
- Music style preference
- Retention data (if available)

## Expected Outputs

- Pacing plan with timestamped segments
- Cut rhythm recommendations
- BGM sync guide
- Energy curve diagram (described textually)

## Example Prompts

- "My tutorial videos lose viewers after 15 seconds — help me fix the pacing."
- "Design a beat-synced pacing plan for a 30-second brand promo video with EDM music."
- "How should I pace a storytelling short video differently from a product demo?"

## Trigger Keywords

video pacing, cut rhythm, beat sync, retention pacing, editing rhythm, video energy

## Safety & Limitations

Pacing guidance is creative. No music licensing advice — users are responsible for clearing music rights. Actual editing execution is user's responsibility.

---

*Generated for project short-video-skills-2026-04-27*

FILE:skill.json
{
  "slug": "sv-pacing-guide",
  "name": "Short Video Pacing & Rhythm Guide",
  "description": "Teaches pacing techniques — cut timing, beat structure, BGM coordination, and energy curve — to maximize short video retention and engagement.",
  "type": "descriptive",
  "requires_api": false,
  "readiness": "stable",
  "tags": [
    "video",
    "pacing",
    "editing",
    "rhythm",
    "retention",
    "descriptive"
  ],
  "trigger_keywords": [
    "video pacing",
    "cut rhythm",
    "beat sync",
    "retention pacing",
    "editing rhythm",
    "video energy"
  ],
  "max_files": 4,
  "language": "en",
  "safety": "document-only informational guidance"
}

FILE:README.md
# Short Video Pacing & Rhythm Guide

Teaches pacing techniques — cut timing, beat structure, BGM coordination, and energy curve — to maximize short video retention and engagement.

## Target Users

- Video editors
- Content creators
- Storytellers
- Social media video teams

## When to Use

- Videos with high drop-off rates
- Structuring pacing for different content types
- Syncing cuts to music/beats
- Adapting pacing to platform audience behaviors

## Trigger Keywords

video pacing, cut rhythm, beat sync, retention pacing, editing rhythm, video energy

## Full Documentation

See [SKILL.md](./SKILL.md) for complete workflow, inputs, outputs, and examples.

---

*Generated for project short-video-skills-2026-04-27*

FILE:ACCEPTANCE.md
# Acceptance Checklist — Short Video Pacing & Rhythm Guide

## Criteria

- [x] Document-only: no handler.py, scripts, APIs, or executable code
- [x] No network calls or credential handling
- [x] English-first documentation
- [x] File count ≤ 10 (target: exactly 4)
- [x] Includes safety disclaimer
- [x] skill.json is valid with `requires_api: false`
- [x] No drift from design-spec.md

## Files in This Skill

1. `SKILL.md` — Full workflow, inputs, outputs, examples, safety
2. `README.md` — Quick-start reference
3. `skill.json` — Machine-readable metadata
4. `ACCEPTANCE.md` — This checklist

## Verification Commands

```bash
# Count files in this directory
find /Users/jianghaidong/.openclaw/skills/sv-pacing-guide -type f | wc -l
# Expected: 4

# Verify skill.json
cat /Users/jianghaidong/.openclaw/skills/sv-pacing-guide/skill.json | grep requires_api
# Expected: "requires_api": false

# Verify no code files
find /Users/jianghaidong/.openclaw/skills/sv-pacing-guide -name "*.py" -o -name "*.sh" | wc -l
# Expected: 0
```

---

*Generated for project short-video-skills-2026-04-27*

# Short Video Shot Composition Guide

Teaches and applies shot composition principles — framing, angles, depth, and movement — specifically optimized for vertical short video formats.

## Target Users

- Beginner to intermediate videographers
- Content creators
- Smartphone shooters
- Solo creators

## When to Use

- Planning camera setups for a shoot
- Improving visual quality of existing content
- Learning composition fundamentals for vertical video
- Preparing multi-camera or multi-angle shoots

## Core Workflow

1. Aspect ratio & safe zone awareness (9:16, 1:1, 16:9)
2. Composition rule selection (rule of thirds, center framing, headroom, leading lines, symmetry, negative space)
3. Shot size & angle guide
4. Depth and layering (foreground, midground, background)
5. Camera movement dos and don'ts
6. Smartphone-specific tips

## Inputs

- Shooting environment description
- Available equipment
- Content type
- Desired visual style

## Expected Outputs

- Per-shot composition recommendations
- Framing diagrams (described textually)
- Equipment setup notes
- Common mistake avoidance checklist

## Example Prompts

- "I shoot cooking videos with my phone in a small kitchen — how should I compose my shots?"
- "Guide me through shot composition for a talking-head educational video in vertical format."
- "What composition rules should I follow for a fashion lookbook short video?"

## Trigger Keywords

shot composition, video framing, camera angles, vertical video, filming guide, composition rules

## Safety & Limitations

Composition guidance is educational. Does not control or operate camera equipment. Users should follow safety precautions when setting up equipment.

---

*Generated for project short-video-skills-2026-04-27*

FILE:skill.json
{
  "slug": "sv-shot-composition",
  "name": "Short Video Shot Composition Guide",
  "description": "Teaches and applies shot composition principles — framing, angles, depth, and movement — specifically optimized for vertical short video formats.",
  "type": "descriptive",
  "requires_api": false,
  "readiness": "stable",
  "tags": [
    "video",
    "composition",
    "framing",
    "camera",
    "shooting",
    "descriptive"
  ],
  "trigger_keywords": [
    "shot composition",
    "video framing",
    "camera angles",
    "vertical video",
    "filming guide",
    "composition rules"
  ],
  "max_files": 4,
  "language": "en",
  "safety": "document-only informational guidance"
}

FILE:README.md
# Short Video Shot Composition Guide

Teaches and applies shot composition principles — framing, angles, depth, and movement — specifically optimized for vertical short video formats.

## Target Users

- Beginner to intermediate videographers
- Content creators
- Smartphone shooters
- Solo creators

## When to Use

- Planning camera setups for a shoot
- Improving visual quality of existing content
- Learning composition fundamentals for vertical video
- Preparing multi-camera or multi-angle shoots

## Trigger Keywords

shot composition, video framing, camera angles, vertical video, filming guide, composition rules

## Full Documentation

See [SKILL.md](./SKILL.md) for complete workflow, inputs, outputs, and examples.

---

*Generated for project short-video-skills-2026-04-27*

FILE:ACCEPTANCE.md
# Acceptance Checklist — Short Video Shot Composition Guide

## Criteria

- [x] Document-only: no handler.py, scripts, APIs, or executable code
- [x] No network calls or credential handling
- [x] English-first documentation
- [x] File count ≤ 10 (target: exactly 4)
- [x] Includes safety disclaimer
- [x] skill.json is valid with `requires_api: false`
- [x] No drift from design-spec.md

## Files in This Skill

1. `SKILL.md` — Full workflow, inputs, outputs, examples, safety
2. `README.md` — Quick-start reference
3. `skill.json` — Machine-readable metadata
4. `ACCEPTANCE.md` — This checklist

## Verification Commands

```bash
# Count files in this directory
find /Users/jianghaidong/.openclaw/skills/sv-shot-composition -type f | wc -l
# Expected: 4

# Verify skill.json
cat /Users/jianghaidong/.openclaw/skills/sv-shot-composition/skill.json | grep requires_api
# Expected: "requires_api": false

# Verify no code files
find /Users/jianghaidong/.openclaw/skills/sv-shot-composition -name "*.py" -o -name "*.sh" | wc -l
# Expected: 0
```

---

*Generated for project short-video-skills-2026-04-27*

# Short Video Narration & Voiceover Writer

Helps creators write natural, engaging narration and voiceover scripts with pacing, tone, and delivery guidance for short videos.

## Target Users

- Content creators
- Voiceover artists
- Video producers
- Educators
- Vloggers

## When to Use

- Writing VO scripts for faceless content
- Crafting on-camera talking points
- Converting written content into spoken-word scripts
- Optimizing narration timing for video pacing

## Core Workflow

1. Narration style selection (conversational, authoritative, emotional, educational, high-energy)
2. Script drafting with natural speech patterns
3. Timing estimation (words → seconds)
4. Tone and delivery notes
5. Audio cue notes (pause, emphasis, BGM changes)

## Inputs

- Video concept/script outline
- Target duration
- Desired tone
- Speaker profile
- Platform

## Expected Outputs

- Narration script with timing estimates
- Delivery guidance notes
- Emphasis and pause markers
- Sync notes with visual timeline

## Example Prompts

- "Write a voiceover script for a 30-second faceless cooking video — warm, inviting tone."
- "Convert this product feature list into a natural-sounding narration for a 60-second ad."
- "Help me write on-camera talking points for a motivational short video — energetic delivery."

## Trigger Keywords

voiceover script, narration writing, VO script, talking points, voice script, faceless video

## Safety & Limitations

Narration scripts are creative writing support. Does not provide voice synthesis, recording, or text-to-speech. Creator is responsible for content accuracy and claims.

---

*Generated for project short-video-skills-2026-04-27*

FILE:skill.json
{
  "slug": "sv-narration-writer",
  "name": "Short Video Narration & Voiceover Writer",
  "description": "Helps creators write natural, engaging narration and voiceover scripts with pacing, tone, and delivery guidance for short videos.",
  "type": "descriptive",
  "requires_api": false,
  "readiness": "stable",
  "tags": [
    "video",
    "narration",
    "voiceover",
    "script",
    "audio",
    "descriptive"
  ],
  "trigger_keywords": [
    "voiceover script",
    "narration writing",
    "VO script",
    "talking points",
    "voice script",
    "faceless video"
  ],
  "max_files": 4,
  "language": "en",
  "safety": "document-only informational guidance"
}

FILE:README.md
# Short Video Narration & Voiceover Writer

Helps creators write natural, engaging narration and voiceover scripts with pacing, tone, and delivery guidance for short videos.

## Target Users

- Content creators
- Voiceover artists
- Video producers
- Educators
- Vloggers

## When to Use

- Writing VO scripts for faceless content
- Crafting on-camera talking points
- Converting written content into spoken-word scripts
- Optimizing narration timing for video pacing

## Trigger Keywords

voiceover script, narration writing, VO script, talking points, voice script, faceless video

## Full Documentation

See [SKILL.md](./SKILL.md) for complete workflow, inputs, outputs, and examples.

---

*Generated for project short-video-skills-2026-04-27*

FILE:ACCEPTANCE.md
# Acceptance Checklist — Short Video Narration & Voiceover Writer

## Criteria

- [x] Document-only: no handler.py, scripts, APIs, or executable code
- [x] No network calls or credential handling
- [x] English-first documentation
- [x] File count ≤ 10 (target: exactly 4)
- [x] Includes safety disclaimer
- [x] skill.json is valid with `requires_api: false`
- [x] No drift from design-spec.md

## Files in This Skill

1. `SKILL.md` — Full workflow, inputs, outputs, examples, safety
2. `README.md` — Quick-start reference
3. `skill.json` — Machine-readable metadata
4. `ACCEPTANCE.md` — This checklist

## Verification Commands

```bash
# Count files in this directory
find /Users/jianghaidong/.openclaw/skills/sv-narration-writer -type f | wc -l
# Expected: 4

# Verify skill.json
cat /Users/jianghaidong/.openclaw/skills/sv-narration-writer/skill.json | grep requires_api
# Expected: "requires_api": false

# Verify no code files
find /Users/jianghaidong/.openclaw/skills/sv-narration-writer -name "*.py" -o -name "*.sh" | wc -l
# Expected: 0
```

---

*Generated for project short-video-skills-2026-04-27*

# Short Video Storyboard Planner

Guides creators through visual storyboarding — shot-by-shot planning with framing, composition, text overlays, and timing notes.

## Target Users

- Video creators
- Directors
- Content producers
- Marketing video teams
- Beginner filmmakers

## When to Use

- Pre-production planning for complex shots
- Ensuring visual variety across cuts
- Communicating vision to collaborators or clients
- Planning transitions between scenes

## Core Workflow

1. Script-to-shot breakdown
2. Shot type selection (wide, medium, close-up, extreme close-up, POV, over-shoulder)
3. Camera movement planning (static, pan, tilt, dolly, handheld, drone)
4. Composition notes (rule of thirds, leading lines, headroom)
5. Text/graphic overlay planning
6. Timing and transition notes

## Inputs

- Complete script or scene outline
- Total target duration
- Platform aspect ratio requirements
- Visual style references

## Expected Outputs

- Shot-by-shot storyboard table
- Visual style guidance summary

## Example Prompts

- "Storyboard my 60-second product unboxing script for Douyin vertical format."
- "Break down this cooking tutorial script into a shot-by-shot storyboard."
- "Create a storyboard for a brand storytelling video with 12 shots, 45 seconds."

## Trigger Keywords

storyboard, shot list, shot planning, visual plan, pre-production, shot breakdown

## Safety & Limitations

Storyboard guidance is creative support. Does not generate actual visual assets, drawings, or animations. Shot descriptions are textual planning aids.

---

*Generated for project short-video-skills-2026-04-27*

FILE:skill.json
{
  "slug": "sv-storyboard-planner",
  "name": "Short Video Storyboard Planner",
  "description": "Guides creators through visual storyboarding — shot-by-shot planning with framing, composition, text overlays, and timing notes.",
  "type": "descriptive",
  "requires_api": false,
  "readiness": "stable",
  "tags": [
    "video",
    "storyboard",
    "pre-production",
    "planning",
    "visual",
    "descriptive"
  ],
  "trigger_keywords": [
    "storyboard",
    "shot list",
    "shot planning",
    "visual plan",
    "pre-production",
    "shot breakdown"
  ],
  "max_files": 4,
  "language": "en",
  "safety": "document-only informational guidance"
}

FILE:README.md
# Short Video Storyboard Planner

Guides creators through visual storyboarding — shot-by-shot planning with framing, composition, text overlays, and timing notes.

## Target Users

- Video creators
- Directors
- Content producers
- Marketing video teams
- Beginner filmmakers

## When to Use

- Pre-production planning for complex shots
- Ensuring visual variety across cuts
- Communicating vision to collaborators or clients
- Planning transitions between scenes

## Trigger Keywords

storyboard, shot list, shot planning, visual plan, pre-production, shot breakdown

## Full Documentation

See [SKILL.md](./SKILL.md) for complete workflow, inputs, outputs, and examples.

---

*Generated for project short-video-skills-2026-04-27*

FILE:ACCEPTANCE.md
# Acceptance Checklist — Short Video Storyboard Planner

## Criteria

- [x] Document-only: no handler.py, scripts, APIs, or executable code
- [x] No network calls or credential handling
- [x] English-first documentation
- [x] File count ≤ 10 (target: exactly 4)
- [x] Includes safety disclaimer
- [x] skill.json is valid with `requires_api: false`
- [x] No drift from design-spec.md

## Files in This Skill

1. `SKILL.md` — Full workflow, inputs, outputs, examples, safety
2. `README.md` — Quick-start reference
3. `skill.json` — Machine-readable metadata
4. `ACCEPTANCE.md` — This checklist

## Verification Commands

```bash
# Count files in this directory
find /Users/jianghaidong/.openclaw/skills/sv-storyboard-planner -type f | wc -l
# Expected: 4

# Verify skill.json
cat /Users/jianghaidong/.openclaw/skills/sv-storyboard-planner/skill.json | grep requires_api
# Expected: "requires_api": false

# Verify no code files
find /Users/jianghaidong/.openclaw/skills/sv-storyboard-planner -name "*.py" -o -name "*.sh" | wc -l
# Expected: 0
```

---

*Generated for project short-video-skills-2026-04-27*

# Short Video Hook Crafter

Specializes in crafting attention-grabbing first-3-second hooks — visual, verbal, and pattern-interrupt — for short videos.

## Target Users

- Content creators
- Video editors
- Scriptwriters
- Social media marketers

## When to Use

- Low retention in the first 3 seconds
- Brainstorming multiple hook options for a single video
- Designing pattern-interrupt openings
- A/B testing hook variations

## Core Workflow

1. Content goal & emotion mapping
2. Hook type selection (curiosity gap, bold claim, question, pattern interrupt, visual surprise, relatable moment)
3. Hook drafting (3–5 variations)
4. Visual/text overlay coordination notes
5. Hook scoring rubric
6. First-frame / thumbnail alignment check

## Inputs

- Video topic
- Target audience
- Content format
- Platform norms

## Expected Outputs

- 3–5 hook variations per topic
- Visual/text overlay suggestions
- Scorecard with rationale
- Frame-1 alignment notes

## Example Prompts

- "Give me 5 hooks for a cooking video about making the perfect scrambled eggs."
- "My retention drops at 2 seconds — help me fix my hook for a tech review video."
- "Craft pattern-interrupt hooks for a finance education short targeting Gen Z."

## Trigger Keywords

video hook, attention hook, first 3 seconds, hook ideas, retention hook, pattern interrupt

## Safety & Limitations

Hooks are creative suggestions. Clickbait or misleading hooks that violate platform policies are not endorsed. Creator bears responsibility for honest representation.

---

*Generated for project short-video-skills-2026-04-27*

FILE:skill.json
{
  "slug": "sv-hook-crafter",
  "name": "Short Video Hook Crafter",
  "description": "Specializes in crafting attention-grabbing first-3-second hooks — visual, verbal, and pattern-interrupt — for short videos.",
  "type": "descriptive",
  "requires_api": false,
  "readiness": "stable",
  "tags": [
    "video",
    "hook",
    "engagement",
    "attention",
    "script",
    "descriptive"
  ],
  "trigger_keywords": [
    "video hook",
    "attention hook",
    "first 3 seconds",
    "hook ideas",
    "retention hook",
    "pattern interrupt"
  ],
  "max_files": 4,
  "language": "en",
  "safety": "document-only informational guidance"
}

FILE:README.md
# Short Video Hook Crafter

Specializes in crafting attention-grabbing first-3-second hooks — visual, verbal, and pattern-interrupt — for short videos.

## Target Users

- Content creators
- Video editors
- Scriptwriters
- Social media marketers

## When to Use

- Low retention in the first 3 seconds
- Brainstorming multiple hook options for a single video
- Designing pattern-interrupt openings
- A/B testing hook variations

## Trigger Keywords

video hook, attention hook, first 3 seconds, hook ideas, retention hook, pattern interrupt

## Full Documentation

See [SKILL.md](./SKILL.md) for complete workflow, inputs, outputs, and examples.

---

*Generated for project short-video-skills-2026-04-27*

FILE:ACCEPTANCE.md
# Acceptance Checklist — Short Video Hook Crafter

## Criteria

- [x] Document-only: no handler.py, scripts, APIs, or executable code
- [x] No network calls or credential handling
- [x] English-first documentation
- [x] File count ≤ 10 (target: exactly 4)
- [x] Includes safety disclaimer
- [x] skill.json is valid with `requires_api: false`
- [x] No drift from design-spec.md

## Files in This Skill

1. `SKILL.md` — Full workflow, inputs, outputs, examples, safety
2. `README.md` — Quick-start reference
3. `skill.json` — Machine-readable metadata
4. `ACCEPTANCE.md` — This checklist

## Verification Commands

```bash
# Count files in this directory
find /Users/jianghaidong/.openclaw/skills/sv-hook-crafter -type f | wc -l
# Expected: 4

# Verify skill.json
cat /Users/jianghaidong/.openclaw/skills/sv-hook-crafter/skill.json | grep requires_api
# Expected: "requires_api": false

# Verify no code files
find /Users/jianghaidong/.openclaw/skills/sv-hook-crafter -name "*.py" -o -name "*.sh" | wc -l
# Expected: 0
```

---

*Generated for project short-video-skills-2026-04-27*