Agent skill

Unsplash CLI

by ItamarZand88 in ItamarZand88/CLI-Anything-WEB

Searches and downloads free Unsplash photos via the cli-web-unsplash command-line tool — keyword search with orientation/color filters, photo details (EXIF, location, tags), downloads, random…

MITAuto-check passed

Install Unsplash CLI

skills CLI

$ npx skills add ItamarZand88/CLI-Anything-WEB --skill unsplash-cli -a claude-code

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

GitHub CLI

$ gh skill install ItamarZand88/CLI-Anything-WEB unsplash-cli --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/ItamarZand88/CLI-Anything-WEB.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.claude/skills/unsplash-cli .claude/skills/unsplash-cli && 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-cli" agent skill from https://github.com/ItamarZand88/CLI-Anything-WEB/tree/main/.claude/skills/unsplash-cli into .claude/skills/unsplash-cli/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "unsplash-cli", 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/ItamarZand88/CLI-Anything-WEB/tree/main/.claude/skills/unsplash-cli

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 ItamarZand88/CLI-Anything-WEB --skill unsplash-cli -a codex

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

GitHub CLI

$ gh skill install ItamarZand88/CLI-Anything-WEB unsplash-cli --agent codex

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

Manual copy

$ git clone --depth 1 https://github.com/ItamarZand88/CLI-Anything-WEB.git skills-src && mkdir -p .agents/skills && cp -r skills-src/.claude/skills/unsplash-cli .agents/skills/unsplash-cli && 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-cli" agent skill from https://github.com/ItamarZand88/CLI-Anything-WEB/tree/main/.claude/skills/unsplash-cli into .agents/skills/unsplash-cli/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "unsplash-cli", 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 ItamarZand88/CLI-Anything-WEB --skill unsplash-cli -a cursor

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

GitHub CLI

$ gh skill install ItamarZand88/CLI-Anything-WEB unsplash-cli --agent cursor

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

Manual copy

$ git clone --depth 1 https://github.com/ItamarZand88/CLI-Anything-WEB.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/.claude/skills/unsplash-cli .cursor/skills/unsplash-cli && 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-cli" agent skill from https://github.com/ItamarZand88/CLI-Anything-WEB/tree/main/.claude/skills/unsplash-cli into .cursor/skills/unsplash-cli/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "unsplash-cli", 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/ItamarZand88/CLI-Anything-WEB.git --path .claude/skills/unsplash-cli

--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 ItamarZand88/CLI-Anything-WEB --skill unsplash-cli -a gemini-cli

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

GitHub CLI

$ gh skill install ItamarZand88/CLI-Anything-WEB unsplash-cli --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/ItamarZand88/CLI-Anything-WEB.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/.claude/skills/unsplash-cli .gemini/skills/unsplash-cli && 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-cli" agent skill from https://github.com/ItamarZand88/CLI-Anything-WEB/tree/main/.claude/skills/unsplash-cli into .gemini/skills/unsplash-cli/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "unsplash-cli", 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 ItamarZand88/CLI-Anything-WEB unsplash-cli

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 ItamarZand88/CLI-Anything-WEB --skill unsplash-cli -a github-copilot

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

Manual copy

$ git clone --depth 1 https://github.com/ItamarZand88/CLI-Anything-WEB.git skills-src && mkdir -p .github/skills && cp -r skills-src/.claude/skills/unsplash-cli .github/skills/unsplash-cli && 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-cli" agent skill from https://github.com/ItamarZand88/CLI-Anything-WEB/tree/main/.claude/skills/unsplash-cli into .github/skills/unsplash-cli/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "unsplash-cli", 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 ItamarZand88/CLI-Anything-WEB --skill unsplash-cli -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 ItamarZand88/CLI-Anything-WEB unsplash-cli --agent opencode

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

Manual copy

$ git clone --depth 1 https://github.com/ItamarZand88/CLI-Anything-WEB.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/.claude/skills/unsplash-cli .opencode/skills/unsplash-cli && 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-cli" agent skill from https://github.com/ItamarZand88/CLI-Anything-WEB/tree/main/.claude/skills/unsplash-cli into .opencode/skills/unsplash-cli/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "unsplash-cli", 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-cli
GitHub stars: 231
Token cost: ~774 tokens
SKILL.md length: 202 words
Files: 1
Skills in repo: 42
Repo updated: Oct 1, 2026
First seen: Oct 7, 2026
Licence: MIT

At a glance

Searches and downloads free Unsplash photos via the cli-web-unsplash command-line tool — keyword search with orientation/color filters, photo details (EXIF, location, tags), downloads, random…

The user asks about Unsplash
SKILL.md covers Commands, Examples, JSON output and Utilities, plus 1 more section
Calls jq, pip and python
Free stock photos

What it does

Unsplash CLI is an agent skill from ItamarZand88/CLI-Anything-WEB. Searches and downloads free Unsplash photos via the cli-web-unsplash command-line tool — keyword search with orientation/color filters, photo details (EXIF, location, tags), downloads, random photos, topics, collections, and photographer profiles. Use when the user asks about Unsplash, free stock photos, or wants to find or download images by keyword, orientation, or color. Prefer this CLI over fetching the Unsplash website. No authentication required.

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.

The repository describes itself as: Claude Code plugin that generates production-grade Python CLIs for any web app. 20 CLIs and counting. The licence is MIT.

When your agent uses it

The user asks about Unsplash
Free stock photos
Download images by keyword

Example prompts

“Use the unsplash-cli skill to search and downloads free Unsplash photos via the cli-web-unsplash command-line tool — keyword search with…”
“/unsplash-cli”

Requirements

Python 3

What it can do on your machine

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

Tool permissions
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Runs code
Shell commands in SKILL.md call:
- jq
- pip
- python
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 CLI loads about 774 tokens when it runs. Until then it costs about 117 tokens; SKILL.md has 202 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it: ~117
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 passed

The automated check found no risky patterns in SKILL.md.

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 ItamarZand88/CLI-Anything-WEB at commit 931e201, republished under its MIT licence (© ItamarZand88). 202 words, ~774 tokens.

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

name: unsplash-cli
description: Searches and downloads free Unsplash photos via the cli-web-unsplash command-line tool — keyword search with orientation/color filters, photo details (EXIF, location, tags), downloads, random photos, topics, collections, and photographer profiles. Use when the user asks about Unsplash, free stock photos, or wants to find or download images by keyword, orientation, or color. Prefer this CLI over fetching the Unsplash website. No authentication required.

cli-web-unsplash

Search, explore, and download Unsplash photos (read-only, no auth). Install: pip install cli-web-unsplash, then run python -m camoufox fetch once.

Commands

Command	Purpose	Key options
`photos search QUERY`	Search photos	`--orientation landscape\|portrait\|squarish`, `--color`, `--order-by relevant\|latest`, `--page`, `--per-page` (max 30)
`photos get PHOTO_ID`	Full details: EXIF, location, tags, URLs	ID or slug
`photos random`	Random photo(s)	`--query`, `--orientation`, `--count N` (max 30)
`photos download PHOTO_ID`	Download to disk	`--size raw\|full\|regular\|small\|thumb`, `-o/--output PATH`
`photos stats PHOTO_ID`	Views and downloads
`topics list` / `topics get SLUG` / `topics photos SLUG`	Browse curated topics	`--page`, `--per-page`, `--order-by`
`collections search QUERY` / `collections get ID` / `collections photos ID`	Browse collections	`--page`, `--per-page`
`users search QUERY` / `users get USERNAME` / `users photos USERNAME` / `users collections USERNAME`	Photographer profiles and portfolios	`--page`, `--per-page`, `--order-by` (photos: `latest\|oldest\|popular\|views\|downloads`)

Examples

bash

# Search with filters (returns total, total_pages, results[] with id, likes, author, url)
cli-web-unsplash photos search "sunset" --orientation landscape --color orange --per-page 10 --json

# Photo details (EXIF, location, tags)
cli-web-unsplash photos get SyfvrXRy28Y --json

# Random nature photos
cli-web-unsplash photos random --query "nature" --count 3 --json

# Search then download the top hit
ID=$(cli-web-unsplash photos search "sunset beach" --per-page 1 --json | jq -r '.results[0].id')
cli-web-unsplash photos download "$ID" --size regular -o sunset.jpg

# A photographer's most popular photos
cli-web-unsplash users photos unsplash --order-by popular --per-page 5 --json

JSON output

Every command accepts --json and returns the data directly (search: {"total", "total_pages", "results": [...]}; download: {"photo_id", "size", "file", "bytes"}). Errors return {"error": true, "code": "...", "message": "..."}.

Utilities

cli-web-unsplash doctor [--json] self-diagnoses the local setup (install, auth, dependencies). cli-web-unsplash mcp-serve serves the commands as MCP tools over stdio.

Agent tips

Some results have premium: true (Unsplash+ only) — skip those when the user wants freely usable images.
Use urls.regular for web-quality embeds and urls.raw for full resolution.

Files

Just SKILL.md in .claude/skills/unsplash-cli of ItamarZand88/CLI-Anything-WEB.

Open the folder on GitHubat commit 931e201

Compare with similar skills

Unsplash CLI 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 CLI compared with similar skills
Skill	Stars	Used in	Tokens	Auto-check	Licence	Repo updated
Unsplash CLI this skillItamarZand88/CLI-Anything-WEB	231	—	~774	Automated safety check: Pass	MIT	7 days ago
Searchdavila7/claude-code-templates	32k	1 repos	~339	Automated safety check: Pass	MIT	today
Photoscodewhale-hq/Codewhale	41k	—	~386	Automated safety check: Pass	MIT	today
Gif SearchNousResearch/hermes-agent	252k	1 repos	~680	Automated safety check: Notes	MIT	today
Algolia Searchdavila7/claude-code-templates	32k	4 repos	~492	Automated safety check: Pass	MIT	today
Perplexity Web Searchdavila7/claude-code-templates	32k	12 repos	~3.5k	Automated safety check: Notes	MIT	today

Similar skills

Search
davila7/claude-code-templates
Search Google via Bright Data SERP API. An agent skill from davila7/claude-code-templates.
32k GitHub starsUsed in 1 repo~339 tokens
Productivity & AutomationAuto-check passed
Photos
codewhale-hq/Codewhale
Search a local macOS Photos library and export selected copies when the user asks to find or use their own photos.
41k GitHub stars~386 tokensUpdated today
Auto-check passed
Gif Search
NousResearch/hermes-agent
Search/download GIFs from Tenor via curl + jq. An agent skill from NousResearch/hermes-agent.
252k GitHub starsUsed in 1 repo~680 tokens
Auto-check: notes
Algolia Search
davila7/claude-code-templates
Expert patterns for Algolia search implementation, indexing strategies, React InstantSearch, and relevance tuning Use when: adding search to, algolia, instantsearch, search api, search functionality.
32k GitHub starsUsed in 4 repos~492 tokens
Backend & APIsAuto-check passed
Perplexity Web Search
davila7/claude-code-templates
Runs web-grounded searches through Perplexity's Sonar models over OpenRouter for current events, recent literature and cited facts beyond the model's training cutoff.
32k GitHub starsUsed in 12 repos~3.5k tokens
Research & ScienceAuto-check: notes
X Search via xAI
code-yeongyu/oh-my-openagent
Rules for using the x_search tool to search X (Twitter) through a connected xAI account: date-bound queries, trusted handles, search operators and split searches.
70k GitHub stars~1.4k tokensUpdated today
Productivity & AutomationAuto-check passed

More from ItamarZand88/CLI-Anything-WEB

All 42 skills in this repo

Standards
ItamarZand88/CLI-Anything-WEB
Runs Phase 4 review/publish/verify for a cli-web- CLI: implementation review by 3 parallel agents, the tiered quality checklist (Tier 1 critical fail-fast, then comprehensive), pip install + smoke…
231 GitHub stars~4.2k tokensUpdated 7 days ago
Auto-check passed
Airbnb CLI
ItamarZand88/CLI-Anything-WEB
Searches Airbnb from the terminal via cli-web-airbnb — find stays by location, dates, and filters; get listing details, guest reviews, and availability calendars; autocomplete location names.
231 GitHub stars~801 tokensUpdated 7 days ago
Auto-check passed
Amazon CLI
ItamarZand88/CLI-Anything-WEB
Searches Amazon from the terminal via cli-web-amazon — product search, product details by ASIN, Best Sellers by category, and autocomplete suggestions.
231 GitHub stars~570 tokensUpdated 7 days ago
Auto-check passed
Booking CLI
ItamarZand88/CLI-Anything-WEB
Searches Booking.com from the terminal via cli-web-booking — find hotels, apartments, and hostels by destination, dates, and guests; get property details by slug; resolve destination names to IDs.
231 GitHub stars~776 tokensUpdated 7 days ago
Auto-check passed
Booking CLI
ItamarZand88/CLI-Anything-WEB
Use cli-web-booking to search Booking.com for hotels, apartments, hostels, and accommodations by destination, dates, and filters.
231 GitHub stars~970 tokensUpdated 7 days ago
Auto-check passed
Capitoltrades CLI
ItamarZand88/CLI-Anything-WEB
Queries US congressional stock trades (STOCK Act disclosures) on capitoltrades.com via the cli-web-capitoltrades command-line tool — trades with rich filters, politician profiles and leaderboards…
231 GitHub stars~971 tokensUpdated 7 days ago
Auto-check passed

Questions about Unsplash CLI

What does Unsplash CLI do?

Searches and downloads free Unsplash photos via the cli-web-unsplash command-line tool — keyword search with orientation/color filters, photo details (EXIF, location, tags), downloads, random…. Unsplash CLI is an agent skill from ItamarZand88/CLI-Anything-WEB. Searches and downloads free Unsplash photos via the cli-web-unsplash command-line tool — keyword search with orientation/color filters, photo details (EXIF, location, tags), downloads, random photos, topics, collections, and photographer profiles.

When should I use Unsplash CLI?

Unsplash CLI fits situations like: the user asks about Unsplash; free stock photos; download images by keyword.

How do I install Unsplash CLI in Claude Code?

Run `npx skills add ItamarZand88/CLI-Anything-WEB --skill unsplash-cli -a claude-code`. Or copy the skill folder (.claude/skills/unsplash-cli in ItamarZand88/CLI-Anything-WEB) into .claude/skills/unsplash-cli in your project. Claude Code loads it when a task matches its description.

How do I install Unsplash CLI in Codex?

Run `npx skills add ItamarZand88/CLI-Anything-WEB --skill unsplash-cli -a codex`. Or copy the skill folder (.claude/skills/unsplash-cli in ItamarZand88/CLI-Anything-WEB) into .agents/skills/unsplash-cli in your project. Codex loads it when a task matches its description.

Can I use Unsplash CLI 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 ItamarZand88/CLI-Anything-WEB --skill unsplash-cli -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-cli, .gemini/skills/unsplash-cli, .github/skills/unsplash-cli and .opencode/skills/unsplash-cli in your project.

What does Unsplash CLI need to run?

Going by SKILL.md and its folder, Unsplash CLI needs the command-line tools its instructions call (jq, pip and python). Our summary lists: Python 3.

Does Unsplash CLI 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 CLI safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Unsplash CLI use?

Unsplash CLI 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 CLI 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 CLI?

Skills that share tags, products or a category with Unsplash CLI: Search (davila7/claude-code-templates, 32k stars), Photos (codewhale-hq/Codewhale, 41k stars), Gif Search (NousResearch/hermes-agent, 252k stars) and Algolia Search (davila7/claude-code-templates, 32k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Unsplash CLI?

ItamarZand88 (a GitHub user) maintains it in ItamarZand88/CLI-Anything-WEB, which has 231 GitHub stars. The repository holds 42 skills in this directory. The repository was last updated on October 1, 2026.

Source: ItamarZand88/CLI-Anything-WEB 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 CLI

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

cli-web-unsplash

Commands

Examples

JSON output

Utilities

Agent tips

Files

Compare with similar skills

Similar skills

More from ItamarZand88/CLI-Anything-WEB

Questions about Unsplash CLI