How do I install the Skill Tiktok Ads Video skill?

Run npx skillmds@latest add knownasnaffy/skill-tiktok-ads-video-3 in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Skill Tiktok Ads Video safe to use?

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Skill Tiktok Ads Video?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Skill Tiktok Ads Video free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Skill Tiktok Ads Video?

knownasnaffy (@knownasnaffy) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Skill Tiktok Ads Video by knownasnaffy

Name: Skill Tiktok Ads Video
Author: knownasnaffy

Skill Tiktok Ads Video

Generate TikTok-style short-form ad videos with animated pill captions. Takes a base MP4 (Veo/Runway/Kling), overlays animated captions with fade in/out, mixes background audio. Built-in product presets — no captions JSON file needed. Use for TikTok ads, Reels, YouTube Shorts product videos.

knownasnaffy Updated Sep 21, 2026 0 repo stars

File contents

skill-tiktok-ads-video v2.0.0

Animated pill-style caption overlays for short-form video. No Premiere, no CapCut — pure Python. v2 ships with built-in product presets — no more manual captions JSON.

Usage (v2 — product presets)

uv run --with moviepy --with pillow scripts/overlay.py \
  --video base.mp4 \
  --output final.mp4 \
  --product rain_cloud \
  --style subtitle_talk

Products

rain_cloud — Rain Cloud Humidifier
hydro_bottle — Hydrogen Water Bottle
mini_cam — Mini Clip Camera

Styles

phrase_slam — Bold full-screen phrase drops
subtitle_talk — Conversational subtitle-style captions
big_center — Large centered text with price bar at top. Best for bold product reveals.
random — Randomly picks a style

Optional audio

  --audio music.mp3 \
  --audio-start 8 \
  --audio-vol 0.5

No --audio keeps the original video audio.

Custom fonts

--font-black /path/to/Montserrat-Black.ttf \
--font-bold  /path/to/Montserrat-Bold.ttf

Falls back to Montserrat from ~/.local/share/fonts/ if not specified.

Legacy usage (v1 — manual captions JSON)

Still supported for backward compatibility:

uv run --with moviepy --with pillow scripts/overlay.py \
  --video base.mp4 \
  --output final.mp4 \
  --captions scripts/example_captions.json

PIL textbbox fix

PIL's textbbox((0,0), text, font) returns (x0, y0, x1, y1) where y0 is a non-zero offset (typically 7–15px depending on font size). Drawing text at (x, y) without compensating for this offset causes text to appear below the pill's visual center.

Fix implemented in pill():

bb    = draw.textbbox((0, 0), text, font=font)
x_off, y_off = bb[0], bb[1]
vis_w = bb[2] - bb[0]   # actual visual width
vis_h = bb[3] - bb[1]   # actual visual height

# Compensate offsets when drawing text
tx = cx - vis_w // 2 - x_off
ty = y - y_off
draw.text((tx, ty), text, font=font, fill=fg)

Emoji note

NotoColorEmoji.ttf fails with PIL at arbitrary sizes (bitmap font with limited supported sizes). Use text alternatives ("Free delivery" instead of "Free delivery 🚚") for reliable rendering.

---name: skill-tiktok-ads-video-3description: Generate TikTok-style short-form ad videos with animated pill captions. Takes a base MP4 (Veo/Runway/Kling), overlays animated captions with fade in/out, mixes background audio. Built-in product presets — no captions JSON file needed. Use for TikTok ads, Reels, YouTube Shorts product videos.---# skill-tiktok-ads-video v2.0.0Animated pill-style caption overlays for short-form video. No Premiere, no CapCut — pure Python. v2 ships with built-in product presets — no more manual captions JSON.## Usage (v2 — product presets)```bashuv run --with moviepy --with pillow scripts/overlay.py \ --video base.mp4 \ --output final.mp4 \ --product rain_cloud \ --style subtitle_talk```### Products- `rain_cloud` — Rain Cloud Humidifier- `hydro_bottle` — Hydrogen Water Bottle- `mini_cam` — Mini Clip Camera### Styles- `phrase_slam` — Bold full-screen phrase drops- `subtitle_talk` — Conversational subtitle-style captions- `big_center` — Large centered text with price bar at top. Best for bold product reveals.- `random` — Randomly picks a style### Optional audio```bash --audio music.mp3 \ --audio-start 8 \ --audio-vol 0.5```No `--audio` keeps the original video audio.## Custom fonts```bash--font-black /path/to/Montserrat-Black.ttf \--font-bold /path/to/Montserrat-Bold.ttf```Falls back to Montserrat from `~/.local/share/fonts/` if not specified.## Legacy usage (v1 — manual captions JSON)Still supported for backward compatibility:```bashuv run --with moviepy --with pillow scripts/overlay.py \ --video base.mp4 \ --output final.mp4 \ --captions scripts/example_captions.json```## PIL textbbox fixPIL's `textbbox((0,0), text, font)` returns `(x0, y0, x1, y1)` where `y0` is a non-zero offset (typically 7–15px depending on font size). Drawing text at `(x, y)` without compensating for this offset causes text to appear below the pill's visual center.**Fix implemented in `pill()`:**```pythonbb = draw.textbbox((0, 0), text, font=font)x_off, y_off = bb[0], bb[1]vis_w = bb[2] - bb[0] # actual visual widthvis_h = bb[3] - bb[1] # actual visual height# Compensate offsets when drawing texttx = cx - vis_w // 2 - x_offty = y - y_offdraw.text((tx, ty), text, font=font, fill=fg)```## Emoji noteNotoColorEmoji.ttf fails with PIL at arbitrary sizes (bitmap font with limited supported sizes). Use text alternatives (`"Free delivery"` instead of `"Free delivery 🚚"`) for reliable rendering.

Frequently asked questions