К основному содержанию
скилл CX Codex

immich-photo-manager — скилл для Claude Code: функции и установка

Скилл immich-photo-manager для Claude Code управляет фототекой Immich через запросы на обычном языке. Он ищет фото и текст на снимках, помогает разбирать альбомы, дубликаты и метаданные.

MIT 105 установок ★ 3 785 обновлён 2026-10-25

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add davepoon/buildwithclaude --skill immich-photo-manager -a claude-code
Открыть на GitHub

Что делает immich-photo-manager

Скилл подключает агента к self-hosted Immich и даёт инструменты для работы с фототекой. Можно искать снимки по содержимому, тексту на изображениях, людям, местам и датам, собирать альбомы по геоданным и находить дубликаты. В наборе 94 MCP-инструмента и 13 скиллов.

Он также помогает исправлять метаданные, разбирать лица и получать кадры из видео. Альбом или выбранные снимки можно собрать в PDF-фотокнигу, а результаты поиска — открыть в HTML-галерее. Перед изменениями скилл показывает находки и запрашивает подтверждение; удаление в корзину отделено от окончательного удаления.

Для работы нужны Immich версии 1.90 или новее, API-ключ и Python 3.10+.

Какие задачи решает

  • найти снимки по описанию сцены или тексту на фото
  • сгруппировать поездки в альбомы по геоданным
  • обнаружить дубликаты из разных источников
  • исправить время съёмки и недостающие GPS-данные
  • собрать PDF-фотокнигу из альбома

Примеры запросов агенту

  • Найди фото с билетом на поезд.
  • Собери альбомы по местам, где я путешествовал.
  • Сделай PDF-фотокнигу из альбома Sintra.

Как установить immich-photo-manager

1Через Skills CLI (Vercel)

npx skills add davepoon/buildwithclaude --skill immich-photo-manager -a claude-code

2Вручную: положить файлы

~/.claude/skills/immich-photo-manager/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/immich-photo-manager/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы об immich-photo-manager

Как установить immich-photo-manager в Claude Code?

Выполни npx skills add davepoon/buildwithclaude --skill immich-photo-manager -a claude-code. Файл скилла находится по пути ~/.claude/skills/immich-photo-manager/SKILL.md.

Что делает immich-photo-manager?

Скилл даёт агенту инструменты для поиска и организации фотографий в Immich. Он также работает с дубликатами, людьми, метаданными, видео и PDF-фотокнигами.

Что нужно для работы immich-photo-manager?

Нужны Immich версии 1.90 или новее, API-ключ и Python 3.10+.

Исходный текст

SKILL.md · MIT
---
name: immich-photo-manager
category: storage-docs
description: "Manage your self-hosted Immich photo library through conversation: natural language and OCR search, geographic album curation, duplicate detection, people and faces, metadata repair, video frames and PDF photobooks. 94 MCP tools and 13 skills, tested live on Immich 2.x and 3.x. Install: claude plugin install immich-photo-manager"
---

# Immich Photo Manager

> MCP server and Claude Code plugin for intelligent photo management with self-hosted [Immich](https://immich.app).

## Overview

When your Immich library has grown past what you can manage by hand, this plugin gives Claude direct access to your instance through 94 MCP tools and 13 skills. Search with natural language or by the text inside a photo, create geographic albums from GPS data, find duplicates across import sources, manage people and faces, repair metadata, cut frames out of videos, export an album as a PDF photobook, and browse results in interactive HTML galleries. The plugin runs on your machine and talks only to your Immich; originals never leave your server.

## Key Features

- **Natural language search**: CLIP visual search ("sunset at the beach", "birthday cake"), plus people, places, dates and camera filters
- **Text inside photos**: OCR search finds a ticket, a sign or a document by what is written on it
- **Geographic albums**: albums organized by place from GPS clustering and temporal matching
- **Duplicate detection**: cross-source analysis with perceptual hashing (catches re-encoded copies from Apple Photos and Google Takeout); near-duplicates can be stacked instead of deleted
- **People and faces**: list, search, merge and rename people, reassign misidentified faces
- **Metadata repair**: fix noon and midnight timestamps, infer missing GPS from neighboring photos, correct timezone offsets
- **Video frames and PDF reports**: evenly spaced frames from any clip, and an album or selection exported as a PDF photobook with captions, built locally
- **Dates in one call**: month buckets, a calendar heatmap that shows gaps, and Immich's "on this day" memories
- **Library health**: asset inventory, metadata quality, storage breakdown and recommendations
- **Notes between sessions**: verdicts stored on each asset, so the next cleanup skips what an earlier pass reviewed
- **Interactive galleries**: self-contained HTML files with embedded thumbnails, 3 themes, 4 view modes, slideshow
- **Safety first**: findings are shown and confirmed before anything is written; trash first, permanent delete only on request

## Compatibility

Every release runs live against real Immich 2.7.5 and 3.1.0 in Docker before it is tagged (all tools over MCP, state re-read after each write); the kit is in the repository under `tests/live/`. Works with Claude Code, Claude Desktop, LM Studio and any MCP client. Requires Immich 1.90+, an API key and Python 3.10+.

## Installation

```bash
git clone https://github.com/drolosoft/immich-photo-manager.git
cd immich-photo-manager
pip3 install -r src/requirements.txt
claude plugin marketplace add ./
claude plugin install immich-photo-manager
```

Then run `/setup-immich-photo-manager` inside Claude Code, or say "Update my Immich credentials to https://photos.example.com with API key <key>". The same server is available as `uvx immich-photo-manager` for other MCP clients and as a Docker image (`ghcr.io/drolosoft/immich-photo-manager`, MCP over HTTP on port 8626).

## Usage

```
"How healthy is my photo library?"
"Show me my photos from Italy"
"Find the photo with the train ticket"
"Create albums for everywhere I've traveled"
"Find duplicates in my library and keep the best of each group"
"Make me a PDF of the Sintra album"
/cleanup: scan for screenshots and junk
/my-travels: discover all travel destinations
```

## Skills

photo-search, photo-cleanup, duplicate-report, auto-album-curator, album-manager, album-report, travel-map, metadata-fixer, storage-optimizer, library-health-report, people-report, rotate-photos, timeline-gaps.

## Links

- **Repository**: https://github.com/drolosoft/immich-photo-manager
- **Tools reference**: https://github.com/drolosoft/immich-photo-manager/blob/main/doc/MCP-TOOLS.md
- **Demos from real sessions**: https://github.com/drolosoft/immich-photo-manager/blob/main/doc/demos/README.md
- **Author**: [Drolosoft](https://drolosoft.com)
- **License**: MIT

© davepoon · MIT · davepoon/buildwithclaude

Похожие скиллы

Все скиллы по теме «Тексты и документация» →
Immich Photo Manager drolosoft Сервер Immich Photo Manager подключает ИИ-агента к вашей библиотеке Immich: он ищет фотографии, помогает разбирать альбомы и находить дубликаты. CX Codex +1 ★ 65звёзд репо photo-to-scanned-pdf daymade Скилл photo-to-scanned-pdf превращает снимки документов со смартфона или цифровые файлы в чистые сканы PDF формата A4 с выравниванием и осветлением фона. CX Codex +1 358установок upload-photo Devin-AXIS Скилл upload-photo для Claude Code загружает локальные изображения в Vercel Blob и возвращает публичные URL. URL используются в PR-комментариях, документации и при обмене скриншотами. CX Codex +1 ★ 7 523звёзд репо is-this-photo-real UseOSINT Скилл is-this-photo-real проверяет, настоящее ли фото или видео: ищет первоисточник, читает метаданные, смотрит свет и тени. Пригодится при фактчекинге и разборе подделок. CX Codex +1 58 300установок photo-slideshow iart-ai Скилл photo-slideshow для Claude Code превращает папку с фотографиями в видео с движением, переходами и музыкой. Агент подключает его для слайд-шоу, фотомонтажа или ролика-воспоминания. CX Codex +1 1 300установок tiktok-photo-mode social-media-skills Скилл tiktok-photo-mode для Claude Code собирает нативные фото-карусели TikTok и готовит конфигурацию публикации через WoopSocial. Создаёт посты Photo Mode. CX Codex +1 1 200установок

Из того же набора235

Весь набор →
square-automation Скилл square-automation для Claude Code автоматизирует работу с Square через Rube MCP: платежи, заказы, счета и локации. Управляет платежами и заказами из кода. CX Codex +1 119установок clawring Настраивает исходящие телефонные звонки от агента для срочных оповещений и сводок. Работает без аккаунта Twilio через сервис clawr.ing. CX Codex +1 112установок x-twitter-scraper Скилл x-twitter-scraper для извлечения данных из X (Twitter) через API Xquik: поиск твитов, профили, подписчики, тренды, мониторинг аккаунтов с вебхуками. 22 инструмента MCP. CX Codex +1 107установок recap Скилл recap для Claude Code и Cursor собирает финансовые итоги за выбранный период и строит текстовый обзор расходов и доходов. CX Codex +1 105установок tidy Скилл tidy для Claude Code группирует некатегоризированные транзакции и предлагает для них категории. Запускается по просьбе привести расходы в порядок или распределить операции по категориям. CX Codex +1 104установок google-drive-upload Скилл google-drive-upload для Claude Code отправляет файлы в Google Drive через веб-приложение Google Apps Script. Срабатывает по просьбе сохранить или загрузить файл. CX Codex +1 101установок szamlazz-invoicing Скилл szamlazz-invoicing для Claude Code оформляет венгерские счета через Agent API сервиса szamlazz.hu. Запускается по запросу выставить счёт, создать proforma, отменить или скачать счёт. CX Codex +1 100установок optimize-database-performance Слэш-команда optimize-database-performance для Claude Code разбирает медленные запросы и индексы в PostgreSQL и MySQL: планы выполнения, неиспользуемые индексы, партиции, пул соединений. CX Codex +1 ★ 3 785звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой