複数の独立したローカル作業を安全性と依存関係を確認して実行計画にまとめ、対応環境では並列化やAppleシリコン向け処理の選択を支援します。
- ビルドやテストの独立した処理を並列化したいとき
- 複数段階の作業計画を安全に実行したいとき
- Appleシリコン向け処理の候補を確認したいとき
商品紹介や開封などの撮影済み映像を、冒頭の見せ場やテロップ、字幕、CTAを整えた縦型広告に編集し、フック違いのテスト用動画も作ります。
Turn raw product footage into a TikTok ad with FFmpeg. Recuts creator, UGC or product footage into a 9:16 ecommerce ad for TikTok, TikTok Shop, Reels and Meta: the best moment moved to second 0, a text hook inside the safe zone, dead air cut, captions, a CTA end card, loudness at -14 LUFS, and one MP4 per hook for testing (plus a 4:5 feed cut and a cover frame). Every command was run on test media. Free and local; on the varg ffmpeg tool (credits) when the agent has no shell. Use when someone has footage of a product (a creator video, an unboxing, a demo, a winning ad) and wants it edited into an ad, wants new hooks on an existing ad, or wants it TikTok-ready. NOT for generating new footage (use product-photo-to-video or ai-ugc-ad-video), animated word-by-word captions (use a Remotion or HyperFrames caption skill), or generic crops and subtitles (use short-form-ffmpeg-cookbook).
実行スコア 未検証
インストール方法を見る商品紹介、開封、デモ、クリエイター撮影など、すでにある映像を縦型のEC広告に編集します。商品の魅力や結果が伝わる場面を冒頭に移し、挨拶やロゴ、間延びした無音部分をカット。画面上のフック文、字幕、最後のCTA(視聴者に促す行動)を加え、音量を調整したMP4を書き出します。フックを変えた複数案を同じ本編に組み合わせてテストできるほか、フィード向けの4:5版とカバー画像も作成します。
撮影済みの商品動画をTikTok ShopやReels、Meta向けに整えたいときに使えます。既存広告の冒頭だけを変えた案を複数用意して比較したい場合や、横向きの素材から縦型広告を作りたい場合にも向いています。編集前に見せたい商品や結果、配信先、使用できる訴求、音声の扱いを確認します。
ffmpegとffprobeが必要です。テロップや字幕の焼き込みには、libfreetypeとlibassを含むFFmpegが必要です。新しい映像素材の生成は行いません。広告に使う音楽は利用許諾を確認し、商品に関する訴求は裏付けのある内容に限ります。シェルが使えない場合は、クレジット制のvarg ffmpegツールを利用できます。
この紹介文は、公開されている SKILL.md をもとに AI(OpenAI Codex)が作成しました。正確な仕様は下の原文を確認してください。
インストールする前に、エージェントに与えられる指示の中身を確認できます。
Input: footage of a product (a creator clip, an unboxing, a demo, last month's winning ad). Output: a 1080×1920 MP4 that opens on the product and the payoff, says the hook in text inside the safe zone, has no dead air, ends on one CTA, and plays at the loudness the apps expect. You also get one file per hook for testing, a 4:5 feed cut and a cover frame.
All commands were run on test media (FFmpeg 6.0 static and 8.1). Run one step at a time and look at a frame before going on.
ffprobe -v error -show_entries stream=codec_type,codec_name,width,height,r_frame_rate -show_entries format=duration -of compact=p=0 input.mp4
Horizontal footage? Fit it to 9:16 over a blurred copy, so the whole product stays in the frame:
ffmpeg -i raw.mp4 -filter_complex "[0:v]scale=1080:1920:force_original_aspect_ratio=increase,crop=1080:1920,boxblur=20:2[bg];[0:v]scale=1080:-2[fg];[bg][fg]overlay=(W-w)/2:(H-h)/2,setsar=1" -c:v libx264 -crf 20 -c:a copy vertical.mp4
For a centre crop instead, see short-form-ffmpeg-cookbook.
Watch for the strongest 2–4 s: the product working, the reveal, the reaction, the before→after. If there is a transcript, the hook is often a line said 10–20 s in ("I stopped buying razors after this"). Move it to the front and keep the rest in order (here 12–15 s moves to the front):
ffmpeg -i input.mp4 -filter_complex "[0:v]trim=12:15,setpts=PTS-STARTPTS[v0];[0:a]atrim=12:15,asetpts=PTS-STARTPTS[a0];[0:v]trim=0:12,setpts=PTS-STARTPTS[v1];[0:a]atrim=0:12,asetpts=PTS-STARTPTS[a1];[0:v]trim=start=15,setpts=PTS-STARTPTS[v2];[0:a]atrim=start=15,asetpts=PTS-STARTPTS[a2];[v0][a0][v1][a1][v2][a2]concat=n=3:v=1:a=1[v][a]" -map "[v]" -map "[a]" -c:v libx264 -crf 20 -c:a aac -b:a 192k recut.mp4
Then cut what came before the product shows up: "Hey guys", logos, slow intros. Nobody waits for them.
scripts/cut-dead-air.sh finds pauses with silencedetect, keeps 0.12 s of air on each side, and joins the rest:
bash scripts/cut-dead-air.sh recut.mp4 tight.mp4 -35 0.5 0.12 # noise floor dB, min pause s, padding s
# Tested: "kept 4 segments: 16.28s of 20.00s"
Raise the noise floor (-30) for noisy rooms and lower it (-40) for quiet voices. Listen to the cuts: a breath cut mid-word means the padding is too small.
Pacing that still drags? Speed the body up a little (1.1–1.2× keeps the voice natural):
ffmpeg -i tight.mp4 -filter_complex "[0:v]setpts=PTS/1.15[v];[0:a]atempo=1.15[a]" -map "[v]" -map "[a]" -c:v libx264 -crf 20 -c:a aac fast.mp4
Most people watch muted at first. Put the hook in words on screen, inside the safe zone: out of the top 14%, the bottom 35% and 6% at each side (the TikTok and Reels buttons, caption and username sit there). Keep it to two lines of at most about 24 characters each at 64 px:
printf 'I stopped buying razors\nafter I found this' > hook.txt
ffmpeg -i tight.mp4 -vf "drawtext=fontfile='/System/Library/Fonts/Supplemental/Arial Bold.ttf':textfile=hook.txt:fontcolor=white:fontsize=64:line_spacing=12:box=1:boxcolor=black@0.6:boxborderw=28:x=(w-text_w)/2:y=h*0.20:enable='between(t,0,3)'" -c:v libx264 -crf 20 -c:a copy texthook.mp4
Always pass fontfile (on Linux, e.g. /usr/share/fonts/truetype/dejavu/DejaVuSans-Bold.ttf). Without it, static builds print a fontconfig error. Multi-line drawtext aligns lines to the left. For centred or animated type, render the hook as a PNG or in HyperFrames/Remotion and overlay it.
Captions for the rest of the video: burn an SRT or ASS file (see short-form-ffmpeg-cookbook §2) and keep them in the same safe band.
One action, said and shown: "Tap the orange cart" (TikTok Shop), "Shop now", or "Link in bio" (organic). Show it over the last 3 seconds:
D=$(ffprobe -v error -show_entries format=duration -of csv=p=0 texthook.mp4)
ffmpeg -i texthook.mp4 -vf "drawtext=fontfile='/System/Library/Fonts/Supplemental/Arial Bold.ttf':text='Tap the orange cart':fontcolor=black:fontsize=72:box=1:boxcolor=white@0.92:boxborderw=30:x=(w-text_w)/2:y=h*0.45:enable='gte(t,$D-3)'" -c:v libx264 -crf 20 -c:a copy cta.mp4
Don't add a price, a discount or "only today" unless the offer is real and live.
A hook is the first 2–3 s. Make 3–10 openers (new footage, a new line, a new text hook, a different first frame) and put each in front of the same body. scripts/hook-variants.sh scales every input to 1080×1920 at 30 fps and 48 kHz stereo, so clips from different sources join cleanly:
# hooks/h01-question.mp4, hooks/h02-pov.mp4, ... body.mp4 = the ad without its old hook
bash scripts/hook-variants.sh body.mp4 hooks variants 2 # last arg: seconds to drop from the body's start (its old hook)
# → variants/h01-question__body.mp4, variants/h02-pov__body.mp4
Name files so the results can be read back later: <product>_<angle>_<hook-id>_<creator>_<length>_v<N>.mp4, e.g. serum_dryskin_h03-pov_maya_22s_v1.mp4. Change one thing per variant (the hook) so the test says which one won.
Two-pass loudnorm to -14 LUFS integrated and -1 dBTP:
J=$(ffmpeg -hide_banner -i cta.mp4 -af loudnorm=I=-14:TP=-1:LRA=11:print_format=json -f null - 2>&1 | sed -n '/^{/,/^}/p')
v() { echo "$J" | grep "\"$1\"" | cut -d'"' -f4; }
ffmpeg -i cta.mp4 -af "loudnorm=I=-14:TP=-1:LRA=11:measured_I=$(v input_i):measured_TP=$(v input_tp):measured_LRA=$(v input_lra):measured_thresh=$(v input_thresh):offset=$(v target_offset):linear=true,aresample=48000" -c:v copy -c:a aac -b:a 192k loud.mp4
ffmpeg -hide_banner -i loud.mp4 -af ebur128 -f null - 2>&1 | grep -E "^\s+I:" | tail -1 # Tested: I: -14.0 and -13.9 LUFS on two inputs
Export (H.264 High, yuv420p, 30 fps, AAC 48 kHz, faststart), a 4:5 feed cut and a cover:
ffmpeg -i loud.mp4 -c:v libx264 -profile:v high -pix_fmt yuv420p -r 30 -b:v 8M -maxrate 10M -bufsize 16M -c:a aac -b:a 192k -ar 48000 -movflags +faststart final_9x16.mp4
ffmpeg -i final_9x16.mp4 -vf "crop=iw:iw*5/4:0:(ih-iw*5/4)*0.4,scale=1080:1350,setsar=1" -c:v libx264 -crf 20 -c:a copy final_4x5.mp4
ffmpeg -ss 0.5 -i final_9x16.mp4 -frames:v 1 -q:v 2 cover.jpg
Check the safe zone on a frame before delivering: the red bands must hold no text, no product and no face.
ffmpeg -ss 1 -i final_9x16.mp4 -frames:v 1 -vf "drawbox=x=0:y=0:w=iw:h=ih*0.14:color=red@0.35:t=fill,drawbox=x=0:y=ih*0.65:w=iw:h=ih*0.35:color=red@0.35:t=fill,drawbox=x=0:y=0:w=iw*0.06:h=ih:color=red@0.35:t=fill,drawbox=x=iw*0.94:y=0:w=iw*0.06:h=ih:color=red@0.35:t=fill" safezone.png
Send the same command to the varg ffmpeg tool (MCP call_tool, or POST https://api.varg.ai/v2/ffmpeg). Inputs and outputs are URLs. It is priced in credits, with an estimate before anything runs.
ecommerce-video-ads: the whole process, from angle to hooks, formats and testingproduct-video-hooks: what to say and show in the first 3 secondsad-creative-testing: how many variants to make, what to change, when to kill an adshort-form-ffmpeg-cookbook: crop, captions, trim and join, music duckingvarg-video-edit-library: 206 named edits (cuts, transitions, titles, end cards) for FFmpeg, HyperFrames, Remotion and CapCutまだレビューはありません。使ってみた感想をお寄せください。
ログインなしで書き込めます。使ってみた感想、質問、動かなかった環境などを気軽にどうぞ。
まだコメントはありません。最初のコメントを書いてみませんか。
複数の独立したローカル作業を安全性と依存関係を確認して実行計画にまとめ、対応環境では並列化やAppleシリコン向け処理の選択を支援します。
TikTokやMeta広告の勝ちパターンを分解し、異なる切り口のテスト案や予算、評価時期を整理して、数値から継続・修正・停止を判断するスキルです。
将来の読み手が理由を知りたくなる未決定や暫定対応を、技術的負債として登録し、後から項目ごとに整理できるスキルです。
LangChain、EINO、AutoGen、AgentScope、CrewAI向けのコード雛形やAPI対応、プロジェクト構成を参照し、バージョン確認を踏まえてAIエージェント開発を支援します。
エラーやテスト失敗、画面の異常などを再現して原因を特定し、テストで確認しながら影響を絞った修正を進めるデバッグ用スキルです。
対話を通じてAI Agentの要件整理から設計、ツール定義、コード生成、動作確認まで6段階で進め、実行可能なプロジェクトを作ります。