Agent skill · creative production · openclaudia
unsplash-image
Search for images on Unsplash and download them. Optionally add text overlay (title/subtitle) to the image. Use when the user asks to find a stock photo, search for an image, get an Unsplash image, or download a photo with text.
Why this skill is useful
Adds a script for searching and downloading images from Unsplash with optional text overlay, which is not commonly available in standard libraries.
What it needs
Requires pillow, requests installed locally. About 2k tokens when loaded. Last updated 2026-08-07. 620 stars on the source repository.
What this skill does
Unsplash Image Search & Download Search Unsplash for images, download them, and optionally add text overlay. Tool Location Script: ~/.agents/tools/unsplash-search.py Env file: ~/.agents/tools/.env (contains UNSPLASHCLIENTID) Quick Usage Search and download a random matching image With orientation filter With text overlay (title and subtitle) List results without downloading Pick the first result instead of random CLI Options Option Description -------- ------------- --query, -q (Required) Search query string --output, -o (Required unless --list) Output file path --orientation Filter: landscape, portrait, or squarish --color Color filter (e.g., blue, green, red, blackandwhite) --pick How to select from results: random (default) or first --title Title text to overlay on the image --subtitle Subtitle text to overlay (only used with --title) --list List search results instead of downloading --count Number of results to fetch, max 30 (default: 30) Text Overlay When --title is provided, the script adds a text overlay to the bottom portion of the image with: Semi-transparent dark background behind the text White title text with shadow Gray subtitle text (if provided) Automatic word wrapping and font sizing Requires Pillow: pip install Pillow Dependencies requests (for API calls and image download) Pillow (only needed if using text overlay with --title) Install if needed: Output The script prints: The download URL Photographer attribution (required by Unsplash) The saved file path Confirmation of text overlay if applied Notes Unsplash API guidelines require attribution. The script prints photographer info. The script triggers Unsplash's download tracking endpoint as required by their API terms. Images are downloaded at "regular" quality (1080px width). For higher resolution, modify the script to use urls.full or urls.raw.
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills openclaudia/stock-images