# Muapi Youtube Thumbnail

> Design a high-CTR YouTube thumbnail — striking imagery, bold text placement, and emotional face/subject if needed.

- **Type:** Skill
- **Install:** `agentstack add skill-samuraigpt-generative-media-skills-muapi-youtube-thumbnail`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [SamurAIGPT](https://agentstack.voostack.com/s/samuraigpt)
- **Installs:** 0
- **Category:** [Content & Media](https://agentstack.voostack.com/c/content-and-media)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [SamurAIGPT](https://github.com/SamurAIGPT)
- **Source:** https://github.com/SamurAIGPT/Generative-Media-Skills/tree/main/.opencode/skills/muapi-youtube-thumbnail
- **Website:** https://muapi.ai?utm_source=github&utm_medium=about&utm_campaign=generative-media-skills

## Install

```sh
agentstack add skill-samuraigpt-generative-media-skills-muapi-youtube-thumbnail
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# YouTube Thumbnail

**Design a high-CTR YouTube thumbnail — striking imagery, bold text placement, and emotional face/subject if needed.**

## Inputs

| Name | Type | Required | Default | Description |
|:---|:---|:---|:---|:---|
| `title` | text | yes | — | The video title or topic (e.g. "I tried 7 AI tools in 24 hours — here's what happened"). |
| `channel_style` | text | no | bold, high contrast, bright colors, clean design, YouTube tech aesthetic | Channel brand style (e.g. "dark moody gaming", "bright educational", "minimal corporate"). |
| `subject_description` | text | no | — | Optional description of the person or subject to feature (e.g. "a surprised young man in a hoodie"). |

## Steps

Thumbnails are the #1 factor in YouTube CTR. Generate a single, maximum-impact 16:9 image.

### Phase A — Plan the composition

Before generating, briefly reason about the best thumbnail formula for this topic:
- **Emotion-first**: shocked/curious face if relevant + bold text = high CTR
- **Text overlay**: 3–5 words max, high-contrast (white/yellow on dark, or vice-versa)
- **Contrast & saturation**: thumbnails compete in a grid — they must pop

### Phase B — Generate the thumbnail

1. Build the image generation prompt:
   - Subject: `{{subject_description}}` if provided, otherwise design an object/scene that dramatizes the topic.
   - Mood: derives from `{{channel_style}}`.
   - Composition: rule-of-thirds, subject on left or right with empty space for text.
   - Style tags: `{{channel_style}}, youtube thumbnail composition, ultra detailed, vibrant, high contrast, 16:9`.
2. Call `muapi image generate` (model=gpt-image-2-text-to-image, aspect_ratio=16:9).

### Phase C — Text overlay guidance

After generation, return:
- **Suggested overlay text**: 3–5 bold words that complement the title `{{title}}`.
- **Text placement**: where on the canvas to position text (e.g. "bold yellow text, top-right third").
- **Font recommendation**: style suggestion (e.g. "Impact-style all-caps with black outline").

## Notes
- Never put too much text in the prompt — text rendering in image models is unreliable. Guide the user on adding text in post-production (Canva, Photoshop).
- If the user already has a channel image or face photo in the session, use `muapi image edit` to incorporate it.
- Suggest A/B variants only if the user asks.

## Trigger Keywords

`youtube thumbnail`, `yt thumbnail`, `thumbnail`, `video thumbnail`, `youtube cover`

---

## Notes for the Executing Agent

- This recipe is LLM-orchestrated: read each phase, gather any missing inputs from the user, then call `muapi` CLI commands. Use `muapi auth configure` first if `MUAPI_API_KEY` is unset.
- For model IDs without a CLI alias yet, fall back to the raw endpoint via `curl -X POST https://api.muapi.ai/api/v1/ -H "x-api-key: $MUAPI_API_KEY" -H 'content-type: application/json' -d '{...}'` and poll with `muapi predict wait `.
- Substitute `{{input_name}}` placeholders with the user's actual inputs before issuing each call.

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [SamurAIGPT](https://github.com/SamurAIGPT)
- **Source:** [SamurAIGPT/Generative-Media-Skills](https://github.com/SamurAIGPT/Generative-Media-Skills)
- **License:** MIT
- **Homepage:** https://muapi.ai?utm_source=github&utm_medium=about&utm_campaign=generative-media-skills

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** yes
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-samuraigpt-generative-media-skills-muapi-youtube-thumbnail
- Seller: https://agentstack.voostack.com/s/samuraigpt
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.
