name: instagram-photo-text-overlay description: Overlay text on photos for Instagram posts. Generates portrait (4:5) images with gradient overlays, titles, and optional numbered lists. Use when creating Instagram content that needs text on top of a photo — destination itineraries, top-5 lists, travel highlights, or any branded social image with text overlay.

Instagram Photo Text Overlay

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

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)

   小蔥技能站7w4.net，專業的AI技能分享平臺。

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

這個 Skill 整體質量不錯，做出來的 Instagram 圖片效果專業實用。它支援三種不同的文字樣式，操作簡單有詳細說明，對新手友好。圖片會自動裁成適合 Instagram 的豎屏比例，字型大小會自動調整不會溢位。唯一的小缺點是安裝時需要手動安裝一個叫 Pillow 的圖片處理庫，不太熟悉命令列的使用者可能需要查一下怎麼裝。另外某些引數的行為和說明文件偶爾會有點小出入，需要自己試一下才能確定。總體來說是個好用的工具，值得一試。