AGENT SKILL

icloud-photos-bridge

Read the Mac's iCloud Photos library from an agent. Catalog photos/videos with Apple's own quality scores, faces, labels and places, identify who is who by face cluster, build contact sheets, and download full-quality originals from iCloud. Use whenever a task needs the user's own photos or videos (selfie picking, b-roll, post images). Read-only; never edits or deletes the library.

License 许可
Apache-2.0
所属仓库
getedgehq/skills
最近更新
2026-11-12
Stars
★ 5
Forks
0

01 前言 Front Matter

name
icloud-photos-bridge
description
Read the Mac's iCloud Photos library from an agent. Catalog photos/videos with Apple's own quality scores, faces, labels and places, identify who is who by face cluster, build contact sheets, and download full-quality originals from iCloud. Use whenever a task needs the user's own photos or videos (selfie picking, b-roll, post images). Read-only; never edits or deletes the library.

02 资源文件 9

03 SKILL.md 正文

iCloud Photos bridge

The bridge is the local Photos database on the Mac, read through osxphotos. iCloud Photos syncs into it, so everything in iCloud is visible here, including Apple's per-photo aesthetic scores, face clusters and scene labels. Originals that only live in iCloud ("Optimize Mac Storage") are downloaded on demand through PhotoKit.

Other skills build on this one: selfie-picker, broll-picker.

Rules

  • Read-only. Never modify, delete, favorite or move anything in Photos.
  • Photos stay on this Mac. Don't upload them anywhere unless the user asks for that exact destination.
  • Never show or use other people's photos as the subject without asking. Identify people by face cluster (owner.py), never by guessing from the image.
  • Download originals with fetch.py (PhotoKit). osxphotos export --download-missing silently skips iCloud-only files ("missing: 1") from a terminal, and asks y/N on an existing folder, which hangs an agent.

Setup (once)

bash <this skill's folder>/scripts/setup.sh

Installs osxphotos (pipx or uv), checks library access, and saves where these scripts live to ~/.config/icloud-photos/bridge_dir so selfie-picker and broll-picker find them wherever the skill is installed. BLOCKED means the terminal app needs Full Disk Access (System Settings > Privacy & Security > Full Disk Access), then restart the terminal. The first iCloud download triggers a Photos permission prompt: choose Full Access.

All scripts run with the osxphotos Python:

PY=$(cat ~/.config/icloud-photos/python); B=$(cat ~/.config/icloud-photos/bridge_dir)

1. Who is the owner (once)

$PY $B/owner.py list --html people.html     # biggest face clusters with a sample photo
$PY $B/owner.py set <person-uuid>           # saved to ~/.config/icloud-photos/owner.json

The largest unnamed cluster is usually the library owner. Look at people.html (or read the keyphoto thumbnails) and confirm with the user before saving.

2. Catalog

$PY $B/catalog.py --out catalog.jsonl --since 2026-09-01 [--until ...] [--kind photo|video|all]

One JSON line per item: uuid, date, kind, selfie (Photos' Selfies album), front_camera, favorite, burst, live, w, h, duration, local_original, thumb (local preview path), place (city level), labels, score (Apple's 0-1 aesthetics: overall, sharply_focused_subject, well_framed_subject, pleasant_lighting, failure, noise, ...) and faces (person uuid, name, size, quality, eyes: 2 open / 1 closed / 0 unknown, smile). Hidden, deleted and screenshots are left out. A few thousand items take under a minute.

3. Look at candidates

$PY $B/montage.py picks.json m.jpg --n 24 --title "Selfies"   # m.jpg for you to Read + m.html for the user
$PY $B/sheet.py final.json final.html --title "Selfies"        # HTML sheet alone, for a final set

The .html is one self-contained file (photos embedded, filename, date and caption under each) that opens in any browser: hand that to the user. Always look at the JPG yourself first; scores miss what a glance catches.

4. Download originals

jq -r '.[].uuid' picks.json > uuids.txt
$PY $B/fetch.py ./originals --from uuids.txt

Full quality through PhotoKit, downloading from iCloud as needed: photos as the current (edited) version, videos as the original movie, named <uuid>.<ext>. Re-running skips files already there.

  • First run asks for Photos access: choose Full Access.
  • CloudPhotoLibraryErrorDomain 1005 means iCloud refused the download, almost always because the disk is nearly full. The script stops itself below 5 GB free (MIN_FREE_GB=1 overrides it for a few small photos); free space, then re-run. Failed items print a hint for the PhotoKit error they hit.
  • Fetch needs free disk space for originals; iCloud-only items download on demand.

04 同仓库更多 Skills

getedgehq
getedgehq/skills

zero-downtime-cloud-move

Runbook for moving a live app from one cloud to another (Google Cloud to AWS, AWS to Google Cloud, a PaaS to your own account, or one storage provider to another) without downtime. The agent inventories what is really running, builds the new stack next to the old one, keeps a one-line rollback for every phase, proves the new stack with real workloads before any traffic moves, cuts over with a checklist, watches a fixed window after the switch, copies data with an idempotent job whose second pass must report 0 left, and deletes the old cloud last. Use when someone asks to migrate, move or replatform a production app, switch cloud providers, move a backend, database files or object storage, plan a DNS cutover, or decommission an old cloud account.

★ 5
getedgehq
getedgehq/skills

zayats-ceo-branding

Build an evidence-based CEO positioning paper, Personal Branding Roadmap, and editorial workflow using Marina Zayats's public method. Use for executive branding, LinkedIn ghostwriting briefs, profile strategy, and recurring CEO-approved content planning.

★ 5
getedgehq
getedgehq/skills

yc-app-roast

YC App Roast: roast a YC or a16z Speedrun application. Use when a founder wants their YC or Speedrun answers scored, asks "what would a YC partner think", wants the weak answers found or rewritten, or wants their draft checked before they submit. Scores every answer 0-10 against public advice from YC and Speedrun partners, names the top issue with the exact words that cost points, and writes a rewrite from the founder's own facts. Works for YC and a16z Speedrun. Not affiliated with Y Combinator or a16z.

★ 5
getedgehq
getedgehq/skills

yc-app-review

YC App Review: get a YC or a16z Speedrun application reviewed by people you trust. Use when a founder wants friends, mentors or alumni to review their YC or Speedrun application, or asks to share their draft for feedback. Builds a shareable review page (one HTML file, application-portal look) where reviewers leave notes per question and press "Send my notes" to send them back as text, then parses the notes into proposed rewrites. Optional tracked private links per reviewer. Works for YC and a16z Speedrun. Not affiliated with Y Combinator or a16z.

★ 5
getedgehq
getedgehq/skills

x-growth-playbook

X Growth Playbook. Analyse a person's own X (Twitter) posts and tell them what to post next, with the numbers behind every claim. Compares quote posts vs originals, links vs no links, short vs long, time of day in their timezone, media vs text and the topics they name, reports medians with n, then writes a 10-step plan and the next 7 posts in their voice. Use when the user says "analyse my X posts", "what works on my Twitter", "how do I grow on X", "what should I post next on X", "audit my X account", or shares an X data archive, X API export or a list of their posts. Runs on the user's computer.

★ 5
getedgehq
getedgehq/skills

workplan

Create, update, or close work plans for multi-step tasks. Use when starting refactors, bug lists, feature work, migrations, or any task with 2+ steps. Also use after auto-compaction to re-orient. Triggers: "workplan", "work plan", "create a plan", "what's the plan", "where was I", or when Claude detects a multi-step task that needs tracking.

★ 5