apple-photos

Name: apple-photos
Author: rcantarelli11

by @rcantarelli11 in Tools

# Install this skill:

npx skills add rcantarelli11/shared-skills --skill "apple-photos"

Install specific skill from multi-skill repository

# Description

Apple Photos.app integration for macOS. List albums, browse photos, search by date/person/content, export photos.

# SKILL.md

name: apple-photos
description: Apple Photos.app integration for macOS. List albums, browse photos, search by date/person/content, export photos.
metadata: {"clawdbot":{"emoji":"📷","os":["darwin"]}}

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> [output_path]`

Output

Recent/search: Filename | Date | Type | UUID
People: ID | Name | Photo Count
Default export: /tmp/photo_export.jpg

Workflow: View a Photo

Get UUID: scripts/photos-recent.sh 1
Export: scripts/photos-export.sh "UUID"
View at /tmp/photo_export.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

# Supported AI Coding Agents

This skill is compatible with the SKILL.md standard and works with all major AI coding agents:

⚡ Amp 🚀 Antigravity 🤖 Claude Code 🦀 Clawdbot 📝 Codex ▶️ Cursor 🤖 Droid 💎 Gemini CLI 🐙 GitHub Copilot 🪿 Goose 📊 Kilo Code 🔧 Kiro CLI 💻 OpenCode 🦘 Roo Code 🌲 Trae 🏄 Windsurf

Learn more about the SKILL.md standard and how to use these skills with your preferred AI coding agent.