youtube-thumbnail
Compare original and translation side by side
🇺🇸
Original
English🇨🇳
Translation
ChineseYouTube Thumbnail Skill
YouTube缩略图Skill
This skill enables generation of high-performing YouTube thumbnails optimized for click-through rate (CTR). Thumbnails are designed to spark curiosity, complement titles, and compel viewers to click.
该Skill可生成经过点击率(CTR)优化的高效果YouTube缩略图。缩略图的设计旨在激发好奇心、补充标题内容,并促使观众点击。
Thumbkit
Thumbkit
You have access to Thumbkit, a CLI tool for generating and editing high-performing YouTube 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,一款用于生成和编辑高效果YouTube缩略图的CLI工具。你必须使用Thumbkit来生成和编辑所有缩略图。
使用Thumbkit是你完成任务的强制要求。假设Thumbkit已作为uv工具安装,且在用户系统中全局可用。如果未安装Thumbkit,你必须先安装它再继续。
Testing Installation
测试安装
Test if Thumbkit is installed:
bash
thumbkit --version测试Thumbkit是否已安装:
bash
thumbkit --versionInstallation
安装
bash
uv tool install https://github.com/kenneth-liao/thumbkit.gitbash
uv tool install https://github.com/kenneth-liao/thumbkit.gitUpgrading
升级
bash
uv tool upgrade thumbkitbash
uv tool upgrade thumbkitThumbkit 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.
- - The design requirements are what enable you to generate high click-through-rate thumbnails through proven strategies.
references/design-requirements.md - - Thumbnails are generated using Gemini image models (NanoBanana). The prompting guidelines will enable you to get more predictable and consistent results from the Gemini image models.
references/prompting-guidelines.md - You MUST read the complete Thumbkit CLI reference documentation by running .
thumbkit docs
It's a MANDATORY REQUIREMENT that you follow both the design requirements and prompting guidelines in order to generate high converting thumbnails. Failure to do so will result in a failed task.
在生成任何缩略图之前,以下文档是必须阅读的。
- - 设计要求包含经过验证的策略,可帮助你生成高点击率的缩略图。
references/design-requirements.md - - 缩略图使用Gemini图像模型(NanoBanana)生成。提示指南将帮助你从Gemini图像模型获得更可预测、更一致的结果。
references/prompting-guidelines.md - 你必须通过运行阅读完整的Thumbkit CLI参考文档。
thumbkit docs
严格遵循设计要求和提示指南是生成高转化缩略图的强制要求。不遵守这些要求将导致任务失败。
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 , making the dir if it doesn't exist.
./youtube/downloads/如果使用公司标志,请通过传递图片文件的绝对路径来使用实际图片,而不是仅描述它们。NanoBanana不知道常见公司标志的样子。
如果本地没有公司标志,你可以在线搜索并使用curl下载,然后在提示中传递下载图片的绝对路径。将所有下载的图片保存到目录,如果该目录不存在则创建它。
./youtube/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 as a reference image
/absolute/path/to/python-logo.png❌ 错误:"创建Claude AI标志(橙色C形)"
✓ 正确:传递实际的标志文件作为参考图片
❌ 错误:"添加Python标志"
✓ 正确:使用作为参考图片
/absolute/path/to/python-logo.pngProven Designs
经过验证的设计
If you know the video title/subject, you can search youtube for related OUTLIER videos. 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 5000 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's an URL example of a standard definition thumbnail for a video with id "rmvDxxNubIg":
. You can download the image using curl to , and then read the image file to understand it. Use it as a reference image when using for style transfer.
https://img.youtube.com/vi/rmvDxxNubIg/sddefault.jpg./youtube/downloads/outliers/如果你知道视频的标题/主题,可以在YouTube上搜索相关的"异类"视频。重点关注异类视频,因为它们已被证明效果良好,很可能具有高点击率。异类视频指的是频道订阅数较少但视频浏览量很高的视频。例如,订阅数少于5000的频道中,浏览量超过10000的视频就是异类视频。
一旦你有了异类视频列表,你可以获取它们的缩略图并用于风格迁移。
以下是视频ID为"rmvDxxNubIg"的标准清晰度缩略图的URL示例:
。你可以使用curl将图片下载到目录,然后查看该图片以了解其设计。将其作为参考图片用于风格迁移。
https://img.youtube.com/vi/rmvDxxNubIg/sddefault.jpg./youtube/downloads/outliers/Workflows
工作流程
Generating Thumbnail Concepts
生成缩略图概念
Once you have generated an initial thumbnail concept or prompt, you MUST use the 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来审核概念并提供反馈。审核者将给出评价并提出改进建议。考虑审核者的反馈并将其纳入修改后再继续。请勿进行超过一次的生成-审核-重新生成循环。
Thumbnail ReviewerOptimizing Thumbnails
优化缩略图
Because you can edit a base image with Thumbkit, you can iteratively modify/improve a previously generated thumbnail. For example, if you've 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 requirements 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.
如果用户在本地上下文中指定了任何本地资产(例如缩略图模板、头像、图标、标志等),在相关情况下优先将它们纳入缩略图。例如,包含真实人物的缩略图表现更好。