ov-immich/skills/immich/SKILL.md
Immich photo management server on port 2283. Includes PostgreSQL, Redis, and non-free codec support via RPM Fusion. CPU-only (no ML). MUST be invoked before building, deploying, configuring, or troubleshooting the immich image.
npx skillsauth add overthinkos/overthink-plugins immichInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
Self-hosted photo and video management server with full codec support.
| Property | Value | |----------|-------| | Base | fedora-nonfree | | Layers | agent-forwarding, nodejs24, supervisord, postgresql, vectorchord, redis, immich | | Platforms | linux/amd64 | | Ports | 2283 | | Registry | ghcr.io/overthinkos |
fedora → fedora-nonfree (RPM Fusion for codecs)pixi → python → supervisord (transitive)nodejs24 — Node.js 24 runtimepostgresql — database on :5432vectorchord — VectorChord vector similarity extensionredis — cache on :6379immich — Immich server on :2283, library + cache + import + external volumes| Port | Service | Protocol | |------|---------|----------| | 2283 | Immich web UI + API | HTTP |
| Name | Path | Purpose | |------|------|---------| | library | ~/.immich/library | Photo/video storage | | cache | ~/.immich/cache | Thumbnail cache | | import | ~/.immich/import | Photo import directory | | external | ~/.immich/external | External library (no-copy) | | pgdata | ~/.postgresql | PostgreSQL data |
ov image build immich
ov config immich
ov start immich
# Open http://localhost:2283
/ov-immich:immich — Immich server, db init, library/cache volumes/ov-foundation:postgresql — database backend/ov-foundation:vectorchord — VectorChord for smart search/ov-foundation:redis — session/cache backend/ov-foundation:rpmfusion — non-free codec support (via fedora-nonfree base)/ov-foundation:fedora-nonfree — parent base/ov-immich:immich-ml — adds CUDA ML for face recognition and smart searchAfter ov start:
ov status immich — container runningov service status immich — all services RUNNINGcurl -s -o /dev/null -w '%{http_code}' http://localhost:2283 — Immich HTTP returns 200MUST be invoked when the task involves the immich image, photo management, or the CPU-only Immich setup. Invoke this skill BEFORE reading source code or launching Explore agents.
/ov-build:image — image family umbrella (image: entries in overthink.yml, build/validate/inspect/list)/ov-build:build — build.yml vocabulary (distros, builders, init-systems)development
Claude Code multi-agent support in Overthink — sub-agents, dynamic workflows, and agent teams, and how each drives the existing `ov eval` disposable beds to test and verify. MUST be invoked before authoring or invoking an ov sub-agent / dynamic workflow / agent team, wiring agent-lifecycle hooks, or asking "which primitive should drive the R10 beds?".
tools
Mounts a virtiofs share tagged `workspace` at /workspace inside a VM guest via a systemd .mount unit. Use when a kind:vm entity shares a host directory into the guest and you need it auto-mounted (and re-mounted at every boot).
development
MUST be invoked before any work involving: the `kind: android` schema kind, a `target: android` deploy, the `apk:` layer package format (installing Android apps declaratively), AndroidDeployTarget, an in-pod emulator OR a remote/physical adb-endpoint device, or nested `pod → android` deployment. The first-class Android device + app surface that sits above `ov eval adb`/`appium`.
tools
Use when committing, branching, pushing, merging, tagging, creating PRs, or approving/merging PRs with gh — the feat/-branch, R10-gated, never-force-push landing workflow across the main repo + the plugins submodule + image/<distro> submodules. Covers sync-to-upstream, branch/worktree pruning, the fork+PR path for contributors without write access, and cross-repo @github landing order.