immich-photo-manager
Immich Photo Manager enables natural language search, geographic album creation from GPS data, duplicate detection across sources, and library audits within self-hosted Immich photo libraries. Use this Claude Code skill when managing large photo collections that require intelligent organization, finding similar images across imports, or generating interactive HTML galleries for browsing results.
git clone --depth 1 https://github.com/davepoon/buildwithclaude /tmp/immich-photo-manager && cp -r /tmp/immich-photo-manager/plugins/all-skills/skills/immich-photo-manager ~/.claude/skills/immich-photo-managerSKILL.md
# Immich Photo Manager
> Claude Code plugin for intelligent photo management with self-hosted [Immich](https://immich.app).
## 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
```bash
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
```
## Links
- **Repository**: https://github.com/drolosoft/immich-photo-manager
- **Author**: [Drolosoft](https://drolosoft.com)
- **License**: MITScans the codebase for dead code, tech debt, outdated dependencies, and code quality issues. Delegates to the Centinela (QA) agent.
Creates a complete product feature specification with acceptance criteria, scope, dependencies, and risks. Delegates to the Prometeo (PM) agent.
Implements a feature from its specification. Reads the spec, designs architecture, writes code and tests. Delegates to the Forja (Dev) agent.
Pre-release verification checklist. Validates features, tests, docs, security, and quality gates before shipping. Delegates to the Centinela (QA) agent.
Addresses and fixes findings from a QA code review. Reads the review report, fixes critical and warning issues, and prepares for re-verification. Delegates to the Forja (Dev) agent.
Deep security audit covering OWASP Top 10, authentication, authorization, data protection, dependency vulnerabilities, and secrets scanning. Delegates to the Centinela (QA) agent.
Initialize uc-taskmanager for the current project. Creates works/ directory and configures Bash permissions in .claude/settings.local.json. Use when the user says "uctm init", "initialize uctm", "uctm 초기화", or "초기화".