Unsplash agent skills for Claude Code, Cursor and RevampKey

5 ready-made playbooks that teach an AI agent how to do real Unsplash work: which tools to call, what to check first, and when to stop and ask you.

Download RevampKey, free I have it: connect Unsplash

Connect Unsplash once and all 5 skills install themselves and stay up to date. Mac, Windows and Linux.

All 5 Unsplash skills

Each skill is one job. You ask in plain words and the agent loads the skill that matches, then follows its steps.

Start hereAsks before writing23 Unsplash tools

Use Unsplash safely with AI

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.

Use it when

You have just connected Unsplash and want to know what the assistant can and cannot change
You are about to add, move or delete photos in a collection and want a checkpoint first
Search results or your library are getting too long to be useful

Tools it uses

get_current_user
get_user_collections
get_bookmarks
search_photos
search_illustrations
search_related
search_by_image
upload_image_for_search
search_collections
get_featured_collections
get_related_collections
get_collection
search_users
get_assets_from_collection
create_collection
update_collection
delete_collection
add_asset_to_collection
delete_asset_from_collection
add_asset_to_bookmarks
delete_asset_from_bookmarks
delete_bookmarks
create_collection_from_bookmarks

Example

Add the three best rain photos from my bookmarks into my Moody Weather collection.

I'll check the signed-in account first. I found 2 collections named Moody Weather, so I need the one you mean. Here are the 3 bookmarked rain photos I would add to the collection with id 48213. Please reply yes to confirm this exact change.

Use in RevampKeyRead the full skill →

Asks before writing13 Unsplash tools

Audit your Unsplash collections and bookmarks

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.

Use it when

You have dozens of collections and cannot remember what half of them are for
You want to find duplicate photos saved across several bookmarks and collections
You are about to reorganise your library and want a plan before touching anything

Tools it uses

get_current_user
get_user_collections
get_bookmarks
get_assets_from_collection
create_collection
update_collection
delete_collection
add_asset_to_collection
delete_asset_from_collection
add_asset_to_bookmarks
delete_asset_from_bookmarks
delete_bookmarks
create_collection_from_bookmarks

Example

Audit my Unsplash collections and tell me what I should tidy up, but don't change anything yet.

Your account has 18 collections and 64 bookmarked photos. I reviewed the 12 collections from 2023 in full. Four are empty, and two of those look like abandoned first attempts. Three photos appear in both a bookmark and a collection. Two collections have no clear theme and need your input before I propose anything. Nothing has been changed; each action below is waiting for your yes.

Use in RevampKeyRead the full skill →

Asks before writing16 Unsplash tools

Build a collection from search results

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.

Use it when

You want a themed collection for a deck, site or moodboard
You have bookmarks that should become a named collection
You need to top up an existing collection without adding duplicates

Tools it uses

get_current_user
get_collection
get_assets_from_collection
search_photos
search_related
upload_image_for_search
search_by_image
get_bookmarks
create_collection
create_collection_from_bookmarks
add_asset_to_collection
update_collection
delete_asset_from_collection
delete_collection
delete_bookmarks
delete_asset_from_bookmarks

Example

Build me a collection of warm, candid office workspace photos in landscape for our onboarding deck, about 12 photos.

I checked your current collections and found no existing one for this theme, so I propose a new collection. I searched three queries and found 18 candidates. I'd add 12 landscape photos, skipping 4 portrait shots and 2 near-duplicates. Nothing has been created yet; say yes to create it with these 12.

Use in RevampKeyRead the full skill →

Read-only11 Unsplash tools

Find photographers and series that match your style

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.

Use it when

You love one photographer's look and want others who shoot like them
You need a few contributors to credit for a project
You want a series to study for colour, light or composition

Tools it uses

search_photos
search_illustrations
search_by_image
search_users
get_user_collections
get_collection
get_assets_from_collection
get_related_collections
search_collections
get_featured_collections
get_current_user

Example

Find me three photographers who shoot moody, low-key street portraits in warm tones, with a body of work, not just one great shot.

Three strong matches: Mara Ilves (@mara.ilves), whose collection 'Night Shopfronts' has 24 images in the same warm, low-key style; Tomas Brandt (@tbrandt), with a consistent street-portrait series; and Lina Okoro (@linaokoro), whose 'Quiet Cities' collection repeats the palette. I have not followed or saved any of them.

Use in RevampKeyRead the full skill →

Read-only6 Unsplash tools

Find the right photos for a creative brief

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.

Use it when

You need a hero banner or thumbnail in a specific mood and orientation
You have a reference image and want visually similar options
You want a few strong picks for a deck slide rather than a pile of search hits

Tools it uses

search_photos
search_illustrations
search_by_image
upload_image_for_search
search_related
search_users

Example

Find me 5 landscape photos of a quiet forest in morning light, warm tones, for a blog header.

I reviewed 60 results for 'forest morning light mist' filtered to landscape. Top pick: a misty pine path with open space in the upper third, good for text overlay, warm from the preview. Two others are close alternatives. I didn't save anything; say the word if you want these added to a collection.

Use in RevampKeyRead the full skill →

Get all 5 without copying a file

RevampKey adds the skills when you connect Unsplash, updates them for you and removes them when you disconnect.

Download RevampKey

How Unsplash skills work

Connect Unsplash
The Unsplash MCP server gives the agent its tools.
Ask in plain words
“Audit my Unsplash collections and tell me what I should tidy up, but don't change anything yet.” Each SKILL.md says when it applies, so only the one that fits is loaded.
Approve any change
The agent calls the tools in order, checks its work, and shows you any change before it makes it.

How to install Unsplash skills

In RevampKey the skills install themselves when you connect Unsplash. In other tools each skill is one folder with a SKILL.md file, and you also need the Unsplash MCP server connected there.

About 1 minute · nothing to copy

Download RevampKey for Mac, Windows or Linux and sign in.
Open Connectors and connect Unsplash. All 5 skills come with it and stay up to date; they go away when you remove the connector.
Ask in plain language, for example “Audit my Unsplash collections and tell me what I should tidy up, but don't change anything yet.”
Download RevampKeyConnect Unsplash · 1 click
Get RevampKey to connect Unsplash
RevampKey is a free desktop app for Mac, Windows and Linux. Install it, sign in, and Unsplash is one click away with its skills already attached.
Download RevampKey
Not now? Use the skills in your current tool
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 .claude/skills/unsplash-$s/SKILL.md https://revampkey.com/marketplace/unsplash/skills/$s/SKILL.md done
Other tools

Into this project’s .claude/skills folder

Connect the Unsplash MCP server in Claude Code.

Run this in your project folder to add all 5 skills:

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 .claude/skills/unsplash-$s/SKILL.md https://revampkey.com/marketplace/unsplash/skills/$s/SKILL.md
done

Ask in plain language, for example “Audit my Unsplash collections and tell me what I should tidy up, but don't change anything yet.”

Into the shared .agents/skills folder

Connect the Unsplash MCP server in Cursor.

Run this in your project folder to add all 5 skills:

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

Ask in plain language, for example “Audit my Unsplash collections and tell me what I should tidy up, but don't change anything yet.”

Into the shared .agents/skills folder

Connect the Unsplash MCP server in Codex.

Run this in your project folder to add all 5 skills:

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

Ask in plain language, for example “Audit my Unsplash collections and tell me what I should tidy up, but don't change anything yet.”

Into the shared .agents/skills folder

Connect the Unsplash MCP server in VS Code.

Run this in your project folder to add all 5 skills:

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

Ask in plain language, for example “Audit my Unsplash collections and tell me what I should tidy up, but don't change anything yet.”

RevampKey or copy the files?

In RevampKey

One click when you connect Unsplash
Updated for you when a skill improves
Removed when you disconnect
The MCP server is set up for you
800+ other connectors, same way

Download free

Copy into your project

One command per project
Run it again to get updates
You connect the Unsplash MCP server yourself
Works in Claude Code, Cursor, Codex and VS Code

See the command

Unsplash skills FAQ

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.

Unsplash MCP server setup · This page as Markdown

Put Unsplash’s best workflows in your agent

Download RevampKey, connect Unsplash and ask your first question in about a minute.

Download RevampKey Connect Unsplash · 1 click

All 5 Unsplash skills

Use Unsplash safely with AI

Use it when

Tools it uses

Audit your Unsplash collections and bookmarks

Use it when

Tools it uses

Build a collection from search results

Use it when

Tools it uses

Find photographers and series that match your style

Use it when

Tools it uses

Find the right photos for a creative brief

Use it when

Tools it uses

Get all 5 without copying a file

How Unsplash skills work

How to install Unsplash skills

RevampKey or copy the files?

In RevampKey

Copy into your project

Unsplash skills FAQ

Put Unsplash’s best workflows in your agent

Skills for related tools