Agent Skills › davepoon/buildwithclaude › immich-photo-manager

immich-photo-manager

GitHub

通过自然语言搜索、地理相册整理、重复检测及健康审计等功能，帮助用户高效管理自托管的Immich照片库，并支持生成交互式HTML画廊。

plugins/all-skills/skills/immich-photo-manager/SKILL.md davepoon/buildwithclaude

触发场景

使用自然语言描述内容查找照片根据地理位置或旅行经历创建相册检测并识别照片库中的重复项评估照片库的健康状况和元数据完整性

安装

npx skills add davepoon/buildwithclaude --skill immich-photo-manager -g -y

更多选项

非标准路径

npx skills add https://github.com/davepoon/buildwithclaude/tree/main/plugins/all-skills/skills/immich-photo-manager -g -y

不安装直接使用

npx skills use davepoon/buildwithclaude@immich-photo-manager

指定 Agent (Claude Code)

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

安装 repo 全部 skill

npx skills add davepoon/buildwithclaude --all -g -y

预览 repo 内 skill

npx skills add davepoon/buildwithclaude --list

SKILL.md

Frontmatter

{
    "name": "immich-photo-manager",
    "category": "storage-docs",
    "description": "Manage your self-hosted Immich photo library through conversation — natural language search, geographic album curation, duplicate detection, library health audits, and interactive HTML galleries. Install: claude plugin install immich-photo-manager"
}

Immich Photo Manager

Claude Code plugin for intelligent photo management with self-hosted Immich.

Overview

When your Immich library has grown past the point of manual management, this plugin gives Claude direct access to your instance through 21 MCP tools and 11 specialized skills. Search with natural language, create geographic albums from GPS data, find duplicates across import sources, and browse results in interactive HTML galleries.

Key Features

Natural language search — Find photos using CLIP visual search ("sunset at the beach", "birthday cake")
Geographic albums — Create albums organized by place using GPS clustering + temporal matching
Duplicate detection — Cross-source analysis with perceptual hashing (catches re-encoded copies from Apple Photos, Google Takeout)
Library health — Full audit of metadata completeness, storage breakdown, and recommendations
Interactive galleries — Self-contained HTML files with embedded thumbnails, 3 themes, slideshow mode
Safety first — Never deletes without explicit user confirmation

Installation

git clone https://github.com/drolosoft/immich-photo-manager.git
cd immich-photo-manager
claude plugin marketplace add .
claude plugin install immich-photo-manager

Usage

"How healthy is my photo library?"
"Show me my photos from Italy"
"Create albums for everywhere I've traveled"
"Find duplicates in my library"
/cleanup — scan for screenshots and junk
/my-travels — discover all travel destinations

immich-photo-manager