list_photos
no demo yetTry asking
- What photos do I have on this phone?
- how many pictures are in my gallery
- list my recent photos
- when was my last photo taken
ghost skill run ghost/photos list_photos Google Photos without an account: list on-device photos and videos with dates and folders, open one in the viewer, check the Trash.
3actions not benchmarked yet
No clean demo yet. Recordings will start on HOME and show the app launching.
Demo shows: list_photos (defaults: max_items=50)
Ghost in the Droid seed skill for Google Photos (
com.google.android.apps.photos) as an on-device gallery, no account.
| Action | What it does | Params |
|---|---|---|
list_photos | List photos and videos (newest first) with date taken and folder | max_items (default 50) |
open_photo | Open an item full screen | index (0 = newest) |
count_trash | Report how many items are in Trash | none |
pip install "ghost-in-the-droid>=1.6.0" # 1.6.0 is not on PyPI yet: until it ships, git clone the repo and `pip install -e .`
ghost skill install ghost/photos
ghost skill run ghost/photos list_photos --device emulator-5554
ghost skill run ghost/photos open_photo --param index=0 --device emulator-5554
From any MCP agent:
run_skill(name="ghost/photos", action="list_photos", params={"max_items": 10})
# {"items": [{"kind": "photo", "taken": "Oct 5, 2026 8:12:33 PM", "folder": "GhostSeed"}], "count": 1, "folders": ["GhostSeed"]}
Android 14 emulator (google_apis x86_64, 1080x2400, 420 dpi), Photos 6.29, en-US, fresh app data each run (pm clear). Test media was created on the device with screencap into /sdcard/Pictures/GhostSeed/. Signed self-runs live in runs/.
Never signs in and never turns on backup; the skill only reads the library and opens the viewer. License: MIT.
| App version | Android | Device | Skill version | Signed self-runs (pass/total) | Dates |
|---|---|---|---|---|---|
| 6.29.0.519265844 | 14 | Google/sdk_gphone64_x86_64 (emulator, 1080x2400, 420 dpi, en-US) | 1.0.0, 1.0.1 | 11/12 | 2026-10-05 |
Untested so far: physical devices, other OEM skins, other screen sizes, other locales.
open_photo: TimeoutError_; the newest library item was a video and Android's one-time "Viewing full screen" hint covered the viewer; fixed in 1.0.1 (video player accepted) and in the engine's OS popup layer (hint dismissed).SOFT.md is the narrative an agent reads when the exact steps no longer match your app version and it has to adapt the skill.
What each action means, which UI landmarks it relies on, and how success is recognised, so an agent can adapt it to another gallery app.
Package: com.google.android.apps.photos (Google Photos)
Verified: 2026-10-05 on a headless emulator pool, Android 14 google_apis x86_64, 1080x2400 @ 420 dpi, Photos 6.29, en-US, no account.
Skill class: HARD. No login, no checkpoints.
id/tab_photos and id/search_destination.Photo taken on Oct 5, 2026 8:12:33 PM or Video taken on .... Device folders appear as id/collection_title headers.id/photos_photofragment_components_background_photo_view carries the same desc as the tile; bottom buttons Share, Edit, Lens, Delete.Show Navigation Drawer) holds Photos, Trash. Empty trash shows id/photos_trash_ui_empty_state_title_view = Nothing in Trash.Sign in to back up and no dismiss button: tap the dimmed area above it. It can slide in a few seconds after launch, so open_home waits until the Photos tab has been visible for three polls in a row.Not now (there is no Play account to update with).list_photos(max_items)Cold-start on the home grid and walk it, scrolling, returning {items: [{kind, taken, folder}], count, folders}. Pages are merged by the longest overlap of tile descriptions, because several tiles can share the same timestamp.
open_photo(index)Open the index-th item (0 = newest). Tiles say whether they are a photo or a video. A photo opens in the photo view, whose content-desc must contain the tapped tile's date; a video opens in the player (photos_videoplayer_videolayout). The first full-screen view shows Android's "Viewing full screen" hint; the engine's OS popup layer taps Got it.
count_trash()Open Trash from the drawer and return {trash_count, trash_empty}.
Try a sample prompt or run an action by name. Replace any parameters in braces with your own values.
list_photosTry asking
ghost skill run ghost/photos list_photos open_photoTry asking
ghost skill run ghost/photos open_photo count_trashTry asking
ghost skill run ghost/photos count_trash Each release is an immutable git tag. The tree hash pins the exact skill directory the installer verifies.
| Version | Released | App versions | Tree | Size | Provenance |
|---|---|---|---|---|---|
1.0.1latest | never | >=6.29 | pending | 17.1 KB | untagged |