Instagram Photo Text Overlay

Overlay text on photos for Instagram posts. Generates portrait (4:5) images with gradient overlays, titles, and optional numbered lists. Use when creating In...

Security Scan

The skill's files and runtime instructions are consistent with an image text-overlay utility; nothing in the visible code or SKILL.md requests unrelated credentials or network access, but the main() body was truncated so full verification is incomplete.

Purpose & Capability

Name/description, the SKILL.md usage, and the included scripts/overlay.py all align: they implement drawing gradients and text on an input image and writing an output image. The declared requirements (Python + Pillow) match what the script uses. No unrelated credentials, binaries, or config paths are requested.

Instruction Scope

SKILL.md gives explicit CLI usage that only reads an input image and writes an output image. The doc has a small vague tip («pull top picks from existing itineraries when available») which is a content suggestion rather than an instruction to read other files, and the visible code only touches image and font paths. Recommend reviewing the truncated main() to confirm it doesn't perform extra IO (reading arbitrary files) or network requests.

Install Mechanism

This is an instruction-only skill with a single Python script; there is no install spec. SKILL.md correctly notes Python 3 and Pillow (pip install Pillow). No downloads or execution of remote code are specified in the visible files.

Credentials

The skill requires no environment variables, credentials, or config paths. The script references common system font paths (macOS/Linux) which is expected for rendering and not sensitive. No secrets are requested or used in the visible code.

Persistence & Privilege

The skill does not request persistent or elevated presence (always:false). It doesn't modify other skills or system-wide settings in the visible code.

Assessment

This appears to be a straightforward image overlay tool: install Python + Pillow, run the script with an input photo and output path. Before using, verify the rest of the script (the truncated main() portion) to ensure it doesn't make network requests or read/write unexpected files. Run it on non-sensitive images first and, if you want extra safety, execute it in a sandbox/container. If you want me to check the missing part of the file (the remainder of main()), paste it and I'll re-evaluate with higher confidence.

Overlay text onto photos for Instagram-ready images. Two styles: list (title + numbered items) and clean (title only).

Quick Start

python3 scripts/overlay.py \
  --input photo.jpg \
  --output result.jpg \
  --title "TAORMINA" \
  --subtitle "3-Day Trip Itinerary" \
  --items '["Teatro Greco|Ancient theatre with Etna views", "Isola Bella|Crystal-clear beach"]' \
  --style list

Options

Flag	Default	Description
--input	(required)	Source photo path
--output	(required)	Output image path
--title	(required)	Main title (auto-uppercased)
--subtitle	"3-Day Trip Itinerary"	Subtitle below title
--items	[]	JSON array of "Name|Reason" strings (list style)
--watermark	"tabiji.ai"	Top-left watermark (empty string to disable)
--accent	255,220,150	Accent color for numbers/tags (R,G,B)
--quote	""	Quote text (for quote style)
--style	list	list / clean / quote
--quality	95	JPEG output quality

Styles

• clean: Cover slide. Big title = destination + category + count (e.g. "7 unique cheap eats in barcelona spain"). Subtitle = credibility/source line (e.g. "Insider takes from r/barcelona"). Best as carousel first slide.
• list: Content slides. Title + subtitle + divider + numbered items with reasons. Best for top-5 / itinerary posts.
• quote: Title with accent bar on the left + blockquote text below. No subtitle or divider. Best for travel quotes, testimonials, or key takeaways.

Workflow

1. Receive photo + destination/topic + list of items from user
2. Run scripts/overlay.py with appropriate args
3. Output is auto-cropped to 4:5 portrait (Instagram optimal)
4. Review output and adjust if needed (font sizes scale with image width)

Requirements

• Python 3 + Pillow (pip install Pillow)
• Works on macOS (Helvetica) and Linux (DejaVu/Liberation fallback)

Tips

• Items format: "Name|Short reason" — the pipe separates bold name from description
• For destinations, pull top picks from existing itineraries when available
• Gradient + white text ensures readability on any photo
• All font sizes are proportional to image width — works at any resolution