feat: Higgsfield YouTube Thumbnail

Author: arsuhf

.claude-plugin/marketplace.json

@@ -8,7 +8,7 @@
     {
       "name": "higgsfield",
       "source": "./",
-      "description": "Image/video generation, narrated explainers, browser games, Marketing Studio, video engagement analysis, and Soul Character training via the Higgsfield CLI.",
+      "description": "Image/video generation, narrated explainers, YouTube thumbnails, browser games, Marketing Studio, video engagement analysis, and Soul Character training via the Higgsfield CLI.",
       "version": "0.12.0",
       "skills": [
         {
@@ -41,6 +41,11 @@
           "path": "higgsfield-video-explainer",
           "invoke": "/higgsfield:video-explainer"
         },
+        {
+          "name": "youtube-thumbnail",
+          "path": "higgsfield-youtube-thumbnail",
+          "invoke": "/higgsfield:youtube-thumbnail"
+        },
         {
           "name": "game-generation",
           "path": "higgsfield-game-generation",

.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "higgsfield",
   "version": "0.12.0",
-  "description": "Higgsfield AI skills for images, videos, narrated explainers, browser games, Marketing Studio, engagement analysis, and Soul Character training.",
+  "description": "Higgsfield AI skills for images, videos, narrated explainers, YouTube thumbnails, browser games, Marketing Studio, engagement analysis, and Soul Character training.",
   "author": {
     "name": "Higgsfield AI",
     "url": "https://higgsfield.ai"
@@ -23,6 +23,7 @@
     "ugc",
     "avatar",
     "video-explainer",
-    "game-generation"
+    "game-generation",
+    "youtube-thumbnail"
   ]
 }

.codex-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "higgsfield",
   "version": "0.12.0",
-  "description": "Image/video generation, narrated explainers, browser games, Marketing Studio, engagement analysis, and Soul Character training via Higgsfield AI.",
+  "description": "Image/video generation, narrated explainers, YouTube thumbnails, browser games, Marketing Studio, engagement analysis, and Soul Character training via Higgsfield AI.",
   "author": {
     "name": "Higgsfield AI",
     "email": "support@higgsfield.ai",
@@ -19,13 +19,14 @@
     "marketing-studio",
     "marketplace-cards",
     "video-explainer",
-    "game-generation"
+    "game-generation",
+    "youtube-thumbnail"
   ],
   "skills": "./",
   "interface": {
     "displayName": "Higgsfield AI",
     "shortDescription": "Train Soul Characters and generate powerful AI visuals",
-    "longDescription": "Higgsfield AI Skills turn Codex into a creative production agent. Train reusable Soul Characters, generate images and videos, create narrated explainers, build playable browser games, produce product and marketplace visuals, create branded Marketing Studio ads, and score finished videos. The plugin uses the Higgsfield CLI for authenticated workflows and returns ready-to-use URLs or reports.",
+    "longDescription": "Higgsfield AI Skills turn Codex into a creative production agent. Train reusable Soul Characters, generate images and videos, create narrated explainers and YouTube thumbnails, build playable browser games, produce product and marketplace visuals, create branded Marketing Studio ads, and score finished videos. The plugin uses the Higgsfield CLI for authenticated workflows and returns ready-to-use URLs or reports.",
     "developerName": "Higgsfield AI",
     "category": "Design",
     "capabilities": [
@@ -39,6 +40,7 @@
       "Analyze this ad video for engagement and hook strength",
       "Create marketplace-ready product cards for this item",
       "Turn this document into a narrated explainer",
+      "Create a YouTube thumbnail for this video",
       "Build and deploy a small browser game"
     ],
     "brandColor": "#D1FE17",

.cursor-plugin/plugin.json

@@ -3,7 +3,7 @@
   "name": "higgsfield",
   "displayName": "Higgsfield AI",
   "version": "0.12.0",
-  "description": "Image/video generation, narrated explainers, browser games, Marketing Studio, engagement analysis, and Soul Character training via Higgsfield AI.",
+  "description": "Image/video generation, narrated explainers, YouTube thumbnails, browser games, Marketing Studio, engagement analysis, and Soul Character training via Higgsfield AI.",
   "author": {
     "name": "Higgsfield AI",
     "email": "support@higgsfield.ai"
@@ -23,6 +23,7 @@
     "ai-video",
     "ai-image",
     "video-explainer",
-    "game-generation"
+    "game-generation",
+    "youtube-thumbnail"
   ]
 }

README.md

@@ -2,7 +2,7 @@
 
 [![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](./LICENSE)
 [![Version](https://img.shields.io/badge/version-0.3.0-green.svg)](./VERSION)
-[![Skills](https://img.shields.io/badge/skills-7-blueviolet.svg)](#skills)
+[![Skills](https://img.shields.io/badge/skills-8-blueviolet.svg)](#skills)
 [![Discord](https://img.shields.io/badge/discord-join-5865F2?logo=discord&logoColor=white)](https://discord.com/invite/higgsfield)
 
 AI agent skills for image/video generation via [Higgsfield AI](https://higgsfield.ai), including Marketing Studio and Virality Predictor video scoring. Works with Claude Code, Cursor, Codex, and other AI coding agents that load Markdown-based skills.
@@ -56,9 +56,10 @@ More options in [INSTALL.md](./INSTALL.md). Agent-driven install (paste into you
 | [`higgsfield-marketplace-cards`](./higgsfield-marketplace-cards) | `/higgsfield:marketplace-cards` | Marketplace product cards: compliant main image, secondary product images, and A+ style modules via backend prompt enhancement. |
 | [`higgsfield-websites`](./higgsfield-websites) | `/higgsfield:websites` | Build, edit, and deploy full-stack websites — React 19 + TanStack Start, server-rendered as one Cloudflare Worker with D1 / R2 / KV / Durable Objects / Containers. Create → get git repo access → edit locally → push → deploy preview/production, all via `higgsfield website …`. |
 | [`higgsfield-video-explainer`](./higgsfield-video-explainer) | `/higgsfield:video-explainer` | Create a narrated non-photoreal explainer as matched Seed Audio + Gemini Omni blocks, then assemble the final MP4 with `explainer_video`. |
+| [`higgsfield-youtube-thumbnail`](./higgsfield-youtube-thumbnail) | `/higgsfield:youtube-thumbnail` | Create truthful, high-impact YouTube thumbnails and vertical video covers with identity-preserving references, controlled variants, focused edits, and optional text-overlay guidance. |
 | [`higgsfield-game-generation`](./higgsfield-game-generation) | `/higgsfield:game-generation` | Plan, build, verify, and deploy playable browser games, or generate game-specific sprites, textures, rigged 3D assets, and audio. |
 
-The skills chain: train Soul → use the reference id in `generate` (including Marketing Studio jobs). `product-photoshoot` and `marketplace-cards` are self-contained — backend enhances prompts before submitting image jobs. `websites` chains with `generate` to embed bespoke hero images, video loops, and OG assets in the site.
+The skills chain: train Soul → use the reference id in `generate` (including Marketing Studio jobs). `product-photoshoot` and `marketplace-cards` are self-contained — backend enhances prompts before submitting image jobs. `youtube-thumbnail` can follow any video workflow once its truthful topic and visual direction are known. `websites` chains with `generate` to embed bespoke hero images, video loops, and OG assets in the site.
 
 ### Modes
 
@@ -106,6 +107,7 @@ The skills chain: train Soul → use the reference id in `generate` (including M
 | Image-to-video animation | `higgsfield-generate` | Prefer `seedance_2_0` with `--start-image`; use `kling3_0` as lower-cost fallback |
 | Build / edit / deploy a website, web app, landing page, or dashboard | `higgsfield-websites` | Full-stack React 19 + TanStack Start on Cloudflare; `higgsfield website create/repo-access/deploy` |
 | Create a narrated explainer from a topic or document | `higgsfield-video-explainer` | Resolves a live style, generates audio then video per block, and assembles with `explainer_video` |
+| Create a YouTube thumbnail or Shorts/Instagram video cover | `higgsfield-youtube-thumbnail` | Nano Banana Pro 4K main render, optional face/logo references, controlled variants, and Seedream tweaks |
 | Build and deploy a playable browser game | `higgsfield-game-generation` | Owns game design, assets, implementation, QA, deploy, and optional marketplace publish |
 
 ## License

higgsfield-generate/SKILL.md

@@ -12,13 +12,11 @@ description: |
   sketch", "create a 3D model/GLB", "create a sound effect",
   "make music", "text-to-audio", "create an ad", "make a UGC
   video", "unboxing", "presenter video", "import product from
-  URL", or "analyze video virality". Supports image-to-3D
-  (`multi_image_to_3d`),
-  text-to-audio/music (`seed_audio`), workflow generation
-  (`draw_to_video`, `reframe`), Marketing Studio, and
-  Virality Predictor (`brain_activity`).
+  URL", or "analyze video virality". Supports generic generation,
+  workflows, Marketing Studio, and Virality Predictor.
   Chain with higgsfield-soul-id for face/identity consistency.
-  NOT for: Soul training, photoshoots, cards, explainers (use
+  NOT for: Soul training, photoshoots, cards, YouTube thumbnails
+  (use higgsfield-youtube-thumbnail), explainers (use
   higgsfield-video-explainer), playable games/assets (use
   higgsfield-game-generation), or TTS.
 argument-hint: "[prompt-or-analysis-request] [--model <name>] [--image|--video <path-or-id>]"
@@ -76,6 +74,7 @@ If the user says "analyze this video", "score this ad", "evaluate the hook", or
    - **Seed Audio 1.0** → default audio model for text-to-audio, voice, sound effects, ambience, foley, and music-like audio unless the user names Sonilo/Mirelo.
 
    **Image:**
+   - YouTube thumbnail, Shorts cover, or Instagram video cover → use `higgsfield-youtube-thumbnail` instead.
    - Brand product visual (Pinterest pin, lifestyle, hero banner, ad pack, virtual try-on) → use `higgsfield-product-photoshoot` instead. NOT this skill.
    - Generated product concept / packaging / can / bottle with brand name or label text → GPT Image 2.
    - Branded ad image with avatar + product (Marketing Studio shape) → Marketing Studio Image (see Marketing Studio below)