YouTube thumbnail workflow: one promise, frames from footage, short outlined text, feed-size previews, A/B variants. Use when a video needs a thumbnail.
The thumbnail and the title are the whole pitch before anyone presses play. This skill is the video domain's thumbnail pipeline: decide the promise, get the best possible picture of it from the footage or a generated scene, put a real cut-out face or product on it, set two to five words of type with a renderer that measures and fits them, and check the result at the size people actually see it. It replaces drawing text onto frames with PIL or asking an image model to spell the headline, which give soft, misspelled, badly placed text.
Mental model
A thumbnail does one job: make one promise the video keeps, readable in under a second at about 360 px wide on a phone or 168 px in a sidebar.
The picture carries the emotion or the stakes: a face, a result, a before/after, the product in use.
The text adds what the title doesn't say. It never repeats the title.
Contrast, size, and placement decide whether it survives the feed; detail does not survive.
The renderer is the video-thumbnail command, installed on PATH with the thumbnails capability (the same file is the bundled scripts/thumbnail.py, listed under Skill Resources). It needs python3 and an ffmpeg with libass, which it finds on its own, including Homebrew's keg-only ffmpeg-full. Fonts come with the capability in ~/.local/share/octomind/fonts. video-thumbnail render --help lists every option.
Rules
Specs (checked 2026-10)
Surface
Size to render
Notes
YouTube long-form
--format youtube (1920x1080, under 2 MB) or youtube-4k (3840x2160)
16:9, minimum 640 px wide, JPG or PNG. Desktop upload takes up to 50 MB, mobile 2 MB. Custom thumbnails need a verified channel
YouTube Shorts
--format shorts (1080x1920)
Custom Shorts thumbnails rolled out 2026-07-24 to Partner Program channels, desktop Studio only; elsewhere pick a frame
Vertical video with a 16:9 thumbnail
Keep the subject centered
YouTube auto-crops a 4:5 version for Home, Explore, Subscriptions
TikTok cover
--format tiktok (1080x1920)
Picked from a frame or uploaded in the app; the profile grid crops the center to about 3:4. Assume API posts can't set an uploaded cover
Instagram Reels cover
--format reels (1080x1920)
Frame or uploaded image; the profile grid crops the center to 3:4 (since January 2025)
LinkedIn video
--format linkedin (1920x1080)
Desktop upload option; ads take JPG/PNG up to 2 MB at the video's aspect
Square / portrait feed
--format square / portrait
1080x1080, 1080x1350
What drives the click (descriptive studies, not proof of cause)
Faces appear in 69% of 500 breakout thumbnails (80% of the top 50), usually filling about a third of the frame (vidIQ, 2026). A larger dataset (1of10, 2025) finds faces and no-faces perform about the same overall, with big differences by niche. Use a face when the person is the draw or the emotion is the story; use the result or the object when that is the promise.
Readable emotion beats theatre: shocked faces are a small minority (5–11%); neutral, focused, and happy faces dominate.
Text: 72% carry text, median 5 words, and "no text" is the single most common bucket. Default to 0–4 words. The renderer warns above 5 (6 for vertical covers).
High contrast shows up in more than half of breakout thumbnails. One focal subject, one accent color.
YouTube's own guidance: an easy-to-read font, rule of thirds, a relatable emotion, title and thumbnail working together, and shooting dedicated thumbnail photos during the shoot.
Keep text and faces out of the bottom-right corner (duration badge) and the bottom strip (progress bar). The renderer's layouts already do; it warns when text reaches there.
Pipeline
Promise. Write the one-line promise and the title first. The thumbnail shows the payoff, stakes, or tension; the text adds one beat the title leaves out ("I quit" + title "Why I left Google after 8 years").
Background, in order of preference:
A real frame. video-thumbnail frames master.mp4 -o thumbs/frames --count 12 writes 12 lossless candidates with timestamps and sheet.jpg. View sheet.jpg with read_media_file, then open the shortlisted frames at full size and pick the sharpest, most expressive one; ask the user to choose when an image can't be read.
A dedicated thumbnail photo from the shoot.
A generated scene: generate_image with aspectRatio 16:9 or 9:16, imageSize 2K or 4K, and "no text, no letters" in the prompt. Pass real product photos or the person's photo as inputImagePaths to keep identity and packaging true. Never generate a real person's face from scratch.
Subject cut-out (optional, strong for faces and products): uvx --python 3.12 --from "rembg[cpu,cli]==2.0.86" rembg i -m birefnet-portrait frame.png thumbs/subject.png for people, -m isnet-general-use for products. The first run downloads the model, up to about 1 GB for BiRefNet. Check the edge on hair and fingers in the preview.
Render:
video-thumbnail render thumbs/frames/frame-07.png -o thumbs/a.jpg \
--text "I quit my job" --highlight quit --subject thumbs/subject.png --stroke 12 \
--layout left --title "Why I left Google after 8 years" --preview thumbs/a-preview.png
Check the preview (--preview): the image at 360 px and 168 px on dark and light UI with the duration badge drawn in. View it with read_media_file; the text must read at 168 px. If an image can't be read, rely on the warnings and tell the user which preview to check and that legibility is unverified.
Variants. Make three for YouTube Test & Compare, each changing one variable: face vs object, text vs no text, or framing. Name them a.jpg, b.jpg, c.jpg.
Renderer choices
Choice
Options
Use
--style
bold (caps, black outline, accent word), box (rounded text boxes), clean (sentence case on a darkened side)
Creator and entertainment / explainers and news / B2B and premium
--layout
left, right, top, bottom, center
Text side; a --subject goes opposite (bottom-center for top/vertical)
--highlight WORD
Repeatable
One accent word, usually the verb or the number
--font
Poppins Black, Poppins ExtraBold, Anton, Archivo Black, Bebas Neue, or a brand font via --fontsdir
Keep one family per channel
--darken, --grade
Gradient strength 0–1; pop or none
Raise --darken if the contrast warning fires
--crop-x, --crop-y
0–1
Shift the crop when the source aspect differs
The renderer measures each candidate line with libass, picks the split that allows the largest type, avoids lines ending on "I", "the", or "my", and stacks lines on a cap/descender grid. Pass the text plainly; don't add line breaks.
Policy
YouTube removes thumbnails that mislead viewers about the content, are sexual, shock with violence or gore, use vulgar text, or impersonate. Borderline ones get age-restricted or removed; repeat violations can cost custom thumbnails for 30 days.
Egregious clickbait (a promise the video doesn't keep, especially news and current events) is enforced with removals.
AI-generated or AI-edited thumbnails need no synthetic-content label, but the misleading and impersonation rules still apply.
Thumbnails on ads also fall under Google Ads clickbait rules: no "you won't believe", no fake shock, no fear of negative life events.
Sponsored content: when the image itself endorses a product, the disclosure must be visual and on the image (FTC).
Examples
Example 1: text by the image model
❌ generate_image with the prompt "YouTube thumbnail, man shocked, big yellow text I QUIT MY JOB". The letters come out soft at feed size, the line split is arbitrary, and a variant with different text means a new image.
✅ Generate or pick the scene without text, cut out the face, and set "I quit" with video-thumbnail render ... --highlight quit. A text variant is one more command.
Example 2: title repeated
❌ Title "How we cut churn in half", overlay "HOW WE CUT CHURN IN HALF". The renderer warns; the thumbnail adds nothing.
✅ Overlay "One email" over the dashboard showing the drop: the title says what, the thumbnail shows the surprising how.
Example 3: Reels cover outside the grid crop
❌ Text placed at the very top of a 1080x1920 cover: the 3:4 profile grid cuts it off.
✅ --format reels --layout top keeps the text inside the centered 3:4 area; the preview shows both the full frame and the grid crop.
Checklist
One promise; overlay text adds to the title instead of repeating it; 0–5 words.
Background from a real frame, a shoot photo, or a text-free generated scene; real faces and products not invented.
Rendered with video-thumbnail at the platform format; no font, contrast, badge, or grid-crop warnings left unexplained.
Preview checked at 168 px, or reported to the user as unchecked.
Three single-variable variants for YouTube Test & Compare when the channel can use it.
Nothing misleading, sexual, gory, or impersonating; sponsored images carry a visual disclosure.
Files saved under ./video-out/<slug>/thumbs/ (variants, previews, the chosen frame, the cut-out).
Composition / References
video-hooks — the promise the thumbnail and the first three seconds share.
video-spec-sheet — platform specs and safe zones for the video itself.
video-editing — finding the strongest moments; the thumbnail frame often comes from the hook.
1---2name: video-thumbnails3title: "YouTube Thumbnail Maker: Shorts, Reels, and TikTok Covers"4description: "YouTube thumbnail workflow: one promise, frames from footage, short outlined text, feed-size previews, A/B variants. Use when a video needs a thumbnail."5license: Apache-2.06compatibility: "Requires: python3 and an ffmpeg built with libass (macOS: Homebrew ffmpeg-full). Optional: uvx for rembg subject cut-outs. macOS/Linux."7capabilities: shell thumbnails image-view8domains: video9rules:10 - session(thumbnail)11 - session(editor)12 - session(clips)13 - content(thumbnail)14 - content(thumbnails)15 - match(\b(cover|thumb)\s+(image|frame|art)\b)16 - match(\btest\s*(&|and)\s*compare\b)17 - semantic(make a youtube thumbnail for this video)18 - semantic(design three thumbnail variants to a/b test)19 - semantic(pick a cover frame for my reel)20metadata:21 source: https://skillmd.com/skills/muvon/video-thumbnails22---2324## Overview2526The thumbnail and the title are the whole pitch before anyone presses play. This skill is the video domain's thumbnail pipeline: decide the promise, get the best possible picture of it from the footage or a generated scene, put a real cut-out face or product on it, set two to five words of type with a renderer that measures and fits them, and check the result at the size people actually see it. It replaces drawing text onto frames with PIL or asking an image model to spell the headline, which give soft, misspelled, badly placed text.2728## Mental model2930A thumbnail does one job: make one promise the video keeps, readable in under a second at about 360 px wide on a phone or 168 px in a sidebar.3132- The picture carries the emotion or the stakes: a face, a result, a before/after, the product in use.33- The text adds what the title doesn't say. It never repeats the title.34- Contrast, size, and placement decide whether it survives the feed; detail does not survive.3536The renderer is the `video-thumbnail` command, installed on PATH with the `thumbnails` capability (the same file is the bundled `scripts/thumbnail.py`, listed under Skill Resources). It needs python3 and an ffmpeg with libass, which it finds on its own, including Homebrew's keg-only `ffmpeg-full`. Fonts come with the capability in `~/.local/share/octomind/fonts`. `video-thumbnail render --help` lists every option.3738## Rules3940### Specs (checked 2026-10)4142| Surface | Size to render | Notes |43|---|---|---|44| YouTube long-form | `--format youtube` (1920x1080, under 2 MB) or `youtube-4k` (3840x2160) | 16:9, minimum 640 px wide, JPG or PNG. Desktop upload takes up to 50 MB, mobile 2 MB. Custom thumbnails need a verified channel |45| YouTube Shorts | `--format shorts` (1080x1920) | Custom Shorts thumbnails rolled out 2026-07-24 to Partner Program channels, desktop Studio only; elsewhere pick a frame |46| Vertical video with a 16:9 thumbnail | Keep the subject centered | YouTube auto-crops a 4:5 version for Home, Explore, Subscriptions |47| TikTok cover | `--format tiktok` (1080x1920) | Picked from a frame or uploaded in the app; the profile grid crops the center to about 3:4. Assume API posts can't set an uploaded cover |48| Instagram Reels cover | `--format reels` (1080x1920) | Frame or uploaded image; the profile grid crops the center to 3:4 (since January 2025) |49| LinkedIn video | `--format linkedin` (1920x1080) | Desktop upload option; ads take JPG/PNG up to 2 MB at the video's aspect |50| Square / portrait feed | `--format square` / `portrait` | 1080x1080, 1080x1350 |5152### What drives the click (descriptive studies, not proof of cause)5354- Faces appear in 69% of 500 breakout thumbnails (80% of the top 50), usually filling about a third of the frame (vidIQ, 2026). A larger dataset (1of10, 2025) finds faces and no-faces perform about the same overall, with big differences by niche. Use a face when the person is the draw or the emotion is the story; use the result or the object when that is the promise.55- Readable emotion beats theatre: shocked faces are a small minority (5–11%); neutral, focused, and happy faces dominate.56- Text: 72% carry text, median 5 words, and "no text" is the single most common bucket. Default to 0–4 words. The renderer warns above 5 (6 for vertical covers).57- High contrast shows up in more than half of breakout thumbnails. One focal subject, one accent color.58- YouTube's own guidance: an easy-to-read font, rule of thirds, a relatable emotion, title and thumbnail working together, and shooting dedicated thumbnail photos during the shoot.59- Keep text and faces out of the bottom-right corner (duration badge) and the bottom strip (progress bar). The renderer's layouts already do; it warns when text reaches there.6061### Pipeline62631. Promise. Write the one-line promise and the title first. The thumbnail shows the payoff, stakes, or tension; the text adds one beat the title leaves out ("I quit" + title "Why I left Google after 8 years").642. Background, in order of preference:65 - A real frame. `video-thumbnail frames master.mp4 -o thumbs/frames --count 12` writes 12 lossless candidates with timestamps and `sheet.jpg`. View `sheet.jpg` with `read_media_file`, then open the shortlisted frames at full size and pick the sharpest, most expressive one; ask the user to choose when an image can't be read.66 - A dedicated thumbnail photo from the shoot.67 - A generated scene: `generate_image` with `aspectRatio` 16:9 or 9:16, `imageSize` 2K or 4K, and "no text, no letters" in the prompt. Pass real product photos or the person's photo as `inputImagePaths` to keep identity and packaging true. Never generate a real person's face from scratch.683. Subject cut-out (optional, strong for faces and products): `uvx --python 3.12 --from "rembg[cpu,cli]==2.0.86" rembg i -m birefnet-portrait frame.png thumbs/subject.png` for people, `-m isnet-general-use` for products. The first run downloads the model, up to about 1 GB for BiRefNet. Check the edge on hair and fingers in the preview.694. Render:7071```bash72video-thumbnail render thumbs/frames/frame-07.png -o thumbs/a.jpg \73 --text "I quit my job" --highlight quit --subject thumbs/subject.png --stroke 12 \74 --layout left --title "Why I left Google after 8 years" --preview thumbs/a-preview.png75```76775. Check the preview (`--preview`): the image at 360 px and 168 px on dark and light UI with the duration badge drawn in. View it with `read_media_file`; the text must read at 168 px. If an image can't be read, rely on the warnings and tell the user which preview to check and that legibility is unverified.786. Variants. Make three for YouTube Test & Compare, each changing one variable: face vs object, text vs no text, or framing. Name them `a.jpg`, `b.jpg`, `c.jpg`.7980### Renderer choices8182| Choice | Options | Use |83|---|---|---|84| `--style` | `bold` (caps, black outline, accent word), `box` (rounded text boxes), `clean` (sentence case on a darkened side) | Creator and entertainment / explainers and news / B2B and premium |85| `--layout` | `left`, `right`, `top`, `bottom`, `center` | Text side; a `--subject` goes opposite (bottom-center for top/vertical) |86| `--highlight WORD` | Repeatable | One accent word, usually the verb or the number |87| `--font` | Poppins Black, Poppins ExtraBold, Anton, Archivo Black, Bebas Neue, or a brand font via `--fontsdir` | Keep one family per channel |88| `--darken`, `--grade` | Gradient strength 0–1; `pop` or `none` | Raise `--darken` if the contrast warning fires |89| `--crop-x`, `--crop-y` | 0–1 | Shift the crop when the source aspect differs |9091The renderer measures each candidate line with libass, picks the split that allows the largest type, avoids lines ending on "I", "the", or "my", and stacks lines on a cap/descender grid. Pass the text plainly; don't add line breaks.9293### Policy9495- YouTube removes thumbnails that mislead viewers about the content, are sexual, shock with violence or gore, use vulgar text, or impersonate. Borderline ones get age-restricted or removed; repeat violations can cost custom thumbnails for 30 days.96- Egregious clickbait (a promise the video doesn't keep, especially news and current events) is enforced with removals.97- AI-generated or AI-edited thumbnails need no synthetic-content label, but the misleading and impersonation rules still apply.98- Thumbnails on ads also fall under Google Ads clickbait rules: no "you won't believe", no fake shock, no fear of negative life events.99- Sponsored content: when the image itself endorses a product, the disclosure must be visual and on the image (FTC).100101## Examples102103### Example 1: text by the image model104105❌ `generate_image` with the prompt "YouTube thumbnail, man shocked, big yellow text I QUIT MY JOB". The letters come out soft at feed size, the line split is arbitrary, and a variant with different text means a new image.106107✅ Generate or pick the scene without text, cut out the face, and set "I quit" with `video-thumbnail render ... --highlight quit`. A text variant is one more command.108109### Example 2: title repeated110111❌ Title "How we cut churn in half", overlay "HOW WE CUT CHURN IN HALF". The renderer warns; the thumbnail adds nothing.112113✅ Overlay "One email" over the dashboard showing the drop: the title says what, the thumbnail shows the surprising how.114115### Example 3: Reels cover outside the grid crop116117❌ Text placed at the very top of a 1080x1920 cover: the 3:4 profile grid cuts it off.118119✅ `--format reels --layout top` keeps the text inside the centered 3:4 area; the preview shows both the full frame and the grid crop.120121## Checklist122123- [ ] One promise; overlay text adds to the title instead of repeating it; 0–5 words.124- [ ] Background from a real frame, a shoot photo, or a text-free generated scene; real faces and products not invented.125- [ ] Rendered with `video-thumbnail` at the platform format; no font, contrast, badge, or grid-crop warnings left unexplained.126- [ ] Preview checked at 168 px, or reported to the user as unchecked.127- [ ] Three single-variable variants for YouTube Test & Compare when the channel can use it.128- [ ] Nothing misleading, sexual, gory, or impersonating; sponsored images carry a visual disclosure.129- [ ] Files saved under `./video-out/<slug>/thumbs/` (variants, previews, the chosen frame, the cut-out).130131## Composition / References132133- `video-hooks` — the promise the thumbnail and the first three seconds share.134- `video-spec-sheet` — platform specs and safe zones for the video itself.135- `video-editing` — finding the strongest moments; the thumbnail frame often comes from the hook.136- [YouTube: add video thumbnails](https://support.google.com/youtube/answer/72431)137- [YouTube: Test & Compare](https://support.google.com/youtube/answer/13861714)138- [YouTube: thumbnail best practices](https://support.google.com/youtube/answer/12340300)139- [YouTube thumbnail policy](https://support.google.com/youtube/answer/9229980)140- [YouTube Studio custom thumbnail updates, 2026-07-24](https://blog.youtube/news-and-events/youtube-studio-custom-thumbnail-updates/)141- [vidIQ thumbnail study, 2026](https://vidiq.com/research/youtube-thumbnail-study/)142- [rembg](https://github.com/danielgatis/rembg)
Run npx get-skill add muvon/video-thumbnails 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.
YouTube thumbnail workflow: one promise, frames from footage, short outlined text, feed-size previews, A/B variants. Use when a video needs a thumbnail. It is listed under Productivity on SkillMD.
This skill has not completed SkillMD's automated safety review yet. Capability flags: executes scripts, makes network calls. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.
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.
Yes. Installing skills from SkillMD is free. This skill is licensed under Apache-2.
Muvon (@muvon) published this skill. Their other Agent Skills are listed on their SkillMD profile.