Docsagent
docsagent/docsagent
Search and manage private, local document collections (PDF, PPTX, DOCX) offline.
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…
Install Immich Photo Manager
$ npx skills add davepoon/buildwithclaude --skill immich-photo-manager -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install davepoon/buildwithclaude immich-photo-manager --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/davepoon/buildwithclaude.git skills-src && mkdir -p .claude/skills && cp -r skills-src/plugins/all-skills/skills/immich-photo-manager .claude/skills/immich-photo-manager && rm -rf skills-srcUse ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.
Claude Code skills documentation · loads skills from .claude/skills/
Install the "immich-photo-manager" agent skill from https://github.com/davepoon/buildwithclaude/tree/main/plugins/all-skills/skills/immich-photo-manager into .claude/skills/immich-photo-manager/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "immich-photo-manager", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/davepoon/buildwithclaude/tree/main/plugins/all-skills/skills/immich-photo-managerType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add davepoon/buildwithclaude --skill immich-photo-manager -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install davepoon/buildwithclaude immich-photo-manager --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/davepoon/buildwithclaude.git skills-src && mkdir -p .agents/skills && cp -r skills-src/plugins/all-skills/skills/immich-photo-manager .agents/skills/immich-photo-manager && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "immich-photo-manager" agent skill from https://github.com/davepoon/buildwithclaude/tree/main/plugins/all-skills/skills/immich-photo-manager into .agents/skills/immich-photo-manager/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "immich-photo-manager", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add davepoon/buildwithclaude --skill immich-photo-manager -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install davepoon/buildwithclaude immich-photo-manager --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/davepoon/buildwithclaude.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/plugins/all-skills/skills/immich-photo-manager .cursor/skills/immich-photo-manager && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "immich-photo-manager" agent skill from https://github.com/davepoon/buildwithclaude/tree/main/plugins/all-skills/skills/immich-photo-manager into .cursor/skills/immich-photo-manager/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "immich-photo-manager", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/davepoon/buildwithclaude.git --path plugins/all-skills/skills/immich-photo-manager--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add davepoon/buildwithclaude --skill immich-photo-manager -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install davepoon/buildwithclaude immich-photo-manager --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/davepoon/buildwithclaude.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/plugins/all-skills/skills/immich-photo-manager .gemini/skills/immich-photo-manager && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "immich-photo-manager" agent skill from https://github.com/davepoon/buildwithclaude/tree/main/plugins/all-skills/skills/immich-photo-manager into .gemini/skills/immich-photo-manager/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "immich-photo-manager", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install davepoon/buildwithclaude immich-photo-managerInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add davepoon/buildwithclaude --skill immich-photo-manager -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/davepoon/buildwithclaude.git skills-src && mkdir -p .github/skills && cp -r skills-src/plugins/all-skills/skills/immich-photo-manager .github/skills/immich-photo-manager && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "immich-photo-manager" agent skill from https://github.com/davepoon/buildwithclaude/tree/main/plugins/all-skills/skills/immich-photo-manager into .github/skills/immich-photo-manager/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "immich-photo-manager", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add davepoon/buildwithclaude --skill immich-photo-manager -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install davepoon/buildwithclaude immich-photo-manager --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/davepoon/buildwithclaude.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/plugins/all-skills/skills/immich-photo-manager .opencode/skills/immich-photo-manager && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "immich-photo-manager" agent skill from https://github.com/davepoon/buildwithclaude/tree/main/plugins/all-skills/skills/immich-photo-manager into .opencode/skills/immich-photo-manager/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "immich-photo-manager", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
Facts
- Skill name
immich-photo-manager- GitHub stars
- 3.6k
- Token cost
- ~1.1k tokens
- SKILL.md length
- 444 words
- Files
- 1
- Skills in repo
- 247
- Repo updated
- First seen
- Licence
- MIT
At a glance
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…
- Tasks that involve MCP servers
- SKILL.md covers Overview, Key Features, Compatibility and Installation, plus 3 more sections
- Calls claude, git and pip3; reaches github.com
- Tasks that involve PDF
What it does
Immich Photo Manager is an agent skill from davepoon/buildwithclaude. 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
Its SKILL.md is about 1.1k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.
It sits in Documents & Office, covering MCP servers and PDF. The repository describes itself as: A single hub to find Claude Skills, Agents, Commands, Hooks, Plugins, and Marketplace collections to extend Claude Code, Claude Desktop, Agent SDK and OpenClaw. The licence is MIT.
When your agent uses it
- Tasks that involve MCP servers
- Tasks that involve PDF
Example prompts
- “/immich-photo-manager”
Requirements
- Python 3
- Docker
What it can do on your machine
Read from SKILL.md and the folder at commit 616deb5. It shows what the files ask for, not the result of running them.
Tool permissions
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Runs code
Shell commands in SKILL.md call:
claudegitpip3uvx
From the folder's file list and the shell code blocks in SKILL.md.
Network
Hosts in commands or code, which the agent is likely to contact:
github.com
Also links to:
immich.appdrolosoft.com
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
Context cost
Immich Photo Manager loads about 1.1k tokens when it runs. Until then it costs about 88 tokens; SKILL.md has 444 words of instructions outside code blocks.
Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.
Safety
Auto-check passed
The automated check found no risky patterns in SKILL.md.
Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.
SKILL.md
The full file from davepoon/buildwithclaude at commit 616deb5, republished under its MIT licence (© davepoon). 444 words, ~1,103 tokens.
Download SKILL.mdSave it as
.claude/skills/immich-photo-manager/SKILL.md (or your agent's skills folder).- name
- immich-photo-manager
- 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
- category
- storage-docs
Immich Photo Manager
MCP server and Claude Code plugin for intelligent photo management with self-hosted Immich.
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
Show full SKILL.md (128 more words)Show less
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
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-managerThen 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 destinationsSkills
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
- License: MIT
© davepoon, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file
Files
Just SKILL.md in plugins/all-skills/skills/immich-photo-manager of davepoon/buildwithclaude.
Open the folder on GitHubat commit 616deb5
Compare with similar skills
Immich Photo Manager next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| Immich Photo Manager this skilldavepoon/buildwithclaude | 3.6k | — | ~1.1k | Automated safety check: Pass | MIT | |
| Docsagentdocsagent/docsagent | 625 | — | ~834 | Automated safety check: Pass | None | |
| Illustrator Preflightie3jp/illustrator-mcp-server | 157 | — | ~2.2k | Automated safety check: Pass | MIT | |
| Slidev CLI Skilldskilld-dev/vue-ecosystem-skills | 181 | — | ~1.1k | Automated safety check: Pass | MIT | |
| Cloudflare Browser Renderingeinverne/dotfiles | 121 | — | ~4.9k | Automated safety check: Pass | GPL-3.0 | |
| MarkitdownImCa0/just-laws | 781 | 14 repos | ~3.2k | Automated safety check: Notes | MIT |
Similar skills
Illustrator Preflight
ie3jp/illustrator-mcp-server
Run comprehensive pre-press preflight checks on Adobe Illustrator documents using illustrator-mcp tools.
Slidev CLI Skilld
skilld-dev/vue-ecosystem-skills
Build, present, and ship Slidev decks with @slidev/cli. An agent skill from skilld-dev/vue-ecosystem-skills.
Cloudflare Browser Rendering
einverne/dotfiles
Guide for implementing Cloudflare Browser Rendering - a headless browser automation API for screenshots, PDFs, web scraping, and testing.
Markitdown
ImCa0/just-laws
Convert files and office documents to Markdown. An agent skill from ImCa0/just-laws.
Gzh Design
isjiamu/gzh-design-skill
微信公众号文章排版引擎，将 Markdown 转换为可直接粘贴到公众号编辑器的 HTML。主题风格从 references/theme-index.md 注册的自定义主题库中选取，自动章节编号、关键词下划线标记、引言卡片、目录导航、代码块、图片/GIF、作者签名。支持 Markdown / Word(.docx) / PDF / 纯文本输入（非 Markdown…
More from davepoon/buildwithclaude
All 247 skills in this repoiOS Hig Design Guide
davepoon/buildwithclaude
Build, update, and apply iOS design specifications using Apple Human Interface Guidelines (HIG) source data.
Video Downloader
davepoon/buildwithclaude
Download YouTube videos with customizable quality and format options.
Qwen Vision
davepoon/buildwithclaude
A skill your agent uses when the user asks to "analyze video", "watch this video", "what happens in this video", "describe this clip", "review this footage", "classify these videos", "compare…
Atlas Cloud Media
davepoon/buildwithclaude
Discover Atlas Cloud image and video models, inspect their live schemas, and submit one confirmed media generation request with bounded GET polling.
Browser Extension Launch
davepoon/buildwithclaude
面向没有编程经验的用户，把想法做成可试用的浏览器插件，并完成检查、商店材料、审核提交和上线验证；也用于继续已有插件、排错和发布新版。用户说“帮我做个插件”“把插件上架”“继续我的插件”时使用。普通网站开发、仅查询插件知识不触发。
Slack Gif Creator
davepoon/buildwithclaude
Toolkit for creating animated GIFs optimized for Slack, with validators for size constraints and composable animation primitives.
Related
Categories
Questions about Immich Photo Manager
What does Immich Photo Manager do?
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…. Immich Photo Manager is an agent skill from davepoon/buildwithclaude. 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.
When should I use Immich Photo Manager?
Immich Photo Manager fits situations like: tasks that involve MCP servers; tasks that involve PDF.
How do I install Immich Photo Manager in Claude Code?
Run `npx skills add davepoon/buildwithclaude --skill immich-photo-manager -a claude-code`. Or copy the skill folder (plugins/all-skills/skills/immich-photo-manager in davepoon/buildwithclaude) into .claude/skills/immich-photo-manager in your project. Claude Code loads it when a task matches its description.
How do I install Immich Photo Manager in Codex?
Run `npx skills add davepoon/buildwithclaude --skill immich-photo-manager -a codex`. Or copy the skill folder (plugins/all-skills/skills/immich-photo-manager in davepoon/buildwithclaude) into .agents/skills/immich-photo-manager in your project. Codex loads it when a task matches its description.
Can I use Immich Photo Manager in Cursor, Gemini CLI or GitHub Copilot?
Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add davepoon/buildwithclaude --skill immich-photo-manager -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/immich-photo-manager, .gemini/skills/immich-photo-manager, .github/skills/immich-photo-manager and .opencode/skills/immich-photo-manager in your project.
What does Immich Photo Manager need to run?
Going by SKILL.md and its folder, Immich Photo Manager needs the command-line tools its instructions call (claude, git, pip3 and uvx). Our summary lists: Python 3; Docker.
Does Immich Photo Manager access the network?
SKILL.md names 3 domains. In commands or code: github.com; the agent is likely to contact it when it follows the instructions. As links in the text: immich.app and drolosoft.com. This is read from the text; nothing was executed.
Is Immich Photo Manager safe to install?
Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.
What licence does Immich Photo Manager use?
Immich Photo Manager is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.
How many tokens does Immich Photo Manager use?
About 1.1k tokens (SKILL.md is roughly 4.4k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.
What are the alternatives to Immich Photo Manager?
Skills that share tags, products or a category with Immich Photo Manager: Docsagent (docsagent/docsagent, 625 stars), Illustrator Preflight (ie3jp/illustrator-mcp-server, 157 stars), Slidev CLI Skilld (skilld-dev/vue-ecosystem-skills, 181 stars) and Cloudflare Browser Rendering (einverne/dotfiles, 121 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
Who maintains Immich Photo Manager?
davepoon (a GitHub user) maintains it in davepoon/buildwithclaude, which has 3,610 GitHub stars. The repository holds 247 skills in this directory. The repository was last updated on October 9, 2026.
Source: davepoon/buildwithclaude on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.