thumbnail

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Thumbnail Skill

缩略图Skill

This skill enables generation of high-performing thumbnails and cover images optimized for click-through rate (CTR). Thumbnails are designed to spark curiosity, complement titles, and compel viewers to click.
本Skill可生成针对点击率(CTR)优化的高性能缩略图和封面图。缩略图的设计旨在激发好奇心、补充标题内容,并促使观众点击。

Thumbkit

Thumbkit

You have access to Thumbkit, a CLI tool for generating and editing high-performing thumbnails. You MUST use Thumbkit to generate and edit all thumbnails.
Using Thumbkit is REQUIRED for you to complete your task. Assume Thumbkit has been installed as a uv tool and is available globally on the user's system. If Thumbkit is not installed, you MUST install it before proceeding.
你可以使用Thumbkit——一款用于生成和编辑高性能缩略图的CLI工具。你必须使用Thumbkit来生成和编辑所有缩略图。
使用Thumbkit是你完成任务的强制要求。假设Thumbkit已作为uv工具安装,且在用户系统中全局可用。如果未安装Thumbkit,你必须先安装它再继续操作。

Testing Installation

测试安装情况

Test if Thumbkit is installed:
bash
thumbkit --version
测试Thumbkit是否已安装:
bash
thumbkit --version

Installation

安装步骤

bash
uv tool install https://github.com/kenneth-liao/thumbkit.git
bash
uv tool install https://github.com/kenneth-liao/thumbkit.git

Upgrading

升级方法

bash
uv tool upgrade thumbkit
bash
uv tool upgrade thumbkit

Thumbkit Documentation

Thumbkit文档

To access the full CLI reference documentation, run the following command:
bash
thumbkit docs
要访问完整的CLI参考文档,运行以下命令:
bash
thumbkit docs

REQUIRED READING

必读内容

The following documents are MANDATORY READING before generating ANY thumbnail.
  1. references/thumbnail-formulas.md
    - Design formulas for high CTR thumbnails through proven strategies. These principles apply universally across platforms.
  2. references/prompting-guidelines.md
    - Thumbnails are generated using Gemini image models (NanoBanana). The prompting guidelines will enable you to get more predictable and consistent results.
  3. You MUST read the complete Thumbkit CLI reference documentation by running
    thumbkit docs
    .
It is a MANDATORY REQUIREMENT that you follow both the design formulas and prompting guidelines in order to generate high-performing thumbnails. Failure to do so will result in a failed task.
在生成任何缩略图之前,以下文档是强制阅读的:
  1. references/thumbnail-formulas.md
    - 经验证的高CTR缩略图设计公式。这些原则适用于所有平台。
  2. references/prompting-guidelines.md
    - 缩略图使用Gemini图像模型(NanoBanana)生成。遵循提示指南可获得更可预测、更一致的结果。
  3. 必须通过运行
    thumbkit docs
    阅读完整的Thumbkit CLI参考文档。
遵循设计公式和提示指南是生成高性能缩略图的强制要求。不遵守将导致任务失败。

Platform Context

平台上下文

When invoked by orchestrator skills, platform-specific context (dimensions, safe zones, format requirements) may be provided. Use the provided context to set the correct output dimensions and constraints.
Default dimensions: When no platform context is given, default to YouTube thumbnail dimensions (1280x720, 16:9 aspect ratio).
Common platform dimensions:
  • YouTube thumbnail: 1280x720 (16:9)
  • Blog feature image: 1200x630
  • Course thumbnail: 1280x720 or 1080x1080
  • Newsletter header: 1100x220 or 1200x630
  • Social media card: 1200x675
Always confirm the target platform before generating to ensure correct dimensions.
当被编排器Skill调用时,可能会提供特定平台的上下文(尺寸、安全区域、格式要求)。请使用提供的上下文设置正确的输出尺寸和约束条件。
默认尺寸:如果未提供平台上下文,默认使用YouTube缩略图尺寸(1280x720,16:9宽高比)。
常见平台尺寸:
  • YouTube缩略图:1280x720(16:9)
  • 博客特色图片:1200x630
  • 课程缩略图:1280x720 或 1080x1080
  • 通讯邮件头图:1100x220 或 1200x630
  • 社交媒体卡片:1200x675
生成前务必确认目标平台,以确保尺寸正确。

Reference Images

参考图片

With both generating and editing thumbnails, you can include reference images. Examples include but are not limited to thumbnail templates, headshots, icons, logos, or images for style transfer. See the Prompting Guidelines above for more.
All reference images MUST be passed using absolute paths.
在生成和编辑缩略图时,你可以使用参考图片,例如缩略图模板、头像、图标、标志或用于风格迁移的图片等。更多信息请参阅上述提示指南。
所有参考图片必须使用绝对路径传递。

Using Official Logos

使用官方标志

If using company logos, use actual images by passing the absolute path to the image files instead of simply describing them. Nanobanana does not know what common company logos look like.
If a company logo is not locally available, you can search for it online and download it using curl, then pass the absolute path to the downloaded image in the prompt. Save all downloaded images to
./downloads/
, making the directory if it does not exist.
如果使用公司标志,请通过传递图片文件的绝对路径来使用实际图片,而不是仅描述它。NanoBanana不知道常见公司标志的样子。
如果本地没有公司标志,你可以在线搜索并使用curl下载,然后在提示中传递下载图片的绝对路径。将所有下载的图片保存到
./downloads/
目录,如果目录不存在则创建它。

Common Mistakes to Avoid

需避免的常见错误

WRONG: "create the Claude AI logo (an orange C shape)" CORRECT: Pass the actual logo file as a reference image
WRONG: "add the Python logo" CORRECT: Use
/absolute/path/to/python-logo.png
as a reference image
错误示例:"创建Claude AI的标志(橙色C形)" 正确做法:传递实际的标志文件作为参考图片
错误示例:"添加Python标志" 正确做法:使用
/absolute/path/to/python-logo.png
作为参考图片

Proven Designs

经验证的设计方案

If you know the content title or subject, search for related OUTLIER content. Focus on OUTLIERS because they are already proven to work well and very likely have high click-through rates. Videos are outliers if they have a high amount of views compared to the subscriber count of the channel. For example, if a video has 10,000+ views from a channel with less than 5,000 subscribers, that video is an outlier.
Once you have a list of outlier videos, you can access their thumbnails and use them to style transfer.
Here is a URL example of a standard definition thumbnail for a video with id "rmvDxxNubIg":
https://img.youtube.com/vi/rmvDxxNubIg/sddefault.jpg
. You can download the image using curl to
./downloads/outliers/
, and then read the image file to understand it. Use it as a reference image when using for style transfer.
如果你知道内容标题或主题,请搜索相关的异类内容。重点关注异类内容,因为它们已被证明效果良好,且很可能拥有高点击率。如果一个频道的订阅量少于5000,但视频的观看量超过10000,那么该视频就是异类内容。
一旦你有了异类视频列表,你可以获取它们的缩略图并用于风格迁移。
以下是视频ID为"rmvDxxNubIg"的标清缩略图的URL示例:
https://img.youtube.com/vi/rmvDxxNubIg/sddefault.jpg
。你可以使用curl将图片下载到
./downloads/outliers/
,然后读取图片文件以了解其设计。将其作为参考图片用于风格迁移。

Brand Compliance

品牌合规性

When creating visual assets for The AI Launchpad, invoke
branding-kit:brand-guidelines
to resolve the correct design system and check anti-patterns. This ensures all thumbnails are consistent with the established brand identity, color palette, and visual style.
For other brands, check if a brand guidelines skill exists at
~/.claude/skills/
and apply any relevant design constraints.
在为The AI Launchpad创建视觉资产时,调用
branding-kit:brand-guidelines
以获取正确的设计系统并检查反模式。这可确保所有缩略图与既定的品牌标识、调色板和视觉风格保持一致。
对于其他品牌,请检查
~/.claude/skills/
目录下是否存在品牌指南Skill,并应用任何相关的设计约束。

Workflows

工作流程

Generating Thumbnail Concepts

生成缩略图概念

Once you have generated an initial thumbnail concept or prompt, you MUST use the
Thumbnail Reviewer
agent to review the concept and provide feedback. The reviewer will provide a critique and suggest improvements. Consider the reviewer's feedback and incorporate it before proceeding. DO NOT go through the generate-review-regenerate loop more than ONCE.
一旦你生成了初始的缩略图概念或提示,你必须使用
Thumbnail Reviewer
agent来审核概念并提供反馈。审核者将给出评价和改进建议。请考虑审核者的反馈并将其纳入后续工作。请勿进行超过一次的“生成-审核-重新生成”循环。

Optimizing Thumbnails

优化缩略图

Because you can edit a base image with Thumbkit, you can iteratively modify and improve a previously generated thumbnail. For example, if you have generated a thumbnail but want to change the color scheme:
bash
thumbkit edit \
  --base absolute/path/to/original-thumbnail.png \
  --prompt "Keep everything the same, but change the text color to bright red."
Always review generated thumbnails to ensure they meet the complete design formulas and original intent. If not, you can iterate by editing the original thumbnail. DO NOT go through the generate-review-regenerate loop more than ONCE.
由于你可以使用Thumbkit编辑基础图片,因此你可以迭代修改和优化之前生成的缩略图。例如,如果你生成了一张缩略图,但想更改配色方案:
bash
thumbkit edit \
  --base absolute/path/to/original-thumbnail.png \
  --prompt "Keep everything the same, but change the text color to bright red."
请始终审核生成的缩略图,确保它们符合完整的设计公式和初始意图。如果不符合,你可以通过编辑原始缩略图进行迭代。请勿进行超过一次的“生成-审核-重新生成”循环。

User Assets

用户资产

If the user has specified any local assets (e.g. thumbnail templates, headshots, icons, logos, etc.) in their local context, bias towards incorporating them into the thumbnail when relevant. For example, thumbnails with actual people in them have been shown to perform better.
如果用户在本地上下文中指定了任何本地资产(例如缩略图模板、头像、图标、标志等),请在相关情况下优先将其纳入缩略图设计。例如,包含真实人物的缩略图已被证明效果更好。