Agent skill

Youtube Thumbnails

by ericrisco in ericrisco/rsc-harness

A skill your agent uses when designing or fixing a YouTube thumbnail, making variants for an A/B test, or working out which thumbnail style wins on a channel — including the trap where CTR looks…

MITAuto-check passedMedia & Creative

Install Youtube Thumbnails

skills CLI
$ npx skills add ericrisco/rsc-harness --skill youtube-thumbnails -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install ericrisco/rsc-harness youtube-thumbnails --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/ericrisco/rsc-harness.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/youtube-thumbnails .claude/skills/youtube-thumbnails && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
youtube-thumbnails
GitHub stars
167
Token cost
~2.4k tokens
SKILL.md length
1,246 words
Files
6 (incl. scripts, references)
Skills in repo
227
Repo updated
First seen
Licence
MIT

At a glance

A skill your agent uses when designing or fixing a YouTube thumbnail, making variants for an A/B test, or working out which thumbnail style wins on a channel — including the trap where CTR looks…

  • Works in 4 steps: Design 2-3 candidate concepts that… → Test them in YouTube Studio "Test &… → Log the outcome to… → …
  • Fixing a YouTube thumbnail
  • SKILL.md covers The loop, Hard constraints, Composition rules and Text rules, plus 6 more sections
  • Runs Shell scripts from its folder

What it does

Youtube Thumbnails is an agent skill from ericrisco/rsc-harness. Use when designing or fixing a YouTube thumbnail, making variants for an A/B test, or working out which thumbnail style wins on a channel — including the trap where CTR looks fine but the test keeps selecting the duller image on watch-time share. NOT pairing the title with the thumbnail as one click-promise (that is youtube-packaging), NOT channel positioning or niche (that is youtube-strategy), NOT setting a thumbnail through the Data API (that is youtube-api).

Its SKILL.md is about 2.4k tokens, which your agent loads only when the skill is triggered. The skill folder holds 8 other files, including scripts and reference files (for example `evals/README.md`, `evals/cases.yaml` and `references/composition-and-specs.md`).

It sits in Media & Creative, covering A/B testing. It works with YouTube. The repository describes itself as: Your agent invents things because it has no memory, and can't touch your database because it has no arms. rsc is the meta-harness that gives it both, plus the trade to know the… The licence is MIT.

When your agent uses it

  • Fixing a YouTube thumbnail
  • Making variants for an A/B test

Example prompts

  • “/youtube-thumbnails”

Requirements

  • A Bash shell

Workflow steps

4 steps, taken from the first numbered list in SKILL.md.

  1. Design 2-3 candidate concepts that differ on exactly ONE testable axis.
  2. Test them in YouTube Studio "Test & Compare".
  3. Log the outcome to 02-DOCS/wiki/youtube/thumbnail-experiments.md.
  4. Learn: mine the log into thumbnail-patterns.md (what wins on THIS

What it can do on your machine

Read from SKILL.md and the folder at commit e3d5b33. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships 1 file in scripts/ (Shell), which the agent can run.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Youtube Thumbnails loads about 2.4k tokens when it runs, and up to ~4.2k if it reads all its reference files. Until then it costs about 123 tokens; SKILL.md has 1,246 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~123
When it runs · the whole SKILL.md, loaded when a task matches
~2.4k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~4.2k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

The full file from ericrisco/rsc-harness at commit e3d5b33, republished under its MIT licence (© ericrisco). 1,246 words, ~2,402 tokens.

Download SKILL.mdSave it as .claude/skills/youtube-thumbnails/SKILL.md (or your agent's skills folder). This skill also uses 5 other files; get the full folder from GitHub.
name
youtube-thumbnails
description
Use when designing or fixing a YouTube thumbnail, making variants for an A/B test, or working out which thumbnail style wins on a channel — including the trap where CTR looks fine but the test keeps selecting the duller image on watch-time share. NOT pairing the title with the thumbnail as one click-promise (that is `youtube-packaging`), NOT channel positioning or niche (that is `youtube-strategy`), NOT setting a thumbnail through the Data API (that is `youtube-api`).
tags
youtube, thumbnails, ctr, ab-testing, design
recommends
youtube-packaging, youtube-strategy, ab-testing, design
origin
risco

YouTube thumbnails

Design thumbnails that survive the mobile feed, test them so the winner is a lesson and not a coin flip, and write every outcome back to the channel's wiki so the next thumbnail is evidence-led. A thumbnail you cannot learn from is half wasted.

The loop

This skill runs a closed loop, not a one-off design pass:

  1. Design 2-3 candidate concepts that differ on exactly ONE testable axis.
  2. Test them in YouTube Studio "Test & Compare".
  3. Log the outcome to 02-DOCS/wiki/youtube/thumbnail-experiments.md.
  4. Learn: mine the log into thumbnail-patterns.md (what wins on THIS channel) and let that pick the next concept.

The reason for the discipline: Test & Compare hands you a winner, never a reason. One varied axis per round is what turns a winner into a transferable rule.

Hard constraints

These are objective and machine-checkable. scripts/verify.sh enforces the image ones; the rest are your job. Source facts: socialrails.com / thumbnailtest.com specs, accessed 2026-06-02.

ConstraintValueWhy
Resolution1280x720 pxYouTube's recommended size; anything smaller upscales soft
Aspect ratio16:9The only ratio that fills the player and feed cleanly
Min width640 pxBelow this YouTube may reject the upload
File sizeunder 2 MBHard cap for standard video (10 MB only for podcast thumbnails)
FormatJPG or PNGAlso accepts GIF/BMP, but ship JPG/PNG
Legibilityreads at 320x180Most discovery is the mobile feed at ~that scale — the "squint test"
Safe zoneclear bottom-rightThe duration stamp overlays that corner — no critical text/face/logo there

The squint test: shrink the image to 320x180 (or step back two meters from the screen). If the subject and any text are not instantly readable, it fails — design for the feed, not for the editor canvas. See references/composition-and-specs.md for the contrast math and export workflow.

Composition rules

Each rule, one reason. Concrete beats abstract.

  • One dominant focal point. The eye must land in under a second; a thumbnail with two competing subjects reads as none at 320x180.
  • A face with one strong emotion when the video allows it. Faces with clear emotion lift CTR roughly 20-30%, and custom thumbnails run ~60-70% higher CTR than auto-generated frames. One emotion, not a neutral stare.
  • Subject ~30% brighter or darker than its background. Separation is what makes the subject pop in a scroll; a subject the same luminance as the bg vanishes. Add a subtle outline or glow if the background is busy.
  • 2-3 bold colors, complementary. More than three and the image turns to mud at feed scale. Target a text/background contrast ratio of about 4.5:1 (a usability heuristic, not a YouTube rule).
  • Kill motion blur and clutter. Anything that softens or crowds the frame dies first when the image shrinks.

Text rules

  • 3-4 words maximum, maximum weight. Heavy bold sans, large enough to read at 320x180. If it needs a second line of small type, cut it.
  • Never in the bottom-right. That is the duration-stamp safe zone.
  • The thumbnail text must NOT just repeat the title. They are two surfaces of one promise, so make them add up instead of echo.

Bad -> Good (text that wastes the surface):

text
Bad   title: "I built a PC in 24 hours"   thumb text: "BUILT A PC IN 24H"
Good  title: "I built a PC in 24 hours"   thumb text: "$200 BUDGET?!"

The Bad version spends both surfaces on the same words. The Good version lets the thumbnail carry the stakes the title leaves implicit. The full title<->thumbnail promise pairing — which surface owns which half of the hook — belongs to youtube-packaging. Here, just don't duplicate.

Variant design for the A/B test

This is where the flow branches, so decide deliberately.

Vary exactly ONE axis per variant set. Change face vs object AND text AND color at once and a winning variant teaches you nothing — you cannot attribute the lift. Pick one axis from the menu and hold everything else constant.

AxisVariant AVariant BWhat a win tells you
Subjecthuman facethe object/resultdoes your audience click people or things
Expressionshockcalm/confidentwhich emotion this niche rewards
Texttext presentno textwhether words help or clutter here
Colorwarm dominantcool dominantthe channel's palette pull
Layoutsubject leftsubject rightreading-order fit
Zoomtight cropwide contextintimacy vs setting

Two variants is enough to isolate one axis cleanly; use the third slot only when a third level of the SAME axis is genuinely informative.

Show full SKILL.md (541 more words)Show less

Test & Compare procedure

YouTube's native A/B tool (broad rollout 2025). In Studio: open the video -> Thumbnail -> "Test & Compare" -> add variants.

  • Up to 3 thumbnails (and/or titles) per video.
  • Winner is chosen by watch-time share, NOT raw CTR. This is the trap that breaks intuition: a punchy over-promising thumbnail can win the click and still lose the test because the viewers it lured bounce, dragging watch time down.
  • Runs up to ~2 weeks, then YouTube auto-promotes the winner.
  • Let it reach significance — don't call it after two days of noise.

The over-promise trap is the seam to youtube-packaging: if your tests keep crowning the "boring" variant, the flashy one is writing a check the video doesn't cash. That is a promise problem, not an image problem.

The feedback loop (wiki)

Every test result goes to the channel wiki. Exact path: 02-DOCS/wiki/youtube/. 02-DOCS/wiki/ is an OKF v0.1 bundle: both files below carry file-level frontmatter with a non-empty type (thumbnail-experiment) plus the OKF surface (title, description, tags, timestamp) shared with the api/strategy/packaging siblings, and cross-references use standard markdown links, never [[wikilinks]].

Log file — thumbnail-experiments.md, frontmatter at the top then one row per test (append-only, ISO 8601 dates, past rows immutable):

text
| date | video | variants | axis tested | winner | CTR | watch-time share | note |

Derived file — thumbnail-patterns.md, frontmatter at the top then a running table of what wins on THIS channel (e.g. "faces beat objects 4/5 tests", "no-text wins on tutorials"). You update this after each logged test.

Next-concept rule: the next thumbnail keeps the winning level of every axis already settled by the log, and tests the next unsettled axis. You only re-test a settled axis when the channel's content or audience visibly shifts.

Caveat: on a small channel a single test is noise. Treat a pattern as real only after it holds across ~3+ tests or a clear, repeated margin. Full schema, filled example rows, and the pattern-mining heuristic live in references/experiment-log-format.md.

Anti-patterns

Anti-patternWhy it failsDo instead
Tiny or thin textIllegible at 320x180 feed scale3-4 words, heavy bold, squint-tested
5+ colorsMuddies into noise when shrunk2-3 complementary bold colors
Clipart / stock facesNo emotion, no trust, reads as spamReal face, one strong emotion
Thumb text == title textWastes both surfaces of the promiseThumb adds the stake the title omits
Varying 3 axes per testWinner is uninterpretableOne axis per variant set
Trusting one test on a small channelThat's noise, not signalWait for ~3+ tests / repeated margin
Designing in the full editor onlyLooks great at 1280, dies in the feedCheck the 320x180 squint view
Subject/logo in bottom-rightDuration stamp covers itKeep that corner clear
Chasing CTR while watch time tanksTest & Compare scores watch-time shareFix the over-promise (see youtube-packaging)

Pre-publish checklist

  • Exactly 1280x720, 16:9, under 2MB, JPG or PNG (run scripts/verify.sh)
  • Passes the 320x180 squint test
  • Bottom-right corner clear of text/face/logo
  • Single dominant focal point; subject ~30% contrast vs background
  • 3-4 words max, heavy weight; text not duplicating the title
  • 2-3 colors only
  • Variant set differs on exactly ONE named axis
  • Test & Compare configured (<=3 variants, watch-time-share, ~2-week window)
  • Log row staged for 02-DOCS/wiki/youtube/thumbnail-experiments.md

See also

  • youtube-packaging — the title<->thumbnail promise pair and hook framing.
  • youtube-strategy — channel positioning, niche, cadence.
  • ab-testing — rigorous experiment design on non-YouTube surfaces.
  • design — general visual systems and composition theory.

© ericrisco, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 5 other files (scripts, references) in skills/youtube-thumbnails of ericrisco/rsc-harness.

  • SKILL.md
  • evals/README.md
  • evals/cases.yaml
  • references/composition-and-specs.md
  • references/experiment-log-format.md
  • scripts/verify.sh

Open the folder on GitHubat commit e3d5b33

Compare with similar skills

Youtube Thumbnails next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Youtube Thumbnails compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Youtube Thumbnails this skillericrisco/rsc-harness167—~2.4kAutomated safety check: PassMIT
Title CraftTheCraigHewitt/skills157—~2.1kAutomated safety check: PassMIT
Thumbnail Designsocial-media-skills/skills125—~1.7kAutomated safety check: PassMIT
Video Hook Generatornicepkg/ai-workflow285—~2kAutomated safety check: PassMIT
Generate Youtube Thumbnailkrusemediallc/arcads-claude-code1.6k—~2.4kAutomated safety check: NotesMIT
Thumbnaildaiki-beppu/youtube-automation169—~11kAutomated safety check: PassCustom licence

Similar skills

  • Title Craft

    TheCraigHewitt/skills

    When the user wants to write YouTube video titles, optimize existing titles, A/B test title variants, or improve click-through rate.

    157 GitHub stars~2.1k tokensUpdated 4 mo ago
    Media & CreativeAuto-check passed
  • Thumbnail Design

    social-media-skills/skills

    Design YouTube video thumbnails that earn the click — mobile-legible, one focal point, honest.

    125 GitHub stars~1.7k tokensUpdated 7 days ago
    Media & CreativeAuto-check passed
  • Video Hook Generator

    nicepkg/ai-workflow

    Generate attention-grabbing hooks for the first 3 seconds of videos.

    285 GitHub stars~2k tokensUpdated 8 mo ago
    Media & CreativeAuto-check passed
  • Generate Youtube Thumbnail

    krusemediallc/arcads-claude-code

    Generate high-CTR YouTube thumbnails using Nano Banana 2 via the Arcads external API.

    1.6k GitHub stars~2.4k tokensUpdated 16 days ago
    Media & CreativeAuto-check: notes
  • Thumbnail

    daiki-beppu/youtube-automation

    A skill your agent uses when コレクションの YouTube サムネイル(thumbnail.jpg)を CTR 最適化し、実効 textrender.mode に従い、既定 aiburnin で文字入り候補を生成・承認してから textless 背景を作るとき、または deterministic で textless main.png/jpg…

    169 GitHub stars~11k tokensUpdated yesterday
    Media & CreativeAuto-check passed
  • Media Transform

    swyxio/skills

    Generic media transformation orchestrator — download videos from any source (X/Twitter, Zoom, YouTube, web embeds), upload to YouTube, transcribe with timestamps, generate chapters, create…

    175 GitHub stars~2.6k tokensUpdated 3 days ago
    Media & CreativeAuto-check passed

More from ericrisco/rsc-harness

All 227 skills in this repo
  • Ab Testing

    ericrisco/rsc-harness

    A skill your agent uses when designing or analyzing a controlled experiment — falsifiable hypothesis, sample size from an MDE, reading significance/CI/power, CUPED, or rescuing tests that won't go…

    167 GitHub stars~2.4k tokensUpdated today
    Auto-check passed
  • Accessibility

    ericrisco/rsc-harness

    A skill your agent uses when making a web UI conform to WCAG 2.2 Level AA — axe-core or Lighthouse a11y violations, keyboard operability, focus management, ARIA roles/names/live regions, contrast…

    167 GitHub stars~3.4k tokensUpdated today
    Auto-check passed
  • Ads

    ericrisco/rsc-harness

    A skill your agent uses when running or fixing paid acquisition on Google or Meta — campaign structure (Performance Max, Demand Gen, Search, Advantage+), platform-fit creative, budget/scaling rules…

    167 GitHub stars~2.2k tokensUpdated today
    Auto-check passed
  • Agent Eval

    ericrisco/rsc-harness

    A skill your agent uses when measuring whether an LLM or agent system actually got better and gating merges on it: golden sets, fixing an inflated LLM-as-judge, scoring RAG (faithfulness, contextual…

    167 GitHub stars~3.2k tokensUpdated today
    Auto-check passed
  • AI Media

    ericrisco/rsc-harness

    A skill your agent uses when a creative goal must become a finished media file: pick and order generative-media models per modality — AI voiceover, image-to-video clips, score — then glue them with…

    167 GitHub stars~3.3k tokensUpdated today
    Auto-check passed
  • Analytics

    ericrisco/rsc-harness

    A skill your agent uses when instrumenting product or web analytics — GA4/PostHog SDK wiring, event taxonomy, funnels, double-counted events, consent gating, PII scrubbing.

    167 GitHub stars~2.8k tokensUpdated today
    Auto-check passed

Works with

Questions about Youtube Thumbnails

What does Youtube Thumbnails do?

A skill your agent uses when designing or fixing a YouTube thumbnail, making variants for an A/B test, or working out which thumbnail style wins on a channel — including the trap where CTR looks…. Youtube Thumbnails is an agent skill from ericrisco/rsc-harness. Use when designing or fixing a YouTube thumbnail, making variants for an A/B test, or working out which thumbnail style wins on a channel — including the trap where CTR looks fine but the test keeps selecting the duller image on watch-time share.

When should I use Youtube Thumbnails?

Youtube Thumbnails fits situations like: fixing a YouTube thumbnail; making variants for an A/B test.

How do I install Youtube Thumbnails in Claude Code?

Run `npx skills add ericrisco/rsc-harness --skill youtube-thumbnails -a claude-code`. Or copy the skill folder (skills/youtube-thumbnails in ericrisco/rsc-harness) into .claude/skills/youtube-thumbnails in your project. Claude Code loads it when a task matches its description.

How do I install Youtube Thumbnails in Codex?

Run `npx skills add ericrisco/rsc-harness --skill youtube-thumbnails -a codex`. Or copy the skill folder (skills/youtube-thumbnails in ericrisco/rsc-harness) into .agents/skills/youtube-thumbnails in your project. Codex loads it when a task matches its description.

Can I use Youtube Thumbnails in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add ericrisco/rsc-harness --skill youtube-thumbnails -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/youtube-thumbnails, .gemini/skills/youtube-thumbnails, .github/skills/youtube-thumbnails and .opencode/skills/youtube-thumbnails in your project.

What does Youtube Thumbnails need to run?

Going by SKILL.md and its folder, Youtube Thumbnails needs a shell for the scripts in its folder. Our summary lists: A Bash shell.

Does Youtube Thumbnails access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Youtube Thumbnails safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Youtube Thumbnails use?

Youtube Thumbnails is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Youtube Thumbnails use?

About 2.4k tokens (SKILL.md is roughly 9.6k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 1.8k tokens, read only when the agent opens those files.

What are the alternatives to Youtube Thumbnails?

Skills that share tags, products or a category with Youtube Thumbnails: Title Craft (TheCraigHewitt/skills, 157 stars), Thumbnail Design (social-media-skills/skills, 125 stars), Video Hook Generator (nicepkg/ai-workflow, 285 stars) and Generate Youtube Thumbnail (krusemediallc/arcads-claude-code, 1.6k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Youtube Thumbnails?

ericrisco (a GitHub user) maintains it in ericrisco/rsc-harness, which has 167 GitHub stars. The repository holds 227 skills in this directory. The repository was last updated on October 7, 2026.

Source: ericrisco/rsc-harness on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.