read-image

name read-image description Use when the user asks to read, analyze, describe, or understand the content of an image file (local path or URL). Supports screenshots, photos, diagrams, charts, UI mockups, and any visual content. Read Image Analyze image content using a vision model via OpenAI-compatible API. Supports local files and URLs. When to Use User asks "what's in this image/screenshot?" User provides an image path or URL and wants it described or analyzed Need to extract text (OCR), identify UI elements, read diagrams/charts User asks to compare or understand visual content Usage Run read_image.py via Bash: # Local file python3 ~/.claude/skills/read-image/read_image.py /path/to/image.png "Describe this image" # URL python3 ~/.claude/skills/read-image/read_image.py "https://example.com/photo.jpg" "What text is in this image?" Arguments: image_source (required): Local file path or http(s):// URL prompt (optional): Instruction for the model. Default: "Describe this image in detail." Output: JSON with success , content (model response), source_type ("local"/"url"), was_resized , usage . Environment Variables ANTHROPIC_BASE_URL — API base URL (must end with /v1 ) ANTHROPIC_AUTH_TOKEN — API key Dependencies openai (required): pip3 install openai Pillow (optional but recommended): pip3 install Pillow — enables automatic image resizing for large files Image Processing Large images are automatically resized (max 2048px, max 3MB) via Pillow Only proportional scaling and JPEG quality compression — never crops URL images are downloaded to memory only, no temp files created Without Pillow, images are sent as-is Common Prompts Task Prompt General description "Describe this image in detail." OCR / text extraction "Extract all text from this image." UI analysis "Describe the UI layout and components." Diagram reading "Explain the diagram and its relationships." Identify content "What is shown in this image?"