Agent skill

Unsplash CLI

by ItamarZand88 in ItamarZand88/CLI-Anything-WEB

Use cli-web-unsplash to answer questions about Unsplash photos, search for free images by keyword, download photos, browse photo topics and collections, view photographer profiles, get photo details…

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/unsplash/agent-harness/cli_web/unsplash/skills .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/

Facts

Skill name
unsplash-cli
GitHub stars
231
Token cost
~1.2k tokens
SKILL.md length
246 words
Files
1
Skills in repo
42
Repo updated
First seen
Licence
MIT

At a glance

Use cli-web-unsplash to answer questions about Unsplash photos, search for free images by keyword, download photos, browse photo topics and collections, view photographer profiles, get photo details…

  • Asks about Unsplash
  • SKILL.md covers Quick Start, Commands, Agent Patterns and Notes
  • Calls python
  • Free stock photos

What it does

Unsplash CLI is an agent skill from ItamarZand88/CLI-Anything-WEB. Use cli-web-unsplash to answer questions about Unsplash photos, search for free images by keyword, download photos, browse photo topics and collections, view photographer profiles, get photo details (EXIF, location, tags), and discover random photos. Invoke this skill whenever the user asks about Unsplash, free stock photos, searching for images, downloading images, photo topics, photographer profiles, photo collections, or wants to find or download images by keyword, orientation, or color. Always prefer…

Its SKILL.md is about 1.2k 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

  • Asks about Unsplash
  • Free stock photos
  • Searching for images
  • Downloading images

Example prompts

  • “/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:

    • python

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    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 1.2k tokens when it runs. Until then it costs about 146 tokens; SKILL.md has 246 words of instructions outside code blocks.

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

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). 246 words, ~1,214 tokens.

Download SKILL.mdSave it as .claude/skills/unsplash-cli/SKILL.md (or your agent's skills folder).
name
unsplash-cli
description
Use cli-web-unsplash to answer questions about Unsplash photos, search for free images by keyword, download photos, browse photo topics and collections, view photographer profiles, get photo details (EXIF, location, tags), and discover random photos. Invoke this skill whenever the user asks about Unsplash, free stock photos, searching for images, downloading images, photo topics, photographer profiles, photo collections, or wants to find or download images by keyword, orientation, or color. Always prefer cli-web-unsplash over manually fetching the Unsplash website.

cli-web-unsplash

CLI for searching and discovering photos on Unsplash. Installed at: cli-web-unsplash.

Quick Start

bash
# Search for photos
cli-web-unsplash photos search "mountains" --json

# Get photo details
cli-web-unsplash photos get SyfvrXRy28Y --json

# Browse topics
cli-web-unsplash topics list --json

Always use --json when parsing output programmatically.


Commands

photos search <query>

Search photos by keyword with optional filters.

bash
cli-web-unsplash photos search "sunset" --orientation landscape --color orange --per-page 10 --json

Key options: --orientation (landscape/portrait/squarish), --color, --order-by (relevant/latest), --page, --per-page Output fields: total, total_pages, results[] with id, description, width, height, likes, color, author, url, link, premium

photos get <photo_id>

Get full photo details including EXIF, location, and tags.

bash
cli-web-unsplash photos get SyfvrXRy28Y --json

Output fields: id, slug, description, width, height, color, likes, views, downloads, created_at, author ({username, name}), urls, exif (camera, aperture, exposure, focal_length, iso), location (name, city, country, latitude, longitude), tags[], premium, link

photos random

Get random photo(s), optionally filtered.

bash
cli-web-unsplash photos random --query "nature" --count 3 --orientation landscape --json
photos download <photo_id>

Download a photo to disk.

bash
cli-web-unsplash photos download Bkci_8qcdvQ --size full -o mountain.jpg --json

Key options: --size (raw/full/regular/small/thumb, default: full), --output / -o (file path) Output fields (JSON): photo_id, size, file, bytes, description

photos stats <photo_id>

Get photo view and download statistics.

bash
cli-web-unsplash photos stats SyfvrXRy28Y --json
topics list

List available photo topics.

bash
cli-web-unsplash topics list --json
topics get <slug>

Get topic details.

bash
cli-web-unsplash topics get nature --json
topics photos <slug>

List photos in a topic.

bash
cli-web-unsplash topics photos nature --per-page 10 --order-by popular --json
collections search <query>

Search photo collections.

bash
cli-web-unsplash collections search "wallpapers" --json
collections get <id>

Get collection details.

bash
cli-web-unsplash collections get 1065976 --json
collections photos <id>

List photos in a collection.

bash
cli-web-unsplash collections photos 1065976 --per-page 10 --json
users search <query>

Search users by name.

bash
cli-web-unsplash users search "landscape" --json
users get <username>

Get user profile.

bash
cli-web-unsplash users get unsplash --json
users photos <username>

List photos by a user.

bash
cli-web-unsplash users photos unsplash --order-by popular --json
users collections <username>

List collections by a user.

bash
cli-web-unsplash users collections unsplash --json

Agent Patterns

bash
# Find landscape photos of mountains and get the first result's details
cli-web-unsplash photos search "mountains" --orientation landscape --per-page 1 --json | python -c "import json,sys; d=json.load(sys.stdin); print(d['results'][0]['url'])"

# Get a random nature photo URL
cli-web-unsplash photos random --query "nature" --json | python -c "import json,sys; d=json.load(sys.stdin); print(d[0]['url'])"

# Find a photographer's top photos
cli-web-unsplash users photos unsplash --order-by popular --per-page 5 --json

# Search and download the first result
ID=$(cli-web-unsplash photos search "sunset beach" --per-page 1 --json | python -c "import json,sys; print(json.load(sys.stdin)['results'][0]['id'])")
cli-web-unsplash photos download "$ID" --size regular -o sunset.jpg

Notes

  • Auth: Not required — all endpoints are public
  • Rate limiting: Generous limits (x-ratelimit-limit: 99999999)
  • Premium photos: Some results have premium: true (Unsplash+ only)
  • Image URLs: Use urls.regular for web-quality, urls.raw for full resolution

© ItamarZand88, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in unsplash/agent-harness/cli_web/unsplash/skills 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
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Unsplash CLI this skillItamarZand88/CLI-Anything-WEB231—~1.2kAutomated safety check: PassMIT
Photoscodewhale-hq/Codewhale41k—~386Automated safety check: PassMIT
UnsplashAnil-matcha/awesome-muse-connectors1.3k—~759Automated safety check: PassMIT
Unsplash Integrationsickn33/agentic-awesome-skills47k2 repos~628Automated safety check: PassMIT
AI Photo Restylersickn33/agentic-awesome-skills47k1 repos~3.1kAutomated safety check: PassMIT-0
Logseq Answer Machinelogseq/logseq45k—~1.2kAutomated safety check: WarnAGPL-3.0

Similar skills

  • 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
  • Unsplash

    Anil-matcha/awesome-muse-connectors

    Search Unsplash for free stock photos, browse by photographer or topic, and download images with proper attribution credit.

    1.3k GitHub stars~759 tokensUpdated 3 days ago
    Auto-check passed
  • Unsplash Integration

    sickn33/agentic-awesome-skills

    Integration skill for searching and fetching high-quality, free-to-use professional photography from Unsplash.

    47k GitHub starsUsed in 2 repos~628 tokens
    Media & CreativeAuto-check passed
  • AI Photo Restyler

    sickn33/agentic-awesome-skills

    Install and use the official Photo to Anime package, pinned by digest, for paid hosted work on the Beatra service.

    47k GitHub starsUsed in 1 repo~3.1k tokens
    Auto-check passed
  • Answer user questions about the Logseq repository by researching source code, docs, tests, runtime behavior, and local tools.

    45k GitHub stars~1.2k tokensUpdated today
    Knowledge ManagementAuto-check: warnings
  • Photo Abstract Editorial

    ZzzLc0405/photo-abstract-editorial

    Creates one vertical editorial image from an uploaded photo, keeping the photo untouched and adding an abstract panel and short English title derived from it.

    5.9k GitHub stars~815 tokensUpdated 1 mo ago
    Media & CreativeAuto-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 8 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 8 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 8 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 8 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 8 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 8 days ago
    Auto-check passed

Questions about Unsplash CLI

What does Unsplash CLI do?

Use cli-web-unsplash to answer questions about Unsplash photos, search for free images by keyword, download photos, browse photo topics and collections, view photographer profiles, get photo details…. Unsplash CLI is an agent skill from ItamarZand88/CLI-Anything-WEB. Use cli-web-unsplash to answer questions about Unsplash photos, search for free images by keyword, download photos, browse photo topics and collections, view photographer profiles, get photo details (EXIF, location, tags), and discover random photos.

When should I use Unsplash CLI?

Unsplash CLI fits situations like: asks about Unsplash; free stock photos; searching for images; downloading images.

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 (unsplash/agent-harness/cli_web/unsplash/skills 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 (unsplash/agent-harness/cli_web/unsplash/skills 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 (python). Our summary lists: Python 3.

Does Unsplash CLI access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. 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 1.2k tokens (SKILL.md is roughly 4.9k 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: Photos (codewhale-hq/Codewhale, 41k stars), Unsplash (Anil-matcha/awesome-muse-connectors, 1.3k stars), Unsplash Integration (sickn33/agentic-awesome-skills, 47k stars) and AI Photo Restyler (sickn33/agentic-awesome-skills, 47k 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.