album-report

Album Report

⚠️ 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.

Build a PDF on the user's machine with export_pdf. Metadata comes from Immich; the descriptions come from you, after looking at the images.

Workflow

1. get_export_preview(album_id=...) (or asset_ids=... from a search). Note the count and which items are videos, with their duration.
2. Look: get_album_images(album_id, size="thumbnail") for photos. For each video, get_video_frames(asset_id, count=6).
3. For a long video, skim it first with one call: get_video_frames(asset_id, interval=5, sheet=true) returns contact sheets (30 stamped frames per image) instead of dozens of images. If a video needs a closer look (something passes between two frames), narrow it: get_video_frames(asset_id, count=8, start=8, end=12), or interval=1 for one frame per second. When the tool answers with confirm_required, tell the user the number of frames and the estimated tokens and continue only if they agree (confirm=true).
4. Write one caption per asset (what it shows, in the user's language) into captions={asset_id: text}.
5. export_pdf(album_id=..., captions=..., frames_per_video=6); report the path, pages and warnings. Offer layout="grid" for big sets, map=true when there is GPS data (explain it fetches OpenStreetMap tiles), and a higher frames_per_video (up to 120, free of tokens) for videos that matter.
6. If the user wants the photos themselves and not only the report, get_download_info(album_id=...) says how big the zip would be and how many archives Immich would split it into, and download_archive(output_path=..., album_id=...) writes the originals next to the PDF. Say the size before downloading: originals and videos add up fast, and an existing file is never overwritten.