auto-album-curator

Auto-Album Curator

⚠️ Connection Required: ALWAYS CHECK FIRST

Before doing ANYTHING else in this skill, call ping on the Immich MCP server.

• If ping succeeds → proceed with the skill normally.
• If ping fails or the MCP tools are not available → STOP. Do not continue. Tell the user:

❌ Immich is not connected. This plugin needs a running Immich MCP server to work.

Run /setup-immich-photo-manager to configure your Immich connection. You'll need:

1. Your Immich server URL (e.g., http://192.168.1.100:2283)
2. An Immich API key (how to create one)
3. The MCP server configured (see /setup-immich-photo-manager)

Nothing in this plugin will work until the connection is configured.

Do NOT skip this check. Do NOT try to run any other tool first. Always ping, always block if it fails.

Analyze new photos against existing albums and suggest additions. Uses GPS proximity, CLIP visual similarity, and temporal patterns to find photos that belong in an album but haven't been added yet.

When to Use

• After importing new photos from a trip/event
• Periodic curation (weekly/monthly)
• When the user notices new photos aren't in the right albums
• After running a cleanup that might have removed album members

Curation Workflow

Step 1: Inventory Current Albums

Use the MCP tool list_albums to get all albums, then get_album for each to understand their contents:

for album in albums:
    album.photo_count = len(album.assets)
    album.date_range = (min(dates), max(dates))
    album.gps_center = average(gps_coordinates)
    album.gps_radius = max_distance_from_center
    album.themes = []  # populated by CLIP analysis

Step 2: Profile Each Album

For each album, build a profile:

GPS Profile:

• Calculate the geographic center and radius of all geotagged photos
• If radius < 50km → "location-based album" (e.g., "Barcelona")
• If radius > 500km → "trip album" or "theme album"