youtube-thumbnail

# YouTube Thumbnail 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.

## 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.

### Testing Installation

Test if Thumbkit is installed:

```bash
thumbkit --version
```

### Installation

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

### Upgrading

```bash
uv tool upgrade thumbkit
```

### Thumbkit Documentation

To access the full CLI reference documentation, run the following command:

```bash
thumbkit docs
```

## 🚨 REQUIRED READING 🚨

The following documents are **MANDATORY READING** before generating ANY thumbnail.

1. `references/design-requirements.md` - The design requirements are what enable you to generate high click-through-rate thumbnails through proven strategies.
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 from the Gemini image models.
3. 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.

## 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 fo