← Back to Skills Marketplace
psyduckler

Instagram Photo Text Overlay

by psyduckler · GitHub ↗ · v1.0.0
cross-platform ✓ Security Clean
933
Downloads
2
Stars
6
Active Installs
1
Versions
Install in OpenClaw
/install 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 In...
README (SKILL.md)

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

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
Usage Guidance
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.
Capability Analysis
Type: OpenClaw Skill Name: instagram-photo-text-overlay Version: 1.0.0 The skill bundle is benign. The `SKILL.md` provides clear instructions for an AI agent to use the `scripts/overlay.py` script for image text overlay, without any prompt injection attempts. The Python script uses standard libraries (Pillow, argparse, json, os) to perform image manipulation as described, with no evidence of malicious activities such as data exfiltration, unauthorized execution, persistence, or network communication. While the script processes user-provided file paths for input and output, which could be a vulnerability if the agent's inputs are not sanitized, the script itself does not exhibit malicious intent.
Capability Assessment
✓ 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.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install instagram-photo-text-overlay
  3. After installation, invoke the skill by name or use /instagram-photo-text-overlay
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial release
Metadata
Slug instagram-photo-text-overlay
Version 1.0.0
License —
All-time Installs 6
Active Installs 6
Total Versions 1
Frequently Asked Questions

What is 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... It is an AI Agent Skill for Claude Code / OpenClaw, with 933 downloads so far.

How do I install Instagram Photo Text Overlay?

Run "/install instagram-photo-text-overlay" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Instagram Photo Text Overlay free?

Yes, Instagram Photo Text Overlay is completely free (open-source). You can download, install and use it at no cost.

Which platforms does Instagram Photo Text Overlay support?

Instagram Photo Text Overlay is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Instagram Photo Text Overlay?

It is built and maintained by psyduckler (@psyduckler); the current version is v1.0.0.

More Skills
self-improving agent
Captures learnings, errors, and corrections to enable continuous improvement. Use when: (1) A command or operation fails unexpectedly, (2) User corrects Clau...
⬇ 463815 · by pskoett
Skill Vetter
Security-first skill vetting for AI agents. Use before installing any skill from ClawdHub, GitHub, or other sources. Checks for red flags, permission scope, and suspicious patterns.
⬇ 259802 · by spclaudehome
Polymarket
Query Polymarket prediction markets. Check odds, find trending markets, search events, track price movements.
⬇ 232503 · by joelchance
Self-Improving + Proactive Agent
Self-reflection + Self-criticism + Self-learning + Self-organizing memory. Agent evaluates its own work, catches mistakes, and improves permanently. Use when...
⬇ 200680 · by ivangdavila
Github
Interact with GitHub using the `gh` CLI. Use `gh issue`, `gh pr`, `gh run`, and `gh api` for issues, PRs, CI runs, and advanced queries.
⬇ 191345 · by steipete
ontology
Typed knowledge graph for structured agent memory and composable skills. Use when creating/querying entities (Person, Project, Task, Event, Document), linkin...
⬇ 190333 · by oswalpalash

💬 Comments