Title Card Image
Designtitle-card-imageTitle 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.
How to use this skill
Bring this guide into your coding agent with a prompt tailored to the tool you use.
- Open your project in Codex.
- Copy and paste the prompt below.
- Review files and risks before approving any action.
Inspect the Agent Skill at https://github.com/opensquilla/opensquilla/blob/HEAD/src/opensquilla/skills/bundled/title-card-image/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/title-card-image, but wait for my approval before writing files or running scripts.
Copying this prompt does not install or run the skill. Review third-party files before use.
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-proinstead. - Headline wrap is character-count-based for CJK and whitespace-based for ASCII; mixed strings break at the CJK character count.