Agent skill

Unsplash Image

by OpenClaudia in OpenClaudia/openclaudia-skills

Search for images on Unsplash and download them. An agent skill from OpenClaudia/openclaudia-skills.

Install Unsplash Image

skills CLI

$ npx skills add OpenClaudia/openclaudia-skills --skill unsplash-image -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI

$ gh skill install OpenClaudia/openclaudia-skills unsplash-image --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy

$ git clone --depth 1 https://github.com/OpenClaudia/openclaudia-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/stock-images .claude/skills/unsplash-image && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Paste into Claude Code

Install the "unsplash-image" agent skill from https://github.com/OpenClaudia/openclaudia-skills/tree/main/skills/stock-images into .claude/skills/unsplash-image/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "unsplash-image", then confirm the skill loads.

Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

$skill-installer

$skill-installer install https://github.com/OpenClaudia/openclaudia-skills/tree/main/skills/stock-images

Type this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.

skills CLI

$ npx skills add OpenClaudia/openclaudia-skills --skill unsplash-image -a codex

Project install goes to .agents/skills/; add -g for ~/.codex/skills/.

GitHub CLI

$ gh skill install OpenClaudia/openclaudia-skills unsplash-image --agent codex

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/OpenClaudia/openclaudia-skills.git skills-src && mkdir -p .agents/skills && cp -r skills-src/skills/stock-images .agents/skills/unsplash-image && rm -rf skills-src

Use ~/.agents/skills/ instead of .agents/skills for a personal install.

Codex skills documentation · loads skills from .agents/skills/

Paste into Codex

Install the "unsplash-image" agent skill from https://github.com/OpenClaudia/openclaudia-skills/tree/main/skills/stock-images into .agents/skills/unsplash-image/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "unsplash-image", then confirm the skill loads.

Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add OpenClaudia/openclaudia-skills --skill unsplash-image -a cursor

Project install goes to .agents/skills/; add -g for ~/.cursor/skills/.

GitHub CLI

$ gh skill install OpenClaudia/openclaudia-skills unsplash-image --agent cursor

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/OpenClaudia/openclaudia-skills.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/skills/stock-images .cursor/skills/unsplash-image && rm -rf skills-src

Use ~/.cursor/skills/ instead of .cursor/skills for a personal install.

Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/

Paste into Cursor

Install the "unsplash-image" agent skill from https://github.com/OpenClaudia/openclaudia-skills/tree/main/skills/stock-images into .cursor/skills/unsplash-image/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "unsplash-image", then confirm the skill loads.

Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

gemini skills install

$ gemini skills install https://github.com/OpenClaudia/openclaudia-skills.git --path skills/stock-images

--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.

skills CLI

$ npx skills add OpenClaudia/openclaudia-skills --skill unsplash-image -a gemini-cli

Project install goes to .agents/skills/; add -g for ~/.gemini/skills/.

GitHub CLI

$ gh skill install OpenClaudia/openclaudia-skills unsplash-image --agent gemini-cli

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/OpenClaudia/openclaudia-skills.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/skills/stock-images .gemini/skills/unsplash-image && rm -rf skills-src

Use ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.

Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/

Paste into Gemini CLI

Install the "unsplash-image" agent skill from https://github.com/OpenClaudia/openclaudia-skills/tree/main/skills/stock-images into .gemini/skills/unsplash-image/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "unsplash-image", then confirm the skill loads.

Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

GitHub CLI

$ gh skill install OpenClaudia/openclaudia-skills unsplash-image

Installs for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).

skills CLI

$ npx skills add OpenClaudia/openclaudia-skills --skill unsplash-image -a github-copilot

Project install goes to .agents/skills/; add -g for ~/.copilot/skills/.

Manual copy

$ git clone --depth 1 https://github.com/OpenClaudia/openclaudia-skills.git skills-src && mkdir -p .github/skills && cp -r skills-src/skills/stock-images .github/skills/unsplash-image && rm -rf skills-src

Use ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.

GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/

Paste into GitHub Copilot

Install the "unsplash-image" agent skill from https://github.com/OpenClaudia/openclaudia-skills/tree/main/skills/stock-images into .github/skills/unsplash-image/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "unsplash-image", then confirm the skill loads.

GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add OpenClaudia/openclaudia-skills --skill unsplash-image -a opencode

OpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.

GitHub CLI

$ gh skill install OpenClaudia/openclaudia-skills unsplash-image --agent opencode

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/OpenClaudia/openclaudia-skills.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/skills/stock-images .opencode/skills/unsplash-image && rm -rf skills-src

Use ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.

OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/

Paste into OpenCode

Install the "unsplash-image" agent skill from https://github.com/OpenClaudia/openclaudia-skills/tree/main/skills/stock-images into .opencode/skills/unsplash-image/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "unsplash-image", then confirm the skill loads.

OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

Facts

Skill name: unsplash-image
GitHub stars: 713
Token cost: ~774 tokens
SKILL.md length: 261 words
Files: 1
Skills in repo: 74
Repo updated: Sep 18, 2026
First seen: Oct 7, 2026
Licence: MIT

At a glance

Search for images on Unsplash and download them. An agent skill from OpenClaudia/openclaudia-skills.

The user asks to find a stock photo
SKILL.md covers Tool Location, Quick Usage, CLI Options and Text Overlay, plus 3 more sections
Calls python and pip
Search for an image

What it does

Unsplash Image is an agent skill from OpenClaudia/openclaudia-skills. 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.

Its SKILL.md is about 770 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Media & Creative, covering Transcription. The repository describes itself as: 77 open-source marketing skills for Claude Code, Codex, and other AI coding agents. SEO, content, email, ads, analytics, and growth. The licence is MIT.

When your agent uses it

The user asks to find a stock photo
Search for an image
Get an Unsplash image
Download a photo with text

Example prompts

“/unsplash-image”

Requirements

Python 3
Pre-approved tools (allowed-tools): Bash(*), Read, Write

What it can do on your machine

Read from SKILL.md and the folder at commit 28bf209. It shows what the files ask for, not the result of running them.

Tool permissions
Pre-approves these tools, so the agent can use them without asking each time:
- Bash(*)
- Read
- Write
From allowed-tools in the SKILL.md frontmatter.
Runs code
Shell commands in SKILL.md call:
- python
- pip
From the folder's file list and the shell code blocks in SKILL.md.
Network
No URLs in SKILL.md. Its commands use pip, which can reach the network depending on how they are called.
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Unsplash Image loads about 774 tokens when it runs. Until then it costs about 61 tokens; SKILL.md has 261 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it: ~61
When it runs · the whole SKILL.md, loaded when a task matches: ~774

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check: notes

The automated check noted patterns worth knowing about, such as sudo or a known installer.

NoteMentions a .env fileSKILL.md:15

- Env file: `~/.agents/tools/.env` (contains `UNSPLASH_CLIENT_ID`)

NotePre-approves every shell command (allowed-tools: Bash)SKILL.md
```
allowed-tools: Bash(*), Read, Write
```

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from OpenClaudia/openclaudia-skills at commit 28bf209, republished under its MIT licence (© OpenClaudia). 261 words, ~774 tokens.

Download SKILL.mdSave it as .claude/skills/unsplash-image/SKILL.md (or your agent's skills folder).

name: unsplash-image
description: 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.
allowed-tools: Bash(*), Read, Write
argument-hint: search query

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 UNSPLASH_CLIENT_ID)

Quick Usage

Search and download a random matching image

bash

python ~/.agents/tools/unsplash-search.py \
  --query "nature landscape" \
  --output ./image.jpg

With orientation filter

bash

python ~/.agents/tools/unsplash-search.py \
  --query "coffee shop" \
  --orientation landscape \
  --output ./coffee.jpg

With text overlay (title and subtitle)

bash

python ~/.agents/tools/unsplash-search.py \
  --query "technology abstract" \
  --output ./cover.png \
  --title "My Blog Post Title" \
  --subtitle "A short description"

List results without downloading

bash

python ~/.agents/tools/unsplash-search.py \
  --query "sunset" \
  --list

Pick the first result instead of random

bash

python ~/.agents/tools/unsplash-search.py \
  --query "mountains" \
  --pick first \
  --output ./mountains.jpg

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`, `black_and_white`)
`--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:

bash

pip install requests Pillow

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.

Files

Just SKILL.md in skills/stock-images of OpenClaudia/openclaudia-skills.

Open the folder on GitHubat commit 28bf209

Compare with similar skills

Unsplash Image next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Unsplash Image compared with similar skills
Skill	Stars	Used in	Tokens	Auto-check	Licence	Repo updated
Unsplash Image this skillOpenClaudia/openclaudia-skills	713	—	~774	Automated safety check: Notes	MIT	21 days ago
HyperFrames Media Useheygen-com/hyperframes	59k	—	~2.4k	Automated safety check: Pass	Apache-2.0	today
Native Subtitle Quote Imagechengyi-ai/native-subtitle-quote-image	2.4k	—	~1.8k	Automated safety check: Pass	MIT	today
Edu Math Videowy51ai/edulab	1.4k	—	~2.5k	Automated safety check: Notes	Apache-2.0	11 days ago
Transcription Memory ReconstructionNxcoreAI/EverRoom	3k	—	~714	Automated safety check: Pass	Custom licence	today
TranscribeJetBrains/skills	366	4 repos	~776	Automated safety check: Pass	Apache-2.0	3 mo ago

Similar skills

HyperFrames Media Use
heygen-com/hyperframes
Finds, generates and edits media for HyperFrames video projects: music, sound effects, images, icons, logos, voiceovers, captions and color grades.
59k GitHub stars~2.4k tokensUpdated today
Media & CreativeAuto-check passed
Native Subtitle Quote Image
chengyi-ai/native-subtitle-quote-image
将本地视频或用户有权处理的在线视频，经过来源获取、文字稿定位、选题选句、精确取帧、紧凑裁切、拼图和逐张质检，制作成 3:4 或保留画面原比例的视频字幕长图。支持两种明确分开的输出：保留画面内已烧录字幕的原生字幕模式，以及把已审核的时间点与台词绘制到真实视频帧上的脚本字幕模式。用户要求原生字幕截图、字幕帧拼图、YouTube…
2.4k GitHub stars~1.8k tokensUpdated today
Media & CreativeAuto-check passed
Edu Math Video
wy51ai/edulab
A skill your agent uses when asked to make an explainer / walkthrough video (讲解视频、解题视频、例题精讲、微课) for a math problem (数学题, geometry, algebra, functions, motion/行程 problems), from a problem screenshot…
1.4k GitHub stars~2.5k tokensUpdated 11 days ago
Media & CreativeAuto-check: notes
Transcription Memory Reconstruction
NxcoreAI/EverRoom
Reconstruct a complete, searchable memory from an untrusted meeting or conversation transcript.
3k GitHub stars~714 tokensUpdated today
Media & CreativeAuto-check passed
Transcribe
JetBrains/skills
Official
Transcribe audio files to text with optional diarization and known-speaker hints.
366 GitHub starsUsed in 4 repos~776 tokens
Media & CreativeAuto-check passed
Bilibili Transcribe
chubbyguan/chubbyskills
哔哩哔哩视频 → 下载 → 转录 → 存为 Markdown 的完整工作流. An agent skill from chubbyguan/chubbyskills.
1.2k GitHub stars~578 tokensUpdated yesterday
Media & CreativeAuto-check: notes

More from OpenClaudia/openclaudia-skills

All 74 skills in this repo

Competitor Traffic Report
OpenClaudia/openclaudia-skills
Build an interactive competitive-traffic report for any company and its rivals — monthly visits (SimilarWeb), organic search traffic and Domain Rating (Ahrefs) — as one self-contained HTML page with…
713 GitHub stars~1.2k tokensUpdated 21 days ago
Auto-check passed
Geo Difficulty
OpenClaudia/openclaudia-skills
Score how hard a keyword is to rank for in the AI-search era — page-level URL Rating of real competitors (not just domain DR), Ahrefs keyword difficulty, and whether a given site already ranks or is…
713 GitHub stars~694 tokensUpdated 21 days ago
Auto-check passed
Gsc Portfolio Audit
OpenClaudia/openclaudia-skills
Audit EVERY Google Search Console property at once — rank all sites by clicks and impressions with period-over-period deltas, then diff keywords per site to surface what is newly ranking, rising…
713 GitHub stars~1k tokensUpdated 21 days ago
Auto-check passed
Similarweb Traffic
OpenClaudia/openclaudia-skills
Fetch website traffic estimates (monthly visits, traffic sources, top countries, keywords, engagement, ranks) for any domain from SimilarWeb.
713 GitHub stars~882 tokensUpdated 21 days ago
Auto-check passed
Ahrefs Python
OpenClaudia/openclaudia-skills
Manages Ahrefs API usage in Python using ahrefs-python library.
713 GitHub stars~1.9k tokensUpdated 21 days ago
Auto-check passed
Ab Test Setup
OpenClaudia/openclaudia-skills
Design, plan, and analyze A/B tests with statistical rigor. An agent skill from OpenClaudia/openclaudia-skills.
713 GitHub stars~1.7k tokensUpdated 21 days ago
Auto-check passed

Questions about Unsplash Image

What does Unsplash Image do?

Search for images on Unsplash and download them. An agent skill from OpenClaudia/openclaudia-skills. Unsplash Image is an agent skill from OpenClaudia/openclaudia-skills. Search for images on Unsplash and download them.

When should I use Unsplash Image?

Unsplash Image fits situations like: the user asks to find a stock photo; search for an image; get an Unsplash image; download a photo with text.

How do I install Unsplash Image in Claude Code?

Run `npx skills add OpenClaudia/openclaudia-skills --skill unsplash-image -a claude-code`. Or copy the skill folder (skills/stock-images in OpenClaudia/openclaudia-skills) into .claude/skills/unsplash-image in your project. Claude Code loads it when a task matches its description.

How do I install Unsplash Image in Codex?

Run `npx skills add OpenClaudia/openclaudia-skills --skill unsplash-image -a codex`. Or copy the skill folder (skills/stock-images in OpenClaudia/openclaudia-skills) into .agents/skills/unsplash-image in your project. Codex loads it when a task matches its description.

Can I use Unsplash Image in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add OpenClaudia/openclaudia-skills --skill unsplash-image -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/unsplash-image, .gemini/skills/unsplash-image, .github/skills/unsplash-image and .opencode/skills/unsplash-image in your project.

What does Unsplash Image need to run?

Going by SKILL.md and its folder, Unsplash Image needs the command-line tools its instructions call (python and pip). Our summary lists: Python 3. Its frontmatter pre-approves these tools: Bash(*), Read, Write.

Does Unsplash Image access the network?

SKILL.md contains no URLs. Its commands use pip, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Unsplash Image safe to install?

Our automated static check of SKILL.md found notes only (mentions a .env file; pre-approves every shell command (allowed-tools: bash)), nothing it rates as a warning. It is not a guarantee. Review the folder before installing.

What licence does Unsplash Image use?

Unsplash Image is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Unsplash Image use?

About 774 tokens (SKILL.md is roughly 3.1k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Unsplash Image?

Skills that share tags, products or a category with Unsplash Image: HyperFrames Media Use (heygen-com/hyperframes, 59k stars), Native Subtitle Quote Image (chengyi-ai/native-subtitle-quote-image, 2.4k stars), Edu Math Video (wy51ai/edulab, 1.4k stars) and Transcription Memory Reconstruction (NxcoreAI/EverRoom, 3k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Unsplash Image?

OpenClaudia (a GitHub organization) maintains it in OpenClaudia/openclaudia-skills, which has 713 GitHub stars. The repository holds 74 skills in this directory. The repository was last updated on September 18, 2026.

Source: OpenClaudia/openclaudia-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.

Install Unsplash Image

Facts

At a glance

What it does

When your agent uses it

Example prompts

Requirements

What it can do on your machine

Tool permissions

Runs code

Network

Credentials

Context cost

Safety

SKILL.md

Unsplash Image Search & Download

Tool Location

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

Text Overlay

Dependencies

Output

Notes

Files

Compare with similar skills

Similar skills

More from OpenClaudia/openclaudia-skills

Related

Questions about Unsplash Image