# unsplash

Скилл ищет фотографии на Unsplash по ключевым словам или выдаёт случайные и сразу отдаёт готовую подпись с автором. Пригодится, когда нужны картинки для статьи или макета.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 548 установок
- Автор: cevatkerim
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/cevatkerim/skills/tree/HEAD/skills/unsplash/SKILL.md
- Обновлён: 2026-01-25
- HTML: https://affpapa.org/nevibecode/skills/unsplash

## Что делает

Скилл оборачивает Unsplash API в три bash-скрипта. `search.sh` ищет по ключевому слову с фильтрами: страница выдачи, число результатов, сортировка, ориентация кадра и цвет. `random.sh` возвращает случайные снимки, можно сузить до темы и ориентации. `track.sh` отмечает факт скачивания — этого требует API Unsplash.

Каждая операция отдаёт JSON: ссылки на разные размеры (`raw`, `full`, `regular`, `small`, `thumb`), ширину, высоту, доминирующий цвет, blur hash, имя и профиль фотографа, а также готовые `attribution_text` и `attribution_html`. Для веба советует `urls.regular` — 1080px по ширине.

Перед первым запуском нужен ключ доступа. Если скрипт вернул `UNSPLASH_ACCESS_KEY not set`, скилл спрашивает ключ у вас и дописывает его в `.env` в корне проекта, а дальше подхватывает оттуда при каждом запуске. Из зависимостей — `bash`, `curl` и `jq`; без `jq` скрипты не разберут ответ. Демо-режим даёт 50 запросов в час, так что на серии картинок для лендинга лимит выбьется быстро. Атрибуцию убирать нельзя: по условиям Unsplash API это повод отозвать доступ.

## Установка

### Claude Code (родная платформа)

1. **Через Skills CLI (Vercel)**
```bash
npx skills add cevatkerim/skills --skill unsplash -a claude-code
```

2. **Вручную: положить файлы**
- Файл: `~/.claude/skills/unsplash/SKILL.md` — Папка скилла целиком; для одного проекта — .claude/skills/unsplash/

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add cevatkerim/skills --skill unsplash -a codex
```

2. **Вручную: положить файлы**
- Файл: `.agents/skills/unsplash/SKILL.md` — Для всех проектов — ~/.agents/skills/

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add cevatkerim/skills --skill unsplash -a cursor
```

2. **Вручную: положить файлы**
- Файл: `.cursor/skills/unsplash/SKILL.md` — Cursor читает и .agents/skills/, и .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install cevatkerim/skills unsplash
```

2. **Вручную: положить файлы**
- Файл: `.github/skills/unsplash/SKILL.md`

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add cevatkerim/skills --skill unsplash -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/cevatkerim/skills --path skills/unsplash
```

### Windsurf (Devin Desktop)

**Вручную: положить файлы**
- Файл: `.devin/skills/unsplash/SKILL.md` — Старый путь .windsurf/skills/ тоже читается

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add cevatkerim/skills --skill unsplash -a opencode
```

### Claude.ai

**Claude.ai**
- Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/cevatkerim/skills/tree/HEAD/skills/unsplash/SKILL.md

## Когда брать
- подобрать фото под ключевое слово для статьи
- получить случайные снимки по теме для галереи
- отфильтровать выдачу по ориентации под вёрстку
- найти картинки в заданной цветовой гамме
- собрать подпись с автором и ссылкой на Unsplash

## Примеры запросов агенту
- Найди три фото по запросу «technology workspace» в горизонтальной ориентации и покажи с атрибуцией
- Дай пять случайных снимков по теме architecture
- Отметь скачивание фото abc123xyz

## Похожие
- [unsplash-image](https://affpapa.org/nevibecode/skills/unsplash-image.md) — скилл · 367 установок
- [unsplash-asset-images](https://affpapa.org/nevibecode/skills/unsplash-asset-images.md) — скилл · 1600 установок
- [metadata](https://affpapa.org/nevibecode/skills/metadata.md) — скилл · 490 установок
- [huggingface-tool-builder](https://affpapa.org/nevibecode/skills/huggingface-tool-builder.md) — скилл · 1600 установок
- [omada-controller](https://affpapa.org/nevibecode/skills/omada-controller.md) — скилл · 872 установки
- [qa](https://affpapa.org/nevibecode/skills/garrytan-qa.md) — скилл · 457 установок

_Часть страницы не вошла по размеру — она есть в HTML-версии._

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md