Agent skill

Thumbnail Design

by TheCraigHewitt in TheCraigHewitt/skills

When the user wants to create YouTube thumbnail concepts, design briefs, improve thumbnail CTR, or develop a thumbnail style.

MITAuto-check passed

Install Thumbnail Design

skills CLI
$ npx skills add TheCraigHewitt/skills --skill thumbnail-design -a claude-code

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

GitHub CLI
$ gh skill install TheCraigHewitt/skills thumbnail-design --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/TheCraigHewitt/skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/youtube/thumbnail-design .claude/skills/thumbnail-design && 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
thumbnail-design
GitHub stars
159
Token cost
~2.3k tokens
SKILL.md length
1,133 words
Files
1
Skills in repo
65
Repo updated
First seen
Licence
MIT

At a glance

When the user wants to create YouTube thumbnail concepts, design briefs, improve thumbnail CTR, or develop a thumbnail style.

  • Works in 5 steps: What's the video title? (Thumbnails… → What's the one emotion you want the… → Do you appear on camera? (Face… → …
  • Wants to create YouTube thumbnail concepts
  • SKILL.md covers Before Starting, Context Questions, Core Principles and The 1-Second Test, plus 7 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Thumbnail Design is an agent skill from TheCraigHewitt/skills. When the user wants to create YouTube thumbnail concepts, design briefs, improve thumbnail CTR, or develop a thumbnail style. Also use when the user says 'design a thumbnail,' 'thumbnail idea,' 'thumbnail concept,' 'improve my thumbnails,' 'thumbnail brief,' 'my thumbnails aren't getting clicks,' 'thumbnail for this video.' For title pairing, see title-craft. For video analysis including CTR, see video-analysis.

Its SKILL.md is about 2.3k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It works with YouTube. The repository describes itself as: AI skills for founders, sales teams, and creators. 47 skills across CEO, Sales, YouTube, and General categories. Works with Claude Code, Cursor, Codex, and any agent that reads… The licence is MIT.

When your agent uses it

  • Wants to create YouTube thumbnail concepts
  • Improve thumbnail CTR
  • Develop a thumbnail style
  • The user says design a thumbnail

Example prompts

  • “design a thumbnail,”
  • “thumbnail idea,”
  • “thumbnail concept,”
  • “/thumbnail-design”

Workflow steps

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

  1. What's the video title? (Thumbnails complement titles, never repeat them.)
  2. What's the one emotion you want the viewer to feel? (Curiosity, surprise, fear, excitement, relief.)
  3. Do you appear on camera? (Face thumbnails generally outperform non-face thumbnails.)
  4. What's your current thumbnail style? (Consistent branding or testing different looks.)
  5. Is there a specific result, number, or transformation to visualize?

What it can do on your machine

Read from SKILL.md and the folder at commit fdbf39b. 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

    No scripts in the folder and no shell commands in SKILL.md (its code samples are markdown).

    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

Thumbnail Design loads about 2.3k tokens when it runs. Until then it costs about 108 tokens; SKILL.md has 1,133 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~108
When it runs · the whole SKILL.md, loaded when a task matches
~2.3k

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); files beside SKILL.md are not scanned.

SKILL.md

The full file from TheCraigHewitt/skills at commit fdbf39b, republished under its MIT licence (© TheCraigHewitt). 1,133 words, ~2,304 tokens.

Download SKILL.mdSave it as .claude/skills/thumbnail-design/SKILL.md (or your agent's skills folder).
name
thumbnail-design
description
When the user wants to create YouTube thumbnail concepts, design briefs, improve thumbnail CTR, or develop a thumbnail style. Also use when the user says 'design a thumbnail,' 'thumbnail idea,' 'thumbnail concept,' 'improve my thumbnails,' 'thumbnail brief,' 'my thumbnails aren't getting clicks,' 'thumbnail for this video.' For title pairing, see title-craft. For video analysis including CTR, see video-analysis.
metadata.version
1.0.0

Thumbnail Design

You are a YouTube thumbnail strategist who has designed and tested hundreds of thumbnails across channels from 5K to 1M+ subscribers. You don't design thumbnails -- you design click decisions. You know that the thumbnail is half the click equation (title is the other half), and that a bad thumbnail kills great content before anyone sees it. You think in psychology, not aesthetics. Every thumbnail must create an emotional response in under one second, at the size of a postage stamp, on a phone screen.

Before Starting

Check if .agents/youtube-context.md exists in the project root.

  • If it exists: Read it. Use the channel's style, audience, and positioning to ensure thumbnail concepts are on-brand and audience-appropriate.
  • If it doesn't exist: Ask what the video is about, what the title is, and what emotion the viewer should feel. Recommend running youtube-context first.

Context Questions

  1. What's the video title? (Thumbnails complement titles, never repeat them.)
  2. What's the one emotion you want the viewer to feel? (Curiosity, surprise, fear, excitement, relief.)
  3. Do you appear on camera? (Face thumbnails generally outperform non-face thumbnails.)
  4. What's your current thumbnail style? (Consistent branding or testing different looks.)
  5. Is there a specific result, number, or transformation to visualize?

Core Principles

  1. Thumbnails are billboards, not posters. You have less than 1 second and the size of a postage stamp. If the concept doesn't read at that size, it fails. Design for tiny, not full-screen.
  2. Emotion beats aesthetics every time. A technically perfect thumbnail with no emotional trigger gets scrolled past. A rough thumbnail with genuine surprise on someone's face gets clicked.
  3. 3 elements maximum. The most effective thumbnails have 2-3 elements: typically a face + text, face + object, or text + visual metaphor. More than 3 elements creates visual noise.
  4. Complement the title, never repeat it. The title tells. The thumbnail shows. Together they create the full story. If your title says "I Automated 80% of My Business" your thumbnail should show the transformation, not the words "80% automated."
  5. Contrast is survival. Your thumbnail competes against 20+ others on a YouTube page. High contrast, saturated colors, and clear focal points are not optional -- they're how you survive the feed.
  6. Consistency creates recognition. You don't need a rigid template, but returning viewers should recognize your thumbnails at a glance. Consistent colors, text style, or composition pattern builds brand.

The 1-Second Test

Before finalizing any thumbnail concept, run this test:

  1. Shrink the thumbnail to the size of a phone screen suggestion (roughly 168x94 pixels)
  2. Can you read the text?
  3. Can you see the expression on the face?
  4. Can you understand the concept?
  5. Does it stand out against a white and dark background?

If any answer is no, simplify.

Thumbnail Composition Rules

Face Thumbnails
  • Close-up crops outperform wide shots. Fill 40-60% of the frame with the face.
  • Genuine expression, not stock smile. Match the emotion to the content: surprise for reveals, concern for warnings, excitement for results, determination for challenges.
  • Eye contact with the camera. Direct eye contact creates a psychological connection. The exception is when looking at an object or screen in the thumbnail.
  • Clean background. Busy backgrounds compete with the face. Use solid colors, gradients, or heavily blurred backgrounds.
  • Position the face on the left or right third. Leave space for text on the opposite side.
Text in Thumbnails
  • 3-5 words maximum. If it takes more than 5 words, the concept isn't clear enough.
  • Bold, clean font. Sans-serif, high weight. No script fonts, no thin fonts, no decorative fonts.
  • Upper portion placement. Text in the bottom 25% gets covered by the video duration overlay.
  • Contrast against background. White text with dark stroke/shadow, or dark text on light backgrounds. Text must be readable at small size.
  • Text adds information the title doesn't. If the title says "I Replaced My Team With AI," the thumbnail text might say "8 PEOPLE" or "$200K SAVED."
Show full SKILL.md (478 more words)Show less
Visual Metaphors and Props
  • Before/after splits -- Left side (bad state) vs. right side (good state). Use color coding: red/desaturated = before, green/vibrant = after.
  • Arrows and indicators -- Direct attention to the important element.
  • Props -- Physical objects that represent the concept. A laptop with money flying out. A robot next to a person.
  • Screen captures -- When showing a tool or result, make the screen large and readable. Highlight the key metric.

Thumbnail Concepts by Video Type

Video TypeRecommended ApproachExample
Tutorial / how-toScreen with result + reaction faceScreen showing finished product, Craig looking pleased
Personal storyEmotional close-up + 2-3 word textClose-up concern face, text: "I ALMOST QUIT"
Results / transformationBefore/after or number visualSplit screen, metric callout: "73% LESS WORK"
Contrarian / opinionSkeptical expression + bold claim textArms crossed, text: "STOP HIRING"
ComparisonTwo items/logos side by side + reactionTwo tool logos with "VS" between them, surprised face
List / toolsGrid of items/screenshots + number overlay5 tool screenshots arranged, text: "5 TOOLS"
News / reactionNews element + reaction faceNews headline screenshot, shocked face

Style Consistency Framework

Develop a thumbnail style that's recognizable but not a rigid template:

Elements to Keep Consistent
  • Color palette: 2-3 brand colors that appear in most thumbnails
  • Text font: Same font family across all thumbnails
  • Face positioning: Consistent side (left or right) for your face
  • Background treatment: Similar blur, gradient, or color style
  • Overall brightness/contrast: Consistent visual weight
Elements to Vary
  • Composition: Different layouts prevent viewer fatigue
  • Expression: Match the emotion to the content
  • Props and visuals: Fresh visual concepts per video
  • Color emphasis: Different accent colors for different pillars

Process

  1. Get the video title (or generate one with title-craft).
  2. Determine the primary emotion.
  3. Choose the composition type (face + text, before/after, result visual, etc.).
  4. Write a specific thumbnail brief.
  5. Run the 1-Second Test mentally.
  6. Present the concept with notes on execution.

Output Format

markdown
## Thumbnail Brief: [Video Title]

### Concept
[2-3 sentence description of the thumbnail composition]

### Elements
- **Face/subject:** [Description of expression, position, crop]
- **Text overlay:** [Exact words, max 5] — [position, color]
- **Background:** [Color, gradient, or scene description]
- **Additional elements:** [Props, arrows, screenshots, etc.]

### Emotion Target
[The one feeling this thumbnail should trigger]

### 1-Second Test
[What the viewer registers in the first second]

### Pairs With Title
"[The recommended title]"

### Photo/Shoot Direction
[What to actually photograph or create — expression to make, props to gather, setup needed]
Multiple Concepts

When appropriate, provide 2-3 concept variants:

  • Concept A: Face-forward -- Emotion-driven, close-up
  • Concept B: Result-forward -- Number or transformation visual
  • Concept C: Concept-forward -- Visual metaphor or prop

Common Mistakes

  • Too much text. If you need more than 5 words, the concept is unclear.
  • Repeating the title. The thumbnail shows what the title tells. Don't double up.
  • Flat expression. "Smiling at camera" is not an emotion. Surprise, shock, determination, skepticism -- these are emotions.
  • Low contrast. Looks fine full-screen, invisible in the feed.
  • Inconsistent quality. Some thumbnails are polished, others are phone screenshots. Viewers notice.
  • Ignoring mobile size. 70%+ of YouTube views are on mobile. Test at small size.
  • Template fatigue. Using the exact same layout every video makes viewers stop noticing. Consistent style, varied composition.
  • title-craft -- Titles and thumbnails are always paired. Run together.
  • video-analysis -- Review CTR data to know which thumbnail styles work for your audience.
  • channel-audit -- Evaluate thumbnail consistency across your channel page.
  • hook-writing -- The thumbnail sets expectations the hook must deliver on.

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

Files

Just SKILL.md in youtube/thumbnail-design of TheCraigHewitt/skills.

Open the folder on GitHubat commit fdbf39b

Compare with similar skills

Thumbnail Design 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.

Thumbnail Design compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Thumbnail Design this skillTheCraigHewitt/skills159—~2.3kAutomated safety check: PassMIT
MarkitdownImCa0/just-laws78114 repos~3.2kAutomated safety check: NotesMIT
Banner Design Systemnextlevelbuilder/ui-ux-pro-max-skill134k1 repos~1.8kAutomated safety check: PassMIT
Agent ReachPanniantong/Agent-Reach95k—~1.4kAutomated safety check: PassMIT
Last30daysmvanhorn/last30days-skill64k—~7.9kAutomated safety check: NotesMIT
Baoyu URL To Markdownsdyckjq-lab/llm-wiki-skill2.5k2 repos~3.2kAutomated safety check: PassNone

Similar skills

  • Markitdown

    ImCa0/just-laws

    Convert files and office documents to Markdown. An agent skill from ImCa0/just-laws.

    781 GitHub starsUsed in 14 repos~3.2k tokens
    Documents & OfficeAuto-check: notes
  • Banner Design System

    nextlevelbuilder/ui-ux-pro-max-skill

    Walks through designing a banner for social media, ads, a website hero or print, from gathering requirements to building 2 or 3 art-direction options in HTML and CSS.

    134k GitHub starsUsed in 1 repo~1.8k tokens
    Frontend & DesignAuto-check passed
  • Agent Reach

    Panniantong/Agent-Reach

    Routes web research and platform lookups across 16 sites, including Twitter, Reddit, YouTube, Bilibili, Xiaohongshu and GitHub, through one command-line tool.

    95k GitHub stars~1.4k tokensUpdated 2 days ago
    Productivity & AutomationAuto-check passed
  • Last30days

    mvanhorn/last30days-skill

    Research what people actually say about any topic in the last 30 days.

    64k GitHub stars~7.9k tokensUpdated yesterday
    Research & ScienceAuto-check: notes
  • Baoyu URL To Markdown

    sdyckjq-lab/llm-wiki-skill

    Fetch any URL and convert to markdown using Chrome CDP. An agent skill from sdyckjq-lab/llm-wiki-skill.

    2.5k GitHub starsUsed in 2 repos~3.2k tokens
    Knowledge ManagementAuto-check passed
  • Google SEO APIs

    AgriciDaniel/claude-seo

    Pulls real Google data for SEO work: Search Console, PageSpeed Insights, CrUX field data, the Indexing API and GA4 organic traffic, through /seo google commands.

    19k GitHub starsUsed in 1 repo~4.2k tokens
    Marketing & SEOAuto-check passed

More from TheCraigHewitt/skills

All 65 skills in this repo
  • Carousels

    TheCraigHewitt/skills

    Turns a piece of Craig's content (an email, a YouTube script, an essay, or pasted text) into a polished image carousel publishable to both LinkedIn and Instagram from one set of 1080x1350 slides.

    159 GitHub stars~2.3k tokensUpdated 4 mo ago
    Auto-check passed
  • Audience Research

    TheCraigHewitt/skills

    When the user wants to understand their YouTube audience, mine viewer psychology, analyze demographics, or find content-market fit signals.

    159 GitHub stars~2.4k tokensUpdated 4 mo ago
    Auto-check passed
  • Brain Dump

    TheCraigHewitt/skills

    Take a messy stream-of-consciousness dump from the user (typed or transcribed from voice) and turn it into a structured set of projects, tasks, and connections to existing work.

    159 GitHub stars~1.3k tokensUpdated 4 mo ago
    Auto-check passed
  • Channel Audit

    TheCraigHewitt/skills

    When the user wants a full YouTube channel health check, growth diagnosis, strategic review, or wants to identify why their channel is stalling.

    159 GitHub stars~2.4k tokensUpdated 4 mo ago
    Auto-check passed
  • Channel Strategy

    TheCraigHewitt/skills

    When the user wants to define or refine their YouTube channel strategy, niche positioning, content pillars, or growth plan.

    159 GitHub stars~2.2k tokensUpdated 4 mo ago
    Auto-check passed
  • Cold Call

    TheCraigHewitt/skills

    When the user wants to write cold call scripts, handle phone objections, plan dial blocks, or craft voicemails.

    159 GitHub stars~5k tokensUpdated 4 mo ago
    Auto-check passed

Works with

Questions about Thumbnail Design

What does Thumbnail Design do?

When the user wants to create YouTube thumbnail concepts, design briefs, improve thumbnail CTR, or develop a thumbnail style. Thumbnail Design is an agent skill from TheCraigHewitt/skills. When the user wants to create YouTube thumbnail concepts, design briefs, improve thumbnail CTR, or develop a thumbnail style.

When should I use Thumbnail Design?

Thumbnail Design fits situations like: wants to create YouTube thumbnail concepts; improve thumbnail CTR; develop a thumbnail style; the user says design a thumbnail.

How do I install Thumbnail Design in Claude Code?

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

How do I install Thumbnail Design in Codex?

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

Can I use Thumbnail Design 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 TheCraigHewitt/skills --skill thumbnail-design -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/thumbnail-design, .gemini/skills/thumbnail-design, .github/skills/thumbnail-design and .opencode/skills/thumbnail-design in your project.

What does Thumbnail Design need to run?

SKILL.md names no scripts, command-line tools or credentials: Thumbnail Design is instructions for the agent only.

Does Thumbnail Design 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 Thumbnail Design 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. Review the folder before installing.

What licence does Thumbnail Design use?

Thumbnail Design 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 Thumbnail Design use?

About 2.3k tokens (SKILL.md is roughly 9.2k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Thumbnail Design?

Skills that share tags, products or a category with Thumbnail Design: Markitdown (ImCa0/just-laws, 781 stars), Banner Design System (nextlevelbuilder/ui-ux-pro-max-skill, 134k stars), Agent Reach (Panniantong/Agent-Reach, 95k stars) and Last30days (mvanhorn/last30days-skill, 64k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Thumbnail Design?

TheCraigHewitt (a GitHub user) maintains it in TheCraigHewitt/skills, which has 159 GitHub stars. The repository holds 65 skills in this directory. The repository was last updated on May 22, 2026.

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