Samara-main photos-integration

Search, summarize, and analyze Apple Photos metadata through local scripts in this repo. Use when requests include phrases like "show me photos from...", "find photos with...", "what photos...", "photos today", "recent photos", "photo stats", or similar queries about people, places, dates, favorites, and photo library summaries.

install

source · Clone the upstream repo

git clone https://github.com/claudeaceae/samara-main

Claude Code · Install into ~/.claude/skills/

T=$(mktemp -d) && git clone --depth=1 https://github.com/claudeaceae/samara-main "$T" && mkdir -p ~/.claude/skills && cp -r "$T/.claude/skills/photos" ~/.claude/skills/claudeaceae-samara-main-photos-integration && rm -rf "$T"

manifest: .claude/skills/photos/SKILL.md

source content

Photos Integration

Use this skill to fetch Apple Photos metadata through

osxphotos

wrappers.

Run Commands

Use
```
bin/photo-search
```
for targeted searches.
Use
```
bin/photos-today
```
for a short recent-activity summary.
Use
```
bin/photos-stats
```
for whole-library overview metrics.

Map Requests To Scripts

Use
```
bin/photo-search
```
when the user asks for filtered results.
Use
```
bin/photos-today
```
when the user asks what they photographed today or over the last N days.
Use
```
bin/photos-stats
```
when the user asks for totals, date range, top keywords/people/places, or recent additions.

Command Patterns

bin/photo-search --keyword "beach" --person "Erik" --from 2026-02-01 --to 2026-02-21 --place "Brooklyn" --favorite --limit 20 --format json
bin/photos-today --days 7
bin/photos-stats

Response Style

Return concise summaries first, then key details.
Keep
```
photo-search
```
output in JSON unless the user asks for table-style output.
Highlight empty-result cases clearly and suggest a broader query.
Surface permission failures exactly and suggest enabling Photos and Full Disk Access permissions.