How to use the Unsplash Asset Images agent skill

What an agent skill is and what this one makes the agent do

An agent skill is a folder with a SKILL.md file that gives an AI agent specific instructions for one kind of task. The agent reads the skill when your request matches the skill's description.

This skill covers stock image selection. When you ask for a profile picture, headshot, website background or wallpaper, the agent suggests Unsplash photo pages grouped by use case. For each one it tells you which ratio and sizes to use, and how to download and crop the file.

• Avatars: 1:1, for example 256×256, 512×512 or 1024×1024
• Headshots: 4:5 (800×1000, 1200×1500, 1600×2000) or 3:4 (900×1200, 1500×2000)
• Editorial portraits: 3:4, 4:5 and a 1:1 crop of 1080×1080 for social
• Website heroes: 16:9 at 1920×1080, 2400×1350 or 2880×1620; social banners at 1500×500
• Abstract wallpapers: 2560×1600 or 2880×1800 for desktop, 1080×1920 (9:16) for mobile

How to install the unsplash-asset-images skill

Download the ZIP file for the skill from this page and unzip it. The folder contains SKILL.md, demo/index.html and demo/PROMPT.md.

For a personal install, place the unzipped skill folder in ~/.claude/skills/. To limit it to one project, place it in that project's .claude/skills/ folder.

You can also upload the skill in the Claude apps under Settings → Capabilities → Skills.

• Personal: ~/.claude/skills/unsplash-asset-images
• Project only: .claude/skills/unsplash-asset-images inside your project folder
• Claude apps: Settings → Capabilities → Skills, then upload

How to trigger the skill with natural requests

You do not need a special command. Describe the image need in plain words that match the skill's purpose: an avatar, a headshot card, a portrait with an editorial feel, a website background, or a wallpaper. Mention the ratio or device if you know it.

The more context you give (the use case, the mood and the device), the closer the picks will fit. The skill's own guidance is to favour clean negative space and avoid busy backgrounds.

• "I need a 1:1 avatar for a team page, something simple and friendly."
• "Find me a 4:5 headshot card for a consultant's landing page, neutral background."
• "Give me a 16:9 hero background for a hiking website with mountains."
• "I want a 9:16 abstract wallpaper for a phone, brand-safe and not busy."

What you get back and how to use the images

Each recommendation comes with the canonical Unsplash photo page URL and suggested ratios and sizes. The skill says that if you want a file, you should use the Download button on the Unsplash photo page, then crop or resize in your design tool or image pipeline.

The skill also tells the agent to keep faces centred for avatars and headshots, and to keep the horizon visible in wide backgrounds. It says not to include Unsplash source or secondary image links, only main photo page URLs.

• Open the photo page, click Download, then crop to the target ratio
• Keep faces centred for avatars and headshots
• Keep the horizon in wide backgrounds
• Use the 4:5 ratio as the default for headshot cards

What the skill needs, and safety notes

The skill lists no requirements. It does not run scripts and does not use the network, according to its listing. Its picks come from a fixed list of curated links written into its instructions, so the agent does not search Unsplash live and does not review the licence of each image.

On licensing, the skill says Unsplash images are generally free to use and to avoid Unsplash+ images unless you specifically want them. It says attribution is not required by Unsplash, though including the photographer's name is good practice. If you use an image commercially, check its licence and any model or property release yourself.

• Requirements: none listed
• Runs scripts: no
• Uses network: no
• Licence of the skill: MIT
• Avoid Unsplash+ images unless you want them

Tips for better picks

Because the list is fixed and generic, the skill works best as a fast starting point for mockups, placeholders and general-purpose visuals. For a specific person, brand or product photo, search Unsplash yourself or use a different source.

If the agent's picks do not fit, ask again with a narrower use case, such as a 3:4 editorial portrait with a candid mood, and it will choose from the matching group.

• Use it for placeholders and mockups quickly
• Ask for one use case at a time for closer matches
• Crop to the ratio in your own tool after downloading