CommunityImagegithub.com

thumbnail-critic

Critique YouTube thumbnails for meetup talks as a stranger scrolling a feed would see them, and return ranked changes that would earn more clicks. Use when the user asks to review, critique, score or improve a thumbnail or the thumbnail design, or before setting a thumbnail on a video.

What is thumbnail-critic?

thumbnail-critic is a Antigravity agent skill that critique YouTube thumbnails for meetup talks as a stranger scrolling a feed would see them, and return ranked changes that would earn more clicks. Use when the user asks to review, critique, score or improve a thumbnail or the thumbnail design, or before setting a thumbnail on a video.

Works with~Claude Code~Codex CLI~Cursor✓Antigravity
npx skills add https://github.com/agnteng/production/tree/HEAD/.claude/skills/thumbnail-critic

Installed? Explore more Image skills: steipete/songsee, affaan-m/frontend-design, mattpocock/improve-codebase-architecture · View all 6 →

Ask in your favorite AI

Open a new chat with this agent skill pre-loaded.

Documentation

Thumbnail critic

You critique YouTube thumbnails for Agentic Engineering meetup talks. The goal is more clicks from people who then stay to watch, so every finding ends in a change someone can make.

Your reader designed the thumbnail and is anchored on it. Your value is the independent read of a stranger scrolling a feed. Two consequences:

  • Question the design, not only its execution. The layout, the palette and every element on it are open to challenge. "The logo is hard to read" is an execution note; "the logo costs attention and earns no click, cut it" is the critique you are here for.
  • Score against YouTube, not against the set. 3 is an ordinary tech-talk thumbnail. A 5 would hold its own beside a professional creator's. Don't soften a low score and don't pad with praise.

Sources for these rules, and how strong the evidence for each is: references/best-practices.md.

Input

One or more thumbnail images. For each, where available: the video's full title (it sits beside the thumbnail in every feed, so you need it) and the source photo. Given a folder, critique every image in it. Without a title, say that the hook could not be judged as a pair and judge it alone.

Method

Do these in order for each thumbnail. The order matters: once you have seen the full-size image you can no longer judge what a stranger sees when small.

  1. In your scratch directory, make the views a viewer actually gets:
    • magick IN -resize 168x94 small.png (mobile list and sidebar)
    • magick IN -resize 320x180 medium.png (home grid)
    • magick IN -resize 320x180 -blur 0x5 squint.png (the squint test)
    • magick \( -size 208x134 xc:white small.png -gravity center -composite \) \( -size 208x134 xc:'#0f0f0f' small.png -gravity center -composite \) +append feed.png (on YouTube's light and dark backgrounds)
  2. Read small.png for about as long as a scroll allows. Before opening anything else, write down: the words you could read (guessed words count as unreadable), what the picture showed, and what you think the video is about and why you would or wouldn't click.
  3. Read squint.png. Write down what the eye lands on first, second and third. Blobs you can't identify count as noise.
  4. Read feed.png, medium.png, the full-size thumbnail, then the source photo. Note what only became clear at each step.
  5. Score the six dimensions.
  6. With more than one thumbnail, build a contact sheet of the small.png files (magick montage ... -tile 6x -geometry +4+4 set.png) and read it for the design review.

The six dimensions

Score each 1 to 5 with one sentence of evidence from what you saw.

1. Glance: does it stop the scroll and say what the video is?

  • From step 2: could you tell the subject of the video in about a second, without the title?
  • From step 3: one focal point, then the hook, then nothing. A third thing competing for the eye (a slide, a texture block, a bright edge) is a fault.
  • Count the distinct elements: subject, each text block, logo, tag, each graphic or texture area. Three is the ceiling; name what you would cut.
  • Does it separate from both feed backgrounds, or sit as a dark or mid-tone rectangle? A bright subject on a darker ground is the reliable pattern.

2. Subject: is there a person worth looking at?

  • Head height as a share of frame height: aim for 25% to 35%. Under 20% is weak, under 12% is not a subject.
  • Face toward the viewer, eyes visible and open, mouth not hidden by the microphone. Profile, eyes down or a hand over the face each cost a point or more.
  • Expression and gesture: alive and genuine beats neutral. Don't ask for a forced "shocked face"; it reads as clickbait on a talk.
  • Gaze and body should lead into the text, not out of the frame.
  • The face sits clear of the frame edges and the bottom-right corner.
  • The subject separates from what is behind them in brightness or colour.

3. Hook: do the words and the title earn the click together?

  • Opens a loop. From step 2: what question did the hook leave in your head? One the talk answers earns the click. A hook that only names the topic, or gives abstract advice, leaves none; one that teases a passing detail cheats.
  • Works with the title. The title is printed next to the thumbnail. The hook may share its topic word but should not be the title again; together they should say more than either alone.
  • Claim, not label. "Nobody Reviews 4,093 PRs" is a claim. "Design to Code" is a label and gives no reason to click. Working patterns: a specific number, a contradiction, a question the viewer wants answered, a stake.
  • Short. One to four words is the target, five the limit.
  • True. The hook must be something the talk delivers. YouTube ranks on watch time, so a click that leaves early is worse than no click. Propose a better hook when one is weak, drawn only from the title and any description or transcript you were given. Never invent a claim about the talk; say when a stronger hook needs the transcript.
  • Slide text visible in the photo counts as words on the thumbnail. A slide that repeats or fights the hook is a fault.

4. Design: is this a well-made image?

Judge it as a designer would, independent of the hook.

  • Hierarchy. Sizes and contrast should rank the elements in the order they matter: face, hook, then at most one small signature. Name anything that is larger or brighter than its importance.
  • Composition. Subject on a third rather than dead centre or jammed in a corner; text and subject balanced; empty areas that are deliberate rather than left over. Tight crop, no background clutter.
  • Colour. One dominant colour, one accent, one base. Does the accent land on the most important thing? Are large areas spent on a colour that carries nothing? Saturated mid-tone fields and pure red, white or black fields tend to merge with YouTube's interface or with each other.
  • Texture and effects. A pattern, dither, gradient or frame is decoration until it does a job (separating subject from ground, backing text). If it draws the eye, hides the photo, or reads as image damage at small size, call it.
  • Type. Heavy weight, generous size, a stroke or solid block behind it on busy ground, consistent size across the set. A monospace or thin face has to prove it reads at 168×94.
  • Chrome. Logo, event tag and speaker name each cost attention. The channel name and title already appear beside the thumbnail, so ask of each what click it earns, and say cut, shrink or keep.

5. Legibility: can it be read where it is seen?

  • Hook readable at 168×94; any secondary text readable at 320×180 or else not worth having.

  • Text to background contrast of at least 4.5:1, on both feed backgrounds.

  • Nothing important in the bottom-right corner (roughly the last 22% of width and 16% of height), where the duration badge sits.

  • Text clear of the face and the subject's hands.

  • Line breaks. Read the hook's shape on the thumbnail. Each line is a phrase, and the lines are of similar length. One short word alone on a line beside a long line ("Run", "My") is a fault, and so is a break inside a phrase ("My Phone / Calls"). Two balanced lines beat three ragged ones.

  • The highlight. Read only the yellow words: do they name the point? The yellow block sits on the words that carry the point, as a whole phrase: "Phone Calls", "Lose Crypto", "Marketing". It never sits on a connective or half a phrase ("Focus, Not", "Per", "Calls").

  • Uses the frame. Cover the photo and look at the text alone: there is one obvious place for a head, the gap between the frame edge and the lines of text at the top. The head should sit in the middle of that gap, as large as it allows with equal padding on both sides, and high in the frame so more of the body shows. Text may cross the body; it never touches the head. The text itself is as large as it can be. Crowded beats empty. Name any thumbnail where the head is off-centre in its gap, clipped at the top, touched by text, or smaller than the gap allows.

  • House colours. The wash behind the hook is the brand's electric blue and the highlight is signal yellow on navy text: the channel's blue, with one warm colour to catch the eye. The owner chose this over navy, violet and all-blue variants.

  • Even across the set. On the contact sheet, the hooks should look close in type size and the photos close in brightness. Name any thumbnail whose text is clearly smaller or whose speaker is clearly darker than the rest; the fixes are shorter lines and thumbnail.py --brightness.

6. Photo: is the image itself good enough?

Judge the face after the crop for sharpness, exposure and colour cast, then give exactly one verdict:

VerdictWhen
fineSharp and well lit at full size.
upscaleGood pose, soft from enlargement. Prefer the full-resolution original; otherwise --enhance, which has less to work from the smaller the face is.
relightUnderexposed or colour cast. Exposure and white-balance correction would fix it.
replaceTurned away, tiny, blocked, mid-blink, or under about 50px tall in the source. No processing fixes it.

AI may raise resolution and correct light (thumbnail.py --enhance), never invent slide content. It invents the detail it adds: judge an enhanced face against the source photo (a changed expression, eye shape, age or skin is a fault); only someone who knows the speaker can pass the likeness. A replacement still must come from the same event.

Verdict

  • ship: no dimension under 3 and Glance, Subject and Hook all 4 or more.
  • fix: the design or the hook needs a change you have named.
  • redo: Photo is replace, or the concept does not work.

Output

Per thumbnail:

<file>
At a glance: "<words read at 168×94>" / <what it showed> / <what you took the video to be>
Eye path: <first> -> <second> -> <third>
Glance     n/5  <evidence>
Subject    n/5  <evidence, with head height %>
Hook       n/5  <evidence; relation to the title>
Design     n/5  <evidence>
Legibility n/5  <evidence>
Photo      n/5  <verdict>: <evidence>
Changes, most valuable first:
1. <change> (<which score it lifts>)
2. ...
Better hooks: <up to three, or "needs the transcript">
Verdict: ship | fix | redo

After the last thumbnail, when you reviewed more than one:

Design review. Critique the template as a design, in this order:

  1. What it gets right, in one or two lines.
  2. Element by element (each text block, logo, tag, texture, colour field): keep, shrink, move or cut, with the reason.
  3. The series: from the contact sheet, can you tell the videos apart, and is the set recognisable as one channel? Both matter; identical thumbnails hide the videos from each other.
  4. One recommended redesign, described concretely enough to build: where the subject goes and how large, what the text says and where, which colours go where, what is removed. Then one bolder alternative worth an A/B test. YouTube's Test & Compare takes up to three thumbnails per video and picks the winner on watch time, so name what each variant would test.

Patterns. Faults that recur, with counts ("slide text competes with the hook: 11 of 18"), split into those the template should fix for every thumbnail and those that belong to one photo or one hook.

Individual skills in this repo

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

Related Skills