media-image

/media-image — Image Generation & Management

Generate contextual images for your post and resize them for each platform.

Uses excalidraw-skill for diagrams and illustrations (hand-drawn Excalidraw style). Optionally uses DALL-E for photo-style hero images.

Prerequisites

Before starting, read these shared library files:

• Read lib/image-processing.md for resizing commands and platform sizes
• Read lib/manifest-ops.md for updating the manifest
• Read lib/adapter-discovery.md for platform image size requirements

Step 1: Locate the Post

If the user specifies a post path, use it. Otherwise, find the most recent post:

ls -dt content/posts/*/ 2>/dev/null | head -1

Read source.md to understand the content. Read manifest.yaml for existing state.

Step 2: Check Dependencies

echo "=== Image Dependencies ==="

# Check ImageMagick (for resizing)
which convert >/dev/null 2>&1 && echo "[OK] ImageMagick" || echo "[MISSING] ImageMagick — needed for resizing (brew install imagemagick)"

# Check excalidraw-skill (for diagrams)
EXCALIDRAW_SKILL=""
[ -f ".claude/skills/excalidraw-skill/skill/SKILL.md" ] && EXCALIDRAW_SKILL="local"
[ -f "$HOME/.claude/skills/excalidraw-skill/skill/SKILL.md" ] && EXCALIDRAW_SKILL="global"
[ -n "$EXCALIDRAW_SKILL" ] && echo "[OK] excalidraw-skill ($EXCALIDRAW_SKILL)" || echo "[MISSING] excalidraw-skill — install from https://github.com/Minara-AI/excalidraw-skill"

# Check OpenAI API key (optional, for photo-style hero images)
grep -q "^OPENAI_API_KEY=." .env 2>/dev/null && echo "[OK] DALL-E (photo hero images)" || echo "[OPTIONAL] No OPENAI_API_KEY — DALL-E unavailable, using excalidraw only"

Step 3: Plan Images

Analyze source.md and identify where images would add value:

1. Hero/cover image: A cover image that captures the article's theme
2. In-article diagrams: Architecture diagrams, flowcharts, concept maps
3. In-article illustrations: Visual explanations for complex concepts