youtube-thumbnail
Skill4 starsChanged 4 months agoMITView on GitHub
Generate premium, high-CTR YouTube thumbnails (1920x1080) in a consistent series style — dark background, clay-orange accent (#D97757), the author's real face, a punch headline, and a brand logo. Use this WHENEVER the user asks for a YouTube cover/обложка/thumbnail, wants a face pulled from a video onto a cover, wants to "play with the font" on a cover, or wants a thumbnail in a fixed brand style. Default pipeline (MANDATORY): gpt-image-2 with EXACTLY 5 references — two real face photos + two reference covers + one brand logo — to copy the reference style with the real large face. Deterministic fallback: scripts/yt-boxes.mjs (no GPT).
- Installs packages
15 other projects use a version of this.
Adopted by
Most recently taken up by
- Thibaultbm/claude-seo-geotheir own version, first seen Nov 8, 2026
- hassancs91/claude-youtube-editortheir own version, first seen Nov 5, 2026
- rami-maalouf/skillstheir own version, first seen Nov 1, 2026
- timscheuerai/content-vaulttheir own version, first seen Oct 15, 2026
- shutckin/aivfx-content-kittheir own version, first seen Oct 8, 2026
- t0ddharris/compound-marketingtheir own version, first seen Oct 8, 2026
Used with
Projects with it also use long-form and youtube-description.
Other files people use alongside this one.
Files found in the same public projects as a version of this one, more often than they turn up anywhere else. Each project counts once, large collections count for less, and this file's own repository is left out.
timscheueraiSkilllong-form
Draft written long-form content (newsletter issue, blog post, Substack issue) in your voice. 800-2000 words, structured intro + body + CTA, paragraph-by-paragraph not list-by-list. Pulls voice from /linkedin-copywriter's corpus (same author, same register · longer arc). Runs the brand-doc skill checklist before output. Logs the row in the Notion Content DB and (for newsletters) drafts a separate punchy subject line. Use when asked to "write a newsletter", "draft a blog post", "long-form X", "Substack issue about Y", "weekly newsletter", or "/long-form". For spoken video scripts (YouTube longs / shorts) use /youtube-script instead · the cadence is fundamentally different.
Also in 3 projects that use this
pamelafoxSkillyoutube-description
Generate a YouTube description with a brief intro, relevant links, and clickable timestamps for each question.
Also in 3 projects that use this
Other versions15 projects use a version of this.
Word for word · 0
None found.
Edited · 0
None found.
Wrote their own version · 15
- charlie947/social-media-skills★ 4.4ksame name
- hassancs91/claude-youtube-editor★ 368same name
- magnus919/agent-skills★ 177same name
- timscheuerai/content-vault★ 38same name
- alebgl77/claude-inc★ 21same name
- Thibaultbm/claude-seo-geo★ 18same name
- plushyta/Awesome-Marketing-Skills★ 13same name
- rbrown101010/Rileys-Top-Skills★ 9same name
- rami-maalouf/skills★ 2same name
- timscheuerai/gtm-architecture-template★ 2same name
5 more not listed
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
In this repository43 other files it gives its agents.
- agent-browserSkill
- agent-introspectionSkill
- agentos-contentSkill
- carousel-instagramSkill
- chat-archiveSkill
- codex-imageSkill
- content-engineSkill
- cross-reviewSkill
- datawrapperSkill
- dev-pipelineSkill
- excalidrawSkill
- fast-loop-codingSkill
- groq-voiceSkill
- higgsfield-generateSkill
- higgsfield-marketplace-cardsSkill
- higgsfield-product-photoshootSkill
- higgsfield-soul-idSkill
- instagram-superpowerSkill
- learningsSkill
- loop-codingSkill
- markdown-newSkill
- mcp-api-buildSkill
- mcp-builderSkill
- memory-auditSkill
- miro-boardSkill
- perplexity-researchSkill
- presentSkill
- reel-radarSkill
- reels-analytics-for-brokersSkill
- reelsSkill
- remote-agent-desktopSkill
- security-auditSkill
- senior-brainstormSkill
- seo-tuneSkill
- server-doctorSkill
- telegram-chipSkill
- threads-contentSkill
- topic-monitorSkill
- transcriptSkill
- twitterSkill
- workshopSkill
- youtube-producerSkill
- yt-researchSkill
The file
We split this skill into the rules it gives an agent
4 rules. 0 are common, 2 are distinctive, and 2 are very specific to this project.
0
Common
Most of the 13 edited versions we read keep these.
2
Distinctive
This author's own choices. Worth a look.
2
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Very specific: line 17
Default palette: clay-orange #D97757, cream #F3EEE3, near-black #0A0806 (change it to your brand in the prompt and in the scripts' …
- Distinctive: line 45
If two face photos are already provided, use them directly.
- Distinctive: line 117
Eyes rule: only frames with fully open eyes and a direct gaze.
- Very specific: line 143
Run (run.sh is NOT on PATH — use the full path.
“Common” is measured: kept by at least 6 in 10 of the 13 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
YouTube Thumbnail Generator
Make a 1920×1080 thumbnail that is cohesive, catchy, and readable at small size.
Default palette: clay-orange #D97757, cream #F3EEE3, near-black #0A0806 (change it to
your brand in the prompt and in the scripts' constants). Logos: any PNG, or an official SVG
from the logo-company skill rasterized with scripts/rasterize-logo.mjs.
Working dir for a job: ~/yt-covers/ (or any folder you choose) with subfolders
facerefs/ (approved face photos), refcovers/ (style examples), picks/, cutouts/, out/.
Engine — primary + fallback (no improvising)
Primary (MANDATORY, default for every cover): GPT full-generation via gpt-image-2 using EXACTLY 5 references — two real face photos, two reference covers, one brand logo — see MANDATORY pipeline below. This is what produces the dark + accent glow + yellow-box look with a real LARGE face and crisp Russian text.
Fallback only: scripts/yt-boxes.mjs (no GPT, fully deterministic text) — use ONLY when the user
asks for exact deterministic text control, or GPT/Codex is unavailable. yt-thumb.mjs / cutout.py are
building blocks for that fallback.
Steps 1–5 below are the building blocks; the MANDATORY pipeline section is the exact order to run them.
Pipeline
1. Face from video
# probe + grab evenly-spaced frames (ffmpeg -ss BEFORE -i = fast seek)
ffprobe -v error -show_entries format=duration -of csv=p=0 in.mp4
ffmpeg -y -ss <sec> -i in.mp4 -frames:v 1 -q:v 2 frame.pngIf two face photos are already provided, use them directly. If only a video is given: make a numbered
contact sheet (tile filter), send it, and STOP until exactly two frame numbers are chosen — before any GPT
generation. Save the two final close crops as facerefs/face1.jpg and facerefs/face2.jpg.
ZSH GOTCHA: zsh does NOT glob * from a variable (bash does) — hardcode timestamps or list filenames explicitly.
2a. Real cutout (fallback engine) — rembg
<skill>/.venv/bin/python scripts/cutout.py picks/13.png cutouts/13.pngVertical phone video = 2160×3840 → resize to h≤1280 before cutout (cutout.py does it). rembg model u2net_human_seg, Python API (NOT CLI). venv: see Setup.
2b. Face refs for GPT — close crops
Crop tight frontal faces (better likeness than one wide shot). Crop coords are FRAME-SPECIFIC — re-derive
crop=W:H:X:Y per frame; the values below are an example for one frame, do not reuse blindly:
ffmpeg -y -i picks/13.png -vf "crop=1300:1300:430:760,scale=720:720" facerefs/face1.jpg3. Scene / base via gpt-image-2
run.sh "prompt" high landscape [ref1..ref5] — the codex-image skill, OAuth subscription (no API key).
Refs as input_image (≤5). Cyrillic in text renders CLEAN usually, but the → arrow
garbles — write "to"/"до". For a no-text base, prompt for NO text, left half empty.
Prompt core: "exact same person as in the reference photos, preserve real face/glasses/hair,
do NOT beautify; right side; dark charcoal + clay-orange #D97757 glow, terminal code,
AI-agent nodes; high contrast; no watermark".
4. Compose text + logo (fallback engine) — scripts/yt-thumb.mjs
node scripts/yt-thumb.mjs --scene /abs/SCENE.png --face /abs/cutout.png \
--logo /abs/logo.svg \
--eyebrow "CLAUDE CODE" --l1 "АГЕНТЫ" --l2 "ДЛЯ БИЗНЕСА" \
--font oswald --fs 104 --faceside right --out /abs/out.png--sceneABSOLUTE path (code doesfile://+path; relative → black bg).--faceoptional (omit when the face is baked into the GPT base).--l2renders in the accent color.--faceside right|left(text goes opposite, scrim there).--fsfont size (default 150; long lines like "ДЛЯ БИЗНЕСА" → ~104).--font: intertight (default) · montserrat · oswald · russo · unbounded · rubik · manrope (all Cyrillic-capable, thumbnail-strong). "Play with font" = render several.- Logo PNG from SVG:
node scripts/rasterize-logo.mjs logo.svg out.png 600.
5. Finalize 1920×1080
gpt-image outputs ~1536×1024/1672×941 → crop/scale to exactly 1920×1080:
ffmpeg -y -i in.png -vf "scale=1920:1080:force_original_aspect_ratio=increase,crop=1920:1080" out.pngQA: ffmpeg -y -i out.png -vf scale=360:-1 qa-360.png — pass ONLY if the full Russian headline is spelled
exactly, the KEYWORD sits inside a yellow box, and every word is readable. If not: regenerate once; still
bad → fall back to scripts/yt-boxes.mjs.
MANDATORY pipeline — how this skill makes a cover (deterministic)
This is the strict, non-negotiable function of the skill. Every cover follows EXACTLY these steps — do not prompt a scene from scratch and do not improvise the inputs. SHOW gpt-image the style with example covers and let it copy it, with the real face large.
Steps (always, in order):
- Two face photos of the author — cut from a video (steps 1 / 2b) or otherwise sourced. Clear, frontal, large.
- Two reference covers + one brand logo — the style examples to copy + the logo used on the cover.
- One prompt — copy the reference style, keep the real face LARGE, set the exact headline.
- Load all 5 into gpt-image-2 (codex-image, OAuth) → it outputs the cover in-style with the face + text.
- Finalize to 1920×1080 (ffmpeg, above).
The point: the cover must look like the reference AND carry the real face AND the chosen headline — that is only guaranteed by feeding examples + photos + logo together, not by describing the style in words.
Upload to gpt-image — STRICTLY these 5 refs:
1–2. TWO live face photos of the person — ALWAYS from one canonical face library (facerefs/:
pre-cut frames from one good studio video, each outfit as a separate file). NEVER improvise face
refs from ad-hoc phone or carousel photos — a random photo gives a wrong face/likeness.
Pick two clear frontal ones; crop tighter only if needed.
Eyes rule: only frames with fully open eyes and a direct gaze. The prompt adds
«eyes fully open, gaze exactly as in the reference, do not redraw the face». Move rejected
blink / squint / side-gaze frames into facerefs/_rejected/ and never use them: one half-closed
eye in a reference is copied onto every cover.
3–4. TWO reference covers in the target style. If the user gives exact target covers, use those two.
Otherwise use two fixed files from refcovers/ (keep 10–15 examples of the one style you copy,
e.g. dark background + yellow highlight box) so the whole series stays consistent.
5. ONE brand logo as PNG (e.g. logos/product-logo.png).
Cover about ANOTHER brand (OpenAI, Gemini, etc.) — keep your style, swap the mark:
The layout + your face IS your style — reuse it for any topic. To brand it for a different company:
(a) get its logo SVG from logo-company (find-logo.sh openai default), (b) rasterize → PNG
(node scripts/rasterize-logo.mjs <svg> <out.png> 600), (c) use it as ref #5 INSTEAD of your usual logo,
(d) in the prompt say EXPLICITLY: «do NOT draw the <YOUR USUAL MARK>; instead prominently feature the
<BRAND> logo (from the logo reference) near top center» — else gpt-image copies the mark it sees on the
two reference covers. Keep refs #3–4 for the STYLE.
Prompt core — the FACE MUST BE LARGE:
Design a 16:9 YouTube thumbnail that copies the EXACT visual style of the reference cover images: solid near-black background, subtle terminal-window outlines + code texture, a heavy bold headline with a bright YELLOW highlight box on the key word, brand label top-left. Use the person from the face photos — the REAL face/glasses/hair, do NOT beautify — shown LARGE and close-up on the RIGHT, sharp, looking at camera. Eyes fully open, gaze exactly as in the reference, do not redraw the face. Headline left: '
<HEADLINE>' with '<KEYWORD>' in a yellow box. Render the Russian text exactly as written. Crisp, high-contrast, no watermark.
Run (run.sh is NOT on PATH — use the full path; ALL refs absolute):
~/.claude/skills/codex-image/scripts/run.sh "$PROMPT" high landscape \
/abs/facerefs/face1.jpg /abs/facerefs/face2.jpg \
/abs/refcovers/01.jpg /abs/refcovers/02.jpg \
/abs/logos/product-logo.pngThen finalize to 1920×1080 (step 5). The reference covers make gpt render crisp Cyrillic IN-STYLE (no garble) — this is why we feed examples instead of describing the style.
With the current codex-image skill you can do the same through its brief: brief.py init brief.json --type
youtube-cover, a registry preset with these 5 refs, brief.py check, brief.py prompt (it adds the eyes
constraint itself and refuses refs from _rejected/).
Deterministic fallback (your own text, no gpt): scripts/yt-boxes.mjs — solid dark bg; markup inside
--l1/--l2: [[word]]=yellow box, <<word>>=white box, plain=white text; real rembg face cutout (right);
brand icon; --eyebrow. Perfect Cyrillic.
cd ~/.claude/skills/youtube-thumbnail
node scripts/yt-boxes.mjs --l1 "[[АГЕНТЫ]] ДЛЯ" --l2 "YOUTUBE" --eyebrow "CLAUDE CODE" \
--face /abs/cutout.png --icon /abs/logos/product-logo.png --font inter --out /abs/out.pngSetup (once)
cd ~/.claude/skills/youtube-thumbnail
python3 -m venv .venv && .venv/bin/pip install rembg onnxruntime pillow
npm i playwright && npx playwright install chromium # if chromium-headless-shell missinggpt-image setup: install the codex-image skill and Codex CLI (npm install -g @openai/codex), then
codex login (or codex login --device-auth). The codex-image run.sh bootstraps its own Python venv on first run.
Also needed: ffmpeg / ffprobe on PATH.
References
references/recipes.md— prompts, palette, font notes.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

