list_albums
no demo yetTry asking
- What photo albums do I have?
- list my gallery folders
- how many pictures are in each album
- show the albums on the phone
ghost skill run ghost/gallery list_albums Fossify Gallery (F-Droid): list albums, list photos in an album, open a photo, read its properties. Offline, read-only.
4actions not benchmarked yet
No clean demo yet. Recordings will start on HOME and show the app launching.
Demo shows: open_photo (name=ghost_green.png)
Ghost in the Droid seed skill for Fossify Gallery (
org.fossify.gallery), a FOSS gallery from F-Droid. Offline and read-only.
| Action | What it does | Params |
|---|---|---|
list_albums | Albums with item counts | none |
list_photos | File names in an album | album |
open_photo | Open a photo or video by file name | name |
get_photo_properties | Name, path, size, resolution, last modified | name |
Install the app from F-Droid (org.fossify.gallery), then:
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/gallery
ghost skill run ghost/gallery list_albums --device emulator-5554
ghost skill run ghost/gallery get_photo_properties --param name=IMG_0042.jpg --device emulator-5554
From any MCP agent:
run_skill(name="ghost/gallery", action="list_photos", params={"album": "Camera"})
# {"album": "Camera", "photos": ["IMG_0042.jpg", ...], "count": 12}
Android 14 emulator (google_apis x86_64, 1080x2400, 420 dpi), Fossify Gallery 1.13.1, en-US. Signed self-runs live in runs/.
Grants photo access when asked; declines all-files access. Never edits, shares or deletes. License: MIT (the skill; the app is GPL-3.0).
| App version | Android | Device | Skill version | Signed self-runs (pass/total) | Dates |
|---|---|---|---|---|---|
| 1.13.1 | 14 | Google/sdk_gphone64_x86_64 (emulator, 1080x2400, 420 dpi, en-US) | 1.0.0 | 12/12 | 2026-10-05 |
Untested so far: physical devices, other OEM skins, other screen sizes, other locales.
None in the signed self-runs.
Allow all is chosen); with partial access only the selected photos are listed./sdcard/Pictures/GhostTest/.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 or version.
Package: org.fossify.gallery (Fossify Gallery, GPL-3.0 FOSS app, installed from the official F-Droid repository, sha256-verified)
Verified: 2026-10-05 on a headless emulator pool, Android 14 google_apis x86_64, 1080x2400 @ 420 dpi, Fossify Gallery 1.13.1, en-US. Offline, no account.
Skill class: HARD. Read-only: no edit, share, favorite or delete.
id/dir_holder cards with id/dir_name and id/photo_cnt; toolbar id/top_toolbar_search (Search folders).id/media_item_holder thumbnails; names (id/medium_name) only appear after id/toggle_filename (the choice persists). The search field reads Search in <album>.ViewPagerActivity): file name as toolbar title, id/menu_properties, bottom bar id/bottom_favorite, id/bottom_edit, id/bottom_share, id/bottom_delete.id/property_label / id/property_value pairs (Name, Path, Size, Resolution, Last modified).Allow all (the gallery cannot list albums with a partial selection).Album cards, the filename toggle and Properties are inside the top ~700 px where heads-up notifications appear. Those taps go through guarded_tap, which checks SystemUI's mHeadsUpPinnedMode and refuses while a heads-up is pinned.
list_albums()Read album cards while scrolling. Returns albums: [{name, count}].
list_photos(album)Tap the album card, show file names if hidden, read id/medium_name while scrolling.
open_photo(name)Look up the file's MediaStore id (content query --uri content://media/external/images/media, then videos) and fire VIEW with that content URI to org.fossify.gallery. Success: the viewer shows the file name.
get_photo_properties(name)open_photo, tap Properties, pair labels with the value directly below, close with OK. Returns properties: {name, path, size, resolution, last_modified}.
Three 320x240 PNGs pushed to /sdcard/Pictures/GhostTest/ and media-scanned.
Try a sample prompt or run an action by name. Replace any parameters in braces with your own values.
list_albumsTry asking
ghost skill run ghost/gallery list_albums list_photosTry asking
ghost skill run ghost/gallery list_photos open_photoTry asking
ghost skill run ghost/gallery open_photo get_photo_propertiesTry asking
ghost skill run ghost/gallery get_photo_properties 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.0latest | never | >=1.13.1 | pending | 18.5 KB | untagged |