Communitygithub.com

caption-burn

完成した縦型動画に、実際の発話に合わせた字幕を焼き付けます。

caption-burn とは?

このスキルは、AIエージェントが動画広告の最終工程として、完成した縦型動画に実際の発話タイミングに同期した字幕を焼き付けるためのツール群です。`transcribe.py` が動画の音声から単語のタイミングを取得し(GooseWorks プロキシ経由の fal Whisper、課金あり)、`captions.py` が Pillow + ffmpeg で1〜3単語ずつ字幕をレンダリングします(libass 不要)。対応スタイルは、スプリット画面の継ぎ目に固定する「プレート」、輪郭線のみの「アウトライン」、固定ベースラインの「セリフワード」の3種類。さらに `plates.py` は音声のないフォーマット向けに、ビートごとに黒いブロックにまとめたキャプションを、フレーム内の最も空いている帯に配置します。最後のキャプションは最終フレームまで保持され、CTA(コールトゥアクション)として機能します。主に Claude Code や Cursor などの AI エージェント上で動作し、動画広告制作の自動化パイプラインの最終ステップとして利用されます。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/gooseworks-ai/goose-skills/tree/HEAD/skills/ads/capabilities/caption-burn

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

caption-burn は何をしますか?

完成した動画の実際の発話に同期したキャプション。スクリプトの推定ではありません。

実行方法

python transcribe.py --media reel.mp4 --out reel.words.json          # 有料、セント単位
python captions.py --video reel.mp4 --beats cutlist.aligned.json \
    --words reel.words.json --out final.mp4 [--style plate|outline] [--highlight Brand]

--beats は行 (vo)、そのタイミング、さらにスプリットレイアウトの場合は seam、size、各ビートの state を提供します。beats: [{start, end, vo}] を含む任意のファイルで動作します。

配置とスタイル

  • --anchor seam(ビートに seam がある場合のデフォルト): split ビートではプレートが継ぎ目に固定され、プレート自体がテキストではなく配置を決定します: プレートの25%が線の上、75%が下。フルフレームのビートでは --full-y を使用します。

  • --anchor fixed --y 0.62: すべてのキャプションのプレートが、その高さの割合で中央に配置されます。

  • plate(デフォルト): ダークグレーの角丸プレート上に白の太字、1〜2単語、cap 約0.019 H。

  • outline: プレートなし、白の太字にダークアウトライン、1〜3単語、cap 約0.034 H。

  • --highlight WORD でその単語を黄色にします(CTAキーワード)。繰り返し指定可能。

  • serif-word: 一度に1単語、太いセリフ体(Georgia Bold)、白文字に黒アウトライン、固定ベースライン 0.77 H(画面インサート風)。ハイライト単語は引用符で囲まれます。

  • --card "LINE ONE|LINE TWO" --card-until 4.7: 白い角丸フックカード、上部付近に2行の太い赤い大文字、冒頭の数秒間表示。1行約14文字。

音声なしフォーマット向けキャプション (plates.py)

python plates.py --video walk.mp4 --beats cutlist.json --out captioned.mp4 [--logo logo.png]

各ビートの caption(文字列または行のリスト)がビート全体にわたって1つの黒いブロック(四角形を結合し、単一のシルエットとして角丸に: 各行を個別に丸めると継ぎ目が残る)に表示され、行は左揃え、ブロックは最も幅の広い行に中央揃えされます。ビートが cap_y を指定しない限り、そのビートのフレーム内で最も空いている帯に配置されます。ビートに logo: true があると、ブロックの下にロゴタイルがぶら下がります。人が入力するような行を書いてください: 同じ短い「断片。断片。」の形を3回繰り返すとAIが書いたように見えます。絵文字は2回以上使わないでください。

ルール

  1. 完成した音声を文字起こしすること。 テイクの結合やラインの調整はタイミングを変えます。最終的な動画の音声だけが正しいキューを提供します。
  2. 最後のキャプションは最終フレームまで保持されます。 それはコールトゥアクションです。
  3. Whisper が異なる表記をする単語("200" を "two hundred" と書くなど)は、ドロップしたり行全体に引き伸ばしたりせず、隣接単語との間で補間されます。
  4. --words がない場合、タイミングは音節から推定されます。 配置の判断に使用し、出荷には絶対に使用しないでください。
  5. フォント: 太字サンセリフ体が macOS、Linux、Windows で検出されます。存在しない場合は、Roboto Bold が一度 ~/.cache/gooseworks/fonts に取得されます。--font または GW_CAPTION_FONT で上書きできます。

Individual skills in this repo

This repo contains 10 individual skills — each has its own dedicated page.

gooseworks-ai/goose-skills

Assemble a cartoon / animated / hand-crafted music-video ad from a config — a sung song carries the whole narrative while N per-bar i2v clips (one recurring animated character, one look pack) are each cut to their BAR window from librosa beat-tracking and hard-concatenated on the bar, VEED-whisper white bold-sans captions in the BOTTOM third (Alignment 2, above the logo bug, no pill) burned from the song's word timings re-spelled against the locked lyrics, a persistent brand logo bug held over the body (suppressed on the end card), and closed on a solid-brand-color PIL end card with the song still playing under it — never AI-rendered text. This is the FREE deterministic assembly stage (cut-to-bar + hard concat + logo bug + captions + end card + song mux); the song, character, keyframes, and clips come from create-music-elevenlabs / create-image-fal / create-video-fal. Use for the cartoon-music-video format.

gooseworks-ai/goose-skills

Assemble a cinematic live-action-style music-video ad from a config — an original sung anthem carries the whole narrative while N 35mm-film-look i2v clips are each cut to their lyric window and hard-concatenated on the beat as a 3-act arc, the anthem muxed at loudnorm I=-14, cinematic lower-third serif captions built from the song's OWN word timings (never Whisper) with the hook line landing on the chorus drop, and closed on a brand end card composited from the real asset — never AI-rendered text. This is the FREE deterministic assembly stage (cut-to-window + hard concat + anthem mux + captions + end card); the anthem, keyframes, and clips come from create-music-elevenlabs / create-image-gpt-image-fal / create-video-fal. Use for the cinematic-music-video format.

gooseworks-ai/goose-skills

Assemble an editorial-motion podcast-clip ad from a config — a real clipped podcast MP3 carries the narrative while N flat limited-palette editorial-illustration keyframes (one look pack) are animated NOT by generative i2v but by DETERMINISTIC ffmpeg ken-burns (zoompan) + hard cuts (no crossfades, which expose geometric drift), each beat snapped to its spoken line, the real audio muxed, Whisper-driven captions burned only mid-sentence, and closed on a PIL brand end card — never AI-rendered text. This is the FREE deterministic assembly stage (ffmpeg ken-burns + hard concat + audio mux + captions + end card); the real audio is clipped from source and the keyframes come from create-image-fal. Use for the editorial-motion-podcast format.

gooseworks-ai/goose-skills

Analyze the message match between your ads and landing pages. Checks if the promise in the ad copy carries through to the landing page headline, body, and CTA. Flags disconnects that kill conversion rates. Works with Google, Meta, and LinkedIn ads.

gooseworks-ai/goose-skills

Generate a single 4-15s vertical video clip with ByteDance Seedance 2.0 reference-to-video via fal.ai. Multi-image reference (avatar + product + setting), native lip-synced VO + ambient audio (generate-audio on by default), internal multi-cut handling within one render. Routes through the GooseWorks FAL proxy (bills the Ads agent). The default clip atom for AI-creator UGC ads built on the NB2 + Seedance architecture. Validated on beauty-by-earth/video-01.

gooseworks-ai/goose-skills

Mandatory pre-publish review gate for a UGC video render. Transcribes the finished render's AUDIO with Whisper and word-diffs it against the approved spoken script, then gates set_final_render — blocking a render whose generated audio mis-voices a word (e.g. the approved "human-vetted" spoken as "human witted"), drops an approved phrase, or comes back silent. Runnable, gating counterpart to content-goose's review-transcript-integrity atom. Every ugc-video-formats recipe runs this after render and BEFORE set_final_render.

gooseworks-ai/goose-skills

Render pixel-accurate Apple Notes (iPhone, light mode) screenshot mockups from a JSON note spec. Outputs HTML + PNG at the iPhone 16/15 Pro native 1180×2556. Supports paragraphs, images, checklists, dividers, autocorrect underline, smart quotes, and an optional iOS keyboard chrome overlay used by the parent video-ad molecule.

gooseworks-ai/goose-skills

Extract competitor and customer intelligence from any company's landing page HTML. Discovers tech stack, analytics tools, ad pixels, customer logos, SEO metadata, CTAs, hidden elements, and more. No API keys required.

gooseworks-ai/goose-skills

Find speakers, hosts, and guest profiles at conferences and events on Luma. Two modes - free direct scrape for hosts, or Apify-powered search for full guest profiles with LinkedIn/Twitter/bio.

gooseworks-ai/goose-skills

Find Twitter/X influencers to promote a product or brand. Use when asked to find influencers, discover Twitter accounts for partnerships, identify creators in a niche, or build an influencer outreach list.

関連スキル