Agent skill · software engineering · sundial-org
apple-photos
Apple Photos.app integration for macOS. List albums, browse photos, search by date/person/content, export photos.
Why this skill is useful
Adds 8 executable scripts for Apple Photos integration that automate photo management tasks not covered in public documentation.
What it needs
Requires sqlite installed locally. About 1k tokens when loaded. Last updated 2026-03-07. 639 stars on the source repository.
What this skill does
Apple Photos Access Photos.app via SQLite queries. Run scripts from: cd {baseDir} Requirements Full Disk Access for terminal (System Settings → Privacy → Full Disk Access) Commands Command Usage --------- ------- Library stats scripts/photos-count.sh List albums scripts/photos-list-albums.sh Recent photos scripts/photos-recent.sh [count] List people scripts/photos-list-people.sh Search by person scripts/photos-search-person.sh <name> [limit] Search by content scripts/photos-search-content.sh <query> [limit] Search by date scripts/photos-search-date.sh <start> [end] [limit] Photo info scripts/photos-info.sh <uuid> Export photo scripts/photos-export.sh <uuid> [outputpath] Output Recent/search: Filename Date Type UUID People: ID Name Photo Count Default export: /tmp/photoexport.jpg Workflow: View a Photo 1. Get UUID: scripts/photos-recent.sh 1 2. Export: scripts/photos-export.sh "UUID" 3. View at /tmp/photoexport.jpg Notes Date format: YYYY-MM-DD or YYYY-MM-DD HH:MM Content search uses ML, slower (~5-10s) than date/person (~100ms) HEIC auto-converts to JPEG on export Name search is case-insensitive, partial match
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills sundial-org/apple-photos