# Title Card Image

> Title Card Image is an Agent Skill for design published in the opensquilla/opensquilla repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

Render a static title / ending card PNG with Pillow. Centered headline + optional subtitle on a solid-colour background. CJK-friendly font fallback (Microsoft YaHei → SimHei → Songti → Noto CJK → bitmap). Pure deterministic, no LLM, no network. Used by meta-short-drama for opening and closing cards.

- Skill name: `title-card-image`
- Category: [Design](https://www.openparable.com/skill/design/1)
- Source: https://github.com/opensquilla/opensquilla/blob/HEAD/src/opensquilla/skills/bundled/title-card-image/SKILL.md
- Repository: opensquilla/opensquilla (6,081 GitHub stars when collected)

## SKILL.md

# title-card-image

Renders a centered-text PNG suitable for a cover / ending card before
animating into a clip with `video-still-animator`.

## Inputs (`with:`)

| key | required | default | notes |
|---|---|---|---|
| `text` | yes | — | Headline text. Auto-wraps at ~10 chars per line for CJK. |
| `output` | yes | — | Output `.png` path. |
| `subtitle` | no | `""` | Smaller line beneath the headline. |
| `background` | no | `#101018` | Hex color `#RRGGBB`. |
| `text_color` | no | `#ffffff` | Headline color. |
| `font_size` | no | `96` | Headline font size in pixels. |
| `subtitle_size` | no | `36` | Subtitle font size in pixels. |
| `width` | no | `720` | Output width in pixels. Match the merge pipeline. |
| `height` | no | `1280` | Output height. 720x1280 = 9:16. |

## Output

Prints the absolute path of the written PNG on stdout. The PNG is RGB
(no alpha), JPEG-quality-equivalent file ~30-80 KB depending on text
length.

## Font fallback

Tries `--font` if explicit, else walks a CJK-aware list of platform
defaults (Microsoft YaHei / SimHei on Windows, PingFang on macOS, Noto
CJK / WenQuanYi on Linux). If nothing loads, falls back to Pillow's
bundled bitmap font — CJK characters render as squares ("tofu") in that
worst-case but the program never crashes.

## Limits

- No alpha / transparency.
- No rich text styling (italic / drop-shadow / gradient). For richer
  cards, generate a real image via `nano-banana-pro` instead.
- Headline wrap is character-count-based for CJK and whitespace-based
  for ASCII; mixed strings break at the CJK character count.

---

Source: https://www.openparable.com/skill/design/title-card-image (OpenParable). Cite the canonical URL above.
