Agent skill

Youtube Thumbnail

by charlie947 in charlie947/social-media-skills

Generate a branded YouTube thumbnail from a video title. An agent skill from charlie947/social-media-skills.

MITAuto-check passedMedia & Creative

Install Youtube Thumbnail

skills CLI
$ npx skills add charlie947/social-media-skills --skill youtube-thumbnail -a claude-code

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

GitHub CLI
$ gh skill install charlie947/social-media-skills youtube-thumbnail --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/charlie947/social-media-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/youtube-thumbnail .claude/skills/youtube-thumbnail && 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-thumbnail
GitHub stars
3.8k
Token cost
~1.9k tokens
SKILL.md length
760 words
Files
1
Skills in repo
15
Repo updated
First seen
Licence
MIT

At a glance

Generate a branded YouTube thumbnail from a video title. An agent skill from charlie947/social-media-skills.

  • Works in 5 steps: Gather inputs → Apply thumbnail best practices → Build the thumbnail brief → …
  • The user says thumbnail
  • SKILL.md covers Codex and Claude runtime, Visual completion state, CRITICAL: Auto-start on load and Step 1. Gather inputs, plus 5 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Youtube Thumbnail is an agent skill from charlie947/social-media-skills. Generate a branded YouTube thumbnail from a video title. Uses a reference photo of the creator, high-CTR thumbnail principles, and brand colours to produce a ready-to-generate image prompt for Gemini. Use this skill whenever the user says "thumbnail", "youtube thumbnail", "build me a thumbnail", or wants a video cover image before writing the script. The thumbnail-first workflow mirrors the graphic-first approach for LinkedIn: sells the video before anyone hears a word of the script.

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

It sits in Media & Creative, covering Social media graphics and Image generation. It works with YouTube and LinkedIn. The licence is MIT.

When your agent uses it

  • The user says thumbnail
  • Youtube thumbnail
  • Build me a thumbnail
  • Wants a video cover image before writing the script

Example prompts

  • “thumbnail”
  • “youtube thumbnail”
  • “build me a thumbnail”
  • “/youtube-thumbnail”

Workflow steps

5 steps, taken from the step headings in SKILL.md.

  1. Gather inputs
  2. Apply thumbnail best practices
  3. Build the thumbnail brief
  4. Output the Gemini prompt
  5. Offer the next move

What it can do on your machine

Read from SKILL.md and the folder at commit 8cefb5b. 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 json).

    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 Thumbnail loads about 1.9k tokens when it runs. Until then it costs about 127 tokens; SKILL.md has 760 words of instructions outside code blocks.

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

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 charlie947/social-media-skills at commit 8cefb5b, republished under its MIT licence (© charlie947). 760 words, ~1,929 tokens.

Download SKILL.mdSave it as .claude/skills/youtube-thumbnail/SKILL.md (or your agent's skills folder).
name
youtube-thumbnail
description
Generate a branded YouTube thumbnail from a video title. Uses a reference photo of the creator, high-CTR thumbnail principles, and brand colours to produce a ready-to-generate image prompt for Gemini. Use this skill whenever the user says "thumbnail", "youtube thumbnail", "build me a thumbnail", or wants a video cover image before writing the script. The thumbnail-first workflow mirrors the graphic-first approach for LinkedIn: sells the video before anyone hears a word of the script.

YouTube Thumbnail

Codex and Claude runtime

  • Use this skill in Codex or Claude with the tools actually available in the current task. AskUserQuestion examples describe the questions, not a required API: use an available question tool within its limits, or ask in chat. Reuse answers and source material already supplied.
  • Work in the user-selected project. Read its about-me.md, voice.md and relevant brand files before personalised work. Confirm the intended author if files conflict or contain starter defaults. Ask for missing facts or run voice-builder; never inherit the maintainer's identity, accounts or private files.
  • Resolve bundled references/ relative to this skill folder. For an explicitly requested profile refresh, read and update the canonical about-me.md, voice.md or newsletter-voice.md in place, preserving unrelated user facts and rules. Consumers must reread those canonical files. Use a new filename only for new deliverables that would collide with unrelated existing files. Installation alone never starts an interview or writes files. Do not write persistent learnings unless requested.
  • Use supplied evidence first. Verify external claims through available search/source tools when needed. If a source or integration is unavailable, name the missing capability and offer supplied text/export input. Never invent facts, first-person experience, metrics or a successful tool run.
  • Connect only services needed for the chosen route through the user's existing account. Never print credentials or overwrite connections. Drafting, saving and reviewing do not authorise publishing, sending messages or changing accounts.

Visual completion state

This skill's image prompts are prompt-ready, not generated or visually reviewed assets. Keep its named Gemini workflow unless the user requests another generator. A missing image service does not block writing a prompt. When images are supplied or generated, open and inspect each export at full size and feed size (about 360px wide, 320px for thumbnails). Check exact copy, dimensions, clipping, legibility, brand colours, font appearance, logos and reference fidelity. Fix and re-inspect failed exports. Record any unavailable export or inspection as pending. An image prompt or raster export is not an editable design file.

CRITICAL: Auto-start on load

When this skill triggers, go straight to Step 1.

Step 1. Gather inputs

Check the project for a reference photo config. Look in this order:

  1. thumbnail-config.md in the project root
  2. brand-kit.md — look for a reference image path and brand colours
  3. about-me.md — for the creator's name and positioning

If a reference photo path is stored, pre-fill it. Otherwise ask:

Upload or provide the path to the reference photo of yourself you want used in the thumbnail. Ideally a clear headshot with distinctive lighting and expression you plan to reuse across videos for brand consistency.

Then call AskUserQuestion:

json
[
  {
    "question": "What is the video title?",
    "header": "Title",
    "multiSelect": false,
    "options": [
      {"label": "I will type the title", "description": "Type the full working title"},
      {"label": "Suggest one", "description": "Given the topic, propose 3 click-worthy titles first"}
    ]
  },
  {
    "question": "Emotional tone?",
    "header": "Tone",
    "multiSelect": false,
    "options": [
      {"label": "Shock / surprise", "description": "Wide eyes, open mouth, bold reaction"},
      {"label": "Curious / thinking", "description": "Slight smirk, raised eyebrow, gaze off-frame"},
      {"label": "Confident / direct", "description": "Eye contact, calm, assertive"},
      {"label": "Frustrated / strong take", "description": "Intense gaze, hand gesture, tension"}
    ]
  }
]

Confirm the title and promise against the video’s supplied content. Do not invent a result, imply a demonstration exists, or use an unprovided face or brand mark. A missing reference photo leaves photo-based generation pending, while a composition brief can still be drafted.

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

Step 2. Apply thumbnail best practices

Every thumbnail must follow these rules:

  • Face fills 30 to 50 percent of the frame. Readable at small sizes.
  • 3 to 5 words maximum of large text. 6 if absolutely necessary.
  • Two colours dominate. Brand primary + one high-contrast accent (yellow, red, cyan work well).
  • One clear focal element besides the face. Tool logo, bold number, arrow, or prop.
  • High contrast between face, text, and background. Test by squinting.
  • Text is not a sentence. It is a hook phrase. Examples: "I fired my team", "Claude can now...", "Don't do this".
  • No small text, no logos bottom-right (watch time icon sits there).

Step 3. Build the thumbnail brief

Output a concise brief the user can review:

THUMBNAIL BRIEF: [video title]

Composition: [face position, % of frame, direction of gaze]
Text: "[hook phrase, 3-5 words]"
Text placement: [left, right, top, wraps around face]
Colour palette: [primary hex], [accent hex], [background hex]
Supporting element: [logo / prop / arrow / number]
Emotional tone: [tone from Step 1]

Then ask:

Here's the brief. Say "generate" to output the image prompt or tell me what to change.

Step 4. Output the Gemini prompt

Once approved, output the image generation prompt in a code block:

Using the attached reference photo of me, generate a YouTube thumbnail at 1280 x 720 pixels (16:9).

Composition:
- Place me [left / right / centre] filling [30-50]% of the frame
- My expression: [tone details — e.g., shocked with wide eyes and open mouth]
- My gaze: [direction — e.g., looking directly at camera / looking off-frame toward the text]

Text:
- Display "[hook phrase]" in large bold sans-serif typography
- Text colour: [hex]
- Text outline: [colour, thickness for readability]
- Text placement: [specific area]

Colour palette:
- Primary: [hex]
- Accent: [hex]
- Background: [hex] — [describe treatment: flat, gradient, blurred scene, etc.]

Supporting element: [specific description of the supporting visual]

Constraints:
- Face must be clear and sharp
- Text must be readable at 320px wide (YouTube mobile size)
- No watermarks, no YouTube UI elements, no bottom-right corner text
- High contrast between face, text, and background

Tell the user:

Paste this into a new Gemini chat, attach your reference photo, enable Create Image, and select Nano Banana. Generate at 1280x720.

Step 5. Offer the next move

Want me to outline the video next? Hook, mid, CTA from the thumbnail.

Rules

  • 1280x720 pixels (16:9). YouTube's native thumbnail size.
  • Never include the reference photo path in the prompt itself — the user attaches the photo separately.
  • Never allow more than 6 words of text, 5 is ideal, 3 is best.
  • Face must always be a visible focal point. No face-hidden compositions.
  • Never use em dashes.
  • British English unless voice.md specifies otherwise.
  • If brand-kit.md is in the project, read it and use exact brand colours.
  • Recommend the user keep a consistent thumbnail style across videos for channel recognition.

© charlie947, 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 skills/youtube-thumbnail of charlie947/social-media-skills.

Open the folder on GitHubat commit 8cefb5b

Compare with similar skills

Youtube Thumbnail 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 Thumbnail compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Youtube Thumbnail this skillcharlie947/social-media-skills3.8k—~1.9kAutomated safety check: PassMIT
Web Asset Generatoralonw0/web-asset-generator5141 repos~6.6kAutomated safety check: PassMIT
Picture Itgeongeorge/picture-it132—~3.7kAutomated safety check: PassMIT
Youtube Thumbnailhassancs91/claude-youtube-editor328—~2.1kAutomated safety check: NotesMIT
SEO Image GeneratorAgriciDaniel/claude-seo19k2 repos~2.1kAutomated safety check: PassMIT
KrillinAI Cover Imagekrillinai/OpenCreator13k—~441Automated safety check: PassApache-2.0

Similar skills

  • Web Asset Generator

    alonw0/web-asset-generator

    Generate web assets including favicons, app icons (PWA), and social media meta images (Open Graph) for Facebook, Twitter, WhatsApp, and LinkedIn.

    514 GitHub starsUsed in 1 repo~6.6k tokens
    Media & CreativeAuto-check passed
  • Picture It

    geongeorge/picture-it

    Generate and edit images from the CLI using picture-it. An agent skill from geongeorge/picture-it.

    132 GitHub stars~3.7k tokensUpdated 6 mo ago
    Media & CreativeAuto-check passed
  • Youtube Thumbnail

    hassancs91/claude-youtube-editor

    Dedicated YouTube thumbnail generator — interviews you for exactly the style elements you want (environment, text budget, extras, accent color), then renders high-contrast, vibrant, face-consistent…

    328 GitHub stars~2.1k tokensUpdated 1 mo ago
    Media & CreativeAuto-check: notes
  • SEO Image Generator

    AgriciDaniel/claude-seo

    Generates Open Graph previews, blog hero images, product photos and infographics for SEO use through Gemini image tools and the banana extension.

    19k GitHub starsUsed in 2 repos~2.1k tokens
    Media & CreativeAuto-check passed
  • KrillinAI Cover Image

    krillinai/OpenCreator

    Generates a cover image with the KrillinAI CLI from a finished image prompt, then checks the output files, the saved prompt and the manifest.

    13k GitHub stars~441 tokensUpdated today
    Media & CreativeAuto-check passed
  • Guizang Material Illustration

    op7418/guizang-material-illustration

    Generate Guizang-style material illustrations, labeled explanatory visuals, material-styled chart illustrations, and data-first editorial images from articles, notes, product concepts, workplace…

    1.2k GitHub stars~1.6k tokensUpdated 3 mo ago
    Media & CreativeAuto-check passed

More from charlie947/social-media-skills

All 15 skills in this repo
  • Newsletter Voice

    charlie947/social-media-skills

    Build newsletter writing instructions inside a Codex or Claude project.

    3.8k GitHub stars~2.5k tokensUpdated 26 days ago
    Auto-check passed
  • Voice Builder

    charlie947/social-media-skills

    Build a personalised voice profile inside a Codex or Claude project from a short interview plus 3 to 5 sample pieces of writing.

    3.8k GitHub stars~3.3k tokensUpdated 26 days ago
    Auto-check passed
  • Content Matrix

    charlie947/social-media-skills

    Generate 24 to 40 LinkedIn post ideas in a single table by pairing the user's content pillars with 8 proven content formats.

    3.8k GitHub stars~1.6k tokensUpdated 26 days ago
    Auto-check passed
  • Gemini Carousel

    charlie947/social-media-skills

    Generate a branded slide-by-slide LinkedIn carousel using Gemini.

    3.8k GitHub stars~1.7k tokensUpdated 26 days ago
    Auto-check passed
  • Hook Generator

    charlie947/social-media-skills

    Generate 6 clickbait-style LinkedIn hook variations for any topic.

    3.8k GitHub stars~1.1k tokensUpdated 26 days ago
    Auto-check passed
  • Niche Research

    charlie947/social-media-skills

    Surface the 20 most relevant stories in a niche from the last 7 days using available live research tools.

    3.8k GitHub stars~1.7k tokensUpdated 26 days ago
    Auto-check passed

Works with

Questions about Youtube Thumbnail

What does Youtube Thumbnail do?

Generate a branded YouTube thumbnail from a video title. An agent skill from charlie947/social-media-skills. Youtube Thumbnail is an agent skill from charlie947/social-media-skills. Generate a branded YouTube thumbnail from a video title.

When should I use Youtube Thumbnail?

Youtube Thumbnail fits situations like: the user says thumbnail; youtube thumbnail; build me a thumbnail; wants a video cover image before writing the script.

How do I install Youtube Thumbnail in Claude Code?

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

How do I install Youtube Thumbnail in Codex?

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

Can I use Youtube Thumbnail 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 charlie947/social-media-skills --skill youtube-thumbnail -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-thumbnail, .gemini/skills/youtube-thumbnail, .github/skills/youtube-thumbnail and .opencode/skills/youtube-thumbnail in your project.

What does Youtube Thumbnail need to run?

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

Does Youtube Thumbnail 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 Thumbnail 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 Youtube Thumbnail use?

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

About 1.9k tokens (SKILL.md is roughly 7.7k 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 Youtube Thumbnail?

Skills that share tags, products or a category with Youtube Thumbnail: Web Asset Generator (alonw0/web-asset-generator, 514 stars), Picture It (geongeorge/picture-it, 132 stars), Youtube Thumbnail (hassancs91/claude-youtube-editor, 328 stars) and SEO Image Generator (AgriciDaniel/claude-seo, 19k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Youtube Thumbnail?

charlie947 (a GitHub user) maintains it in charlie947/social-media-skills, which has 3,844 GitHub stars. The repository holds 15 skills in this directory. The repository was last updated on September 15, 2026.

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