muapi-youtube-thumbnail

Q: How do I install muapi-youtube-thumbnail?

Run npx skills add https://github.com/samuraigpt/generative-media-skills --skill muapi-youtube-thumbnail in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/muapi-youtube-thumbnail/ (personal) or .claude/skills/muapi-youtube-thumbnail/ (project).

by samuraigptMedia & Creative

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

Installs: 2.5K
Last 24h: +9
Trending rank: #9260
Security: Not audited

Install

Works with every agent the skills CLI supports.

npx skills add https://github.com/samuraigpt/generative-media-skills --skill muapi-youtube-thumbnail

01
Install
Run the command in your project. The CLI asks which agents to install for.
02
Describe the task
Ask your agent for something this skill covers. It loads muapi-youtube-thumbnail automatically when relevant.
03
Review the result
The agent follows the SKILL.md steps, scripts and references bundled with the skill.

SKILL.md

The instructions your agent reads when the skill is triggered.

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

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.
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/<endpoint> -H "x-api-key: $MUAPI_API_KEY" -H 'content-type: application/json' -d '{...}' and poll with muapi predict wait <request_id>.
Substitute {{input_name}} placeholders with the user's actual inputs before issuing each call.

FAQ

What does the muapi-youtube-thumbnail skill do?

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

How do I install muapi-youtube-thumbnail?

Run npx skills add https://github.com/samuraigpt/generative-media-skills --skill muapi-youtube-thumbnail in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/muapi-youtube-thumbnail/ (personal) or .claude/skills/muapi-youtube-thumbnail/ (project).

Which AI agents can use muapi-youtube-thumbnail?

Any agent that supports the open Agent Skills format (a folder with a SKILL.md file), including Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf, Cline, OpenCode and more.

Is muapi-youtube-thumbnail safe to install?

No partner security audit is available yet. Skills can run commands and scripts, so read the SKILL.md and any bundled files before installing.

Who maintains muapi-youtube-thumbnail?

It is published by samuraigpt in samuraigpt/generative-media-skills. It has 2,518 recorded installs.