# Send Skill Tiktok Video Pipeline to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- Download the package from Yavira.
- Extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the extracted folder.
## Suggested prompts
### New install

```text
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete.
```
### Upgrade existing

```text
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "skill-tiktok-video-pipeline",
    "name": "Skill Tiktok Video Pipeline",
    "source": "tencent",
    "type": "skill",
    "category": "开发工具",
    "sourceUrl": "https://clawhub.ai/Zero2Ai-hub/skill-tiktok-video-pipeline",
    "canonicalUrl": "https://clawhub.ai/Zero2Ai-hub/skill-tiktok-video-pipeline",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/skill-tiktok-video-pipeline",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=skill-tiktok-video-pipeline",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "SKILL.md",
      "_meta.json",
      "assets/README.md",
      "config/products.json",
      "scripts/generate.js",
      "scripts/pipeline.py"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-05-07T17:22:31.273Z",
      "expiresAt": "2026-05-14T17:22:31.273Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=afrexai-annual-report",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=afrexai-annual-report",
        "contentDisposition": "attachment; filename=\"afrexai-annual-report-1.0.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null
      },
      "scope": "source",
      "summary": "Source download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this source.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/skill-tiktok-video-pipeline"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    }
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/skill-tiktok-video-pipeline",
    "downloadUrl": "https://openagent3.xyz/downloads/skill-tiktok-video-pipeline",
    "agentUrl": "https://openagent3.xyz/skills/skill-tiktok-video-pipeline/agent",
    "manifestUrl": "https://openagent3.xyz/skills/skill-tiktok-video-pipeline/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/skill-tiktok-video-pipeline/agent.md"
  }
}
```
## Documentation

### skill-tiktok-video-pipeline v2

Full end-to-end pipeline for TikTok product ads. Takes a product_id + script_text and outputs a publish-ready vertical short-form video with captions, optional logo watermark, and background music.

### Architecture

script_text + product_id
       │
       ▼
Step 1: Veo 3 base video generation (9:16, ~8s)
       │
       ▼
Step 2: Caption overlay + logo watermark
        └── tiktok_overlay_engine_v3.py (ffmpeg drawtext)
       │
       ▼
Step 3: Background audio mix (20% volume, ffmpeg amix)
       │
       ▼
output/tiktok/<product_id>_<lang>_final.mp4

### Requirements

GEMINI_API_KEY env var (for Veo generation)
ffmpeg on PATH
uv on PATH (for Python scripts)
veo3-video-gen skill installed at skills/veo3-video-gen/

### Usage

node scripts/generate.js \\
  --product-id rain_cloud \\
  --script-text "Stop dry air!|Ultrasonic mist|Whisper-quiet|Get yours today" \\
  --lang EN

### With logo and custom audio

node scripts/generate.js \\
  --product-id hydro_bottle \\
  --script-text "Hydrogen water|Boosts energy|Pure & clean|Shop now" \\
  --lang EN \\
  --logo /path/to/brand_logo.png \\
  --audio /path/to/bgm.mp3

### Arabic (AR) captions

node scripts/generate.js \\
  --product-id mini_cam \\
  --script-text "صوّر كل لحظة|دقة عالية|خفيف وصغير|اطلب الآن" \\
  --lang AR

### Dry-run (no API calls, generates dummy video for testing overlay)

node scripts/generate.js \\
  --product-id test \\
  --script-text "Line 1|Line 2|Line 3" \\
  --dry-run

### Inputs

ArgumentRequiredDefaultDescription--product-id✅—Product identifier (used in output filename)--script-text✅—Caption lines separated by |--lang❌ENLanguage: EN or AR--logo❌nonePath to logo PNG for watermark (top-right)--audio❌assets/bgm_default.mp3Background music path--veo-model❌veo-3.1-generate-previewVeo model to use--prompt❌autoCustom Veo generation prompt--segments❌1Number of Veo segments to generate & stitch--dry-run❌falseSkip Veo API call; use dummy black video

### Outputs

FileDescriptionoutput/tiktok/<product_id>_<lang>_final.mp4Final publish-ready TikTok video

### Scripts

ScriptDescriptionscripts/generate.jsMain Node.js orchestratorscripts/tiktok_overlay_engine_v3.pyPython/ffmpeg caption overlay engine

### Caption Format

Captions are split by | and timed evenly across the video duration.

Example: "Hook line!|Feature 1|Feature 2|CTA here" → 4 pills, each shown for ~2s on an 8s video.

Pill style: dark semi-transparent box, white text, centered at 75% height.

### Default Audio

Place a royalty-free BGM file at assets/bgm_default.mp3 in this skill folder to auto-mix audio in all runs. If no audio is found, the video is output without BGM.

### Pipeline Steps Detail

Step 1  Veo 3 generates a 9:16 base MP4           ~60–120s
Step 2  Python overlays timed caption pills         ~5s
Step 3  ffmpeg mixes BGM at 20% volume              ~5s
─────────────────────────────────────────────────────────
Output  Final branded MP4 ready to post

### pipeline.py (v2.0.0 — Python orchestrator)

Direct Python pipeline wired to overlay engine via subprocess.

uv run scripts/pipeline.py \\
  --product rain_cloud \\
  --image product.jpg \\
  --output final.mp4 \\
  --audio /path/to/music.mp3 \\
  --slowmo

### New flags (v2.0.0)

FlagDefaultDescription--audio$DEFAULT_AUDIO env or bundled Hyperfun.mp3Audio file passed to overlay step--slowmofalseApply 0.83x speed → fills ~12s. Overrides --extend-to auto-stretch

### Environment Variables

VarDefaultDescriptionDEFAULT_AUDIOworkspace root audio_Hyperfun.mp3Default audio if --audio not set
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: Zero2Ai-hub
- Version: 2.0.0
## Source health
- Status: healthy
- Source download looks usable.
- Yavira can redirect you to the upstream package for this source.
- Health scope: source
- Reason: direct_download_ok
- Checked at: 2026-05-07T17:22:31.273Z
- Expires at: 2026-05-14T17:22:31.273Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/skill-tiktok-video-pipeline)
- [Send to Agent page](https://openagent3.xyz/skills/skill-tiktok-video-pipeline/agent)
- [JSON manifest](https://openagent3.xyz/skills/skill-tiktok-video-pipeline/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/skill-tiktok-video-pipeline/agent.md)
- [Download page](https://openagent3.xyz/downloads/skill-tiktok-video-pipeline)