← Back to Skills Marketplace
Unsplash
by
BrokenWatchCEO
· GitHub ↗
· v1.0.0
1412
Downloads
3
Stars
6
Active Installs
1
Versions
Install in OpenClaw
/install unsplash
Description
Search, browse, and download high-quality free photos from Unsplash with filtering, random selection, and detailed photo metadata access.
Usage Guidance
This skill appears to be what it says — an Unsplash API helper — but the registry metadata omits that it expects an Unsplash access key and a local config file. Before installing: (1) be prepared to create an Unsplash developer app and obtain an Access Key; (2) prefer exporting UNSPLASH_ACCESS_KEY as an environment variable instead of storing secrets in files unless you trust the machine; (3) verify you are comfortable the skill will read that key (metadata should declare it — ask the publisher to update the registry entry); and (4) because this is instruction-only, inspect the SKILL.md yourself and confirm the endpoints shown are correct (api.unsplash.com / images.unsplash.com) and no unexpected external endpoints are introduced. If you need higher assurance, ask the publisher to add the required env/config declarations to the skill metadata before using it.
Capability Analysis
Type: OpenClaw Skill
Name: unsplash
Version: 1.0.0
The skill bundle provides instructions and examples for interacting with the Unsplash API. It guides the user on how to obtain and store an API key (either in `~/.config/unsplash/access_key` or as an environment variable) and demonstrates various API calls using `curl` to `api.unsplash.com`. All operations are standard for an API client, and there is no evidence of data exfiltration, malicious execution, persistence mechanisms, or prompt injection attempts designed to harm the agent or user. The instructions are clear, and all network calls target legitimate Unsplash domains.
Capability Assessment
Purpose & Capability
The skill's name/description (Unsplash photo search/download) matches the runtime instructions: all cURL examples call api.unsplash.com and image URLs reference images.unsplash.com. However, the SKILL.md expects an Unsplash access key (UNSPLASH_ACCESS_KEY) and suggests creating ~/.config/unsplash/access_key, but the registry metadata lists no required env vars or config paths. That metadata omission is inconsistent (but not necessarily malicious).
Instruction Scope
Instructions stay on-task: they direct the agent to register an Unsplash app, store an Access Key (file or env var), and call only Unsplash endpoints (api.unsplash.com and images.unsplash.com). There are explicit download-tracking calls (/photos/:id/download) required by Unsplash's API guidelines. The instructions do ask the user to create a file under ~/.config/unsplash, which is a local write operation but limited in scope.
Install Mechanism
No install spec and no code files (instruction-only). This is the lowest-risk class: nothing is downloaded or installed by the skill itself.
Credentials
The only sensitive credential the SKILL.md requires is an Unsplash Access Key, which is proportionate to the stated purpose. The concern is that the skill metadata does not declare this required env var or the config path (~/.config/unsplash/access_key). That mismatch means the registry entry understates the secrets/config the skill will ask you to create or use, which reduces transparency.
Persistence & Privilege
The skill is not always-enabled and does not request elevated platform privileges. It instructs creating a per-user config file (~/.config/unsplash/access_key), which is normal for storing an API key but is not declared in metadata. The skill does not try to modify other skills or system-wide settings.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install unsplash - After installation, invoke the skill by name or use
/unsplash - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Unsplash Skill 1.0.0 initial release
- Provides comprehensive documentation for using the Unsplash API, including setup, authentication, and rate limits.
- Covers searching, browsing, and downloading high-quality free photos.
- Includes usage examples for common API endpoints and parameters.
- Explains required download tracking and best practices for attribution and hotlinking.
- Details image manipulation options and response structures.
- Lists common filters, pagination, error handling, and guidance for production use.
Metadata
Frequently Asked Questions
What is Unsplash?
Search, browse, and download high-quality free photos from Unsplash with filtering, random selection, and detailed photo metadata access. It is an AI Agent Skill for Claude Code / OpenClaw, with 1412 downloads so far.
How do I install Unsplash?
Run "/install unsplash" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Unsplash free?
Yes, Unsplash is completely free (open-source). You can download, install and use it at no cost.
Which platforms does Unsplash support?
Unsplash is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Unsplash?
It is built and maintained by BrokenWatchCEO (@brokenwatch24); the current version is v1.0.0.
More Skills