OpenParable
Skip to content
← Back to skills

Title Card Image

Design
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.

View on GitHub ↗
QUICK START

How to use this skill

Bring this guide into your coding agent with a prompt tailored to the tool you use.

  1. Open your project in Codex.
  2. Copy and paste the prompt below.
  3. Review files and risks before approving any action.
Prompt to paste
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:)

keyrequireddefaultnotes
textyes—Headline text. Auto-wraps at ~10 chars per line for CJK.
outputyes—Output .png path.
subtitleno""Smaller line beneath the headline.
backgroundno#101018Hex color #RRGGBB.
text_colorno#ffffffHeadline color.
font_sizeno96Headline font size in pixels.
subtitle_sizeno36Subtitle font size in pixels.
widthno720Output width in pixels. Match the merge pipeline.
heightno1280Output 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.