# Unsplash agent skills for Claude Code, Cursor and RevampKey

> Ready-made Unsplash playbooks for AI agents: audit your Unsplash collections and bookmarks, build a collection from search results, find photographers and series that match your style. Free SKILL.md files for Claude Code, Cursor and Codex, or one click in RevampKey.

## Skills

- [Use Unsplash safely with AI](https://revampkey.com/marketplace/unsplash/skills/essentials.md): Sets the ground rules for working with your Unsplash account: confirms which account and collections are in scope, picks the right search or library tool, and asks before changing any collection or bookmark.
- [Audit your Unsplash collections and bookmarks](https://revampkey.com/marketplace/unsplash/skills/audit-collections-and-bookmarks.md): Reviews your Unsplash collections and bookmarks for duplicates, empty or stale collections and misfiled photos, then proposes a cleanup plan. It changes nothing until you approve each step.
- [Build a collection from search results](https://revampkey.com/marketplace/unsplash/skills/build-collection-from-search.md): Assembles an Unsplash collection from search results or your bookmarks, removing duplicates and checking orientation and fit. It shows the plan and waits for your approval before changing anything.
- [Find photographers and series that match your style](https://revampkey.com/marketplace/unsplash/skills/find-contributors-and-series.md): Turns a visual style you like into a short list of photographers and their related collections, each checked for consistency across their work. It asks before following, saving or changing anything in your account.
- [Find the right photos for a creative brief](https://revampkey.com/marketplace/unsplash/skills/find-photos-for-brief.md): Turns a creative brief into a short, ranked shortlist of Unsplash photos, with a reason for each pick. It only searches and reports, and asks before saving anything to your account.

## Install

- RevampKey: connect Unsplash at https://revampkey.com/marketplace/unsplash; the skills come with it.
- Any Agent Skills tool, into the current project:

```bash
for s in essentials audit-collections-and-bookmarks build-collection-from-search find-contributors-and-series find-photos-for-brief; do
  curl -fsSL --create-dirs -o .agents/skills/unsplash-$s/SKILL.md https://revampkey.com/marketplace/unsplash/skills/$s/SKILL.md
done
```

### What is a Unsplash agent skill?

A SKILL.md file: a short playbook an AI agent loads when your request matches it. Each Unsplash skill describes one job, which Unsplash tools to use in which order, what to check first and when to stop and ask you.

### Do the Unsplash skills change anything on their own?

2 of the 5 only read. The others tell the agent to show you the change and wait for a yes before it creates, edits or deletes anything in Unsplash.

### Which tools can use these skills?

Any agent that reads the open Agent Skills format: Claude Code, Cursor, Codex, VS Code with Copilot and RevampKey. In RevampKey they are attached when you connect Unsplash; elsewhere you copy the folders into your project or skills directory.

### Do I need the Unsplash MCP server too?

Yes. The skills tell the agent how to do the work; the Unsplash MCP server gives it the tools to do it. The Unsplash MCP setup guide covers every client.

MCP setup guide: https://revampkey.com/marketplace/unsplash.md