add_item
Play demoTry asking
- Add milk to my shopping list
- put eggs on the shopping list
- add 3 apples to my groceries
- I need bread, add it to the list
ghost skill run ghost/shopping-list add_item Shopping List app (F-Droid): add items with a quantity, add several at once, read the whole list back. Offline, no account.
Agent run: stopped early without the skill, finished with it (not independently checked).
One recorded run each way, claude-haiku-5-5, same phone and same prompt. Watch it in the Before / after tab.
78× fewer tokens, 3.2× faster with the skill. Agent run: stopped early without the skill, finished with it (not independently checked).
| Run | Time | Tokens | Tool calls | Result |
|---|---|---|---|---|
| No skill: agent drives by hand | 59.8 s | 1,578,860 | 27 | stopped early |
| With skill: find_skill, run_skill | 18.6 s | 20,240 | 3 | finished |
Prompt: Add milk, eggs and bread to my shopping list.
Same prompt, same phone, clean app state per side. Left: no skill, the agent drives the UI by hand. Right: find_skill + run_skill. 'ok' means the agent finished its turn; the result was not independently checked.
One recorded pair on samsung-a03s, claude-haiku-5-5; tokens count every input, cache and output token once per assistant message. Not a signed run: it adds no run evidence.
Control Shopping List on Android with an AI agent. Add items to your shopping list, tick them off and clear the bought ones from your phone by asking an agent.
Target search phrase: AI agent shopping list Android
Demo shows: add_item (name=Milk, quantity=2)
Ghost in the Droid seed skill for Shopping List (
com.woefe.shoppinglist), a FOSS offline shopping list from F-Droid. Offline, no account.
| Action | What it does | Params |
|---|---|---|
add_item | Add one item with an optional quantity | name, quantity |
add_items | Add several comma separated items | items |
get_items | Return every item with its quantity | none |
check_item | Toggle an item's checked (grey) state by tapping its row | name |
remove_checked | Delete all checked items (needs confirm=yes) | confirm |
An agent can drive the whole app with these; compose them.
| Role | Action |
|---|---|
| Entry | add_item |
| Primitives | add_items, check_item, remove_checked |
| Read state | get_items |
The app: F-Droid, or https://f-droid.org/packages/com.woefe.shoppinglist/. The skill:
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/shopping-list
ghost skill run ghost/shopping-list add_item --param name=Milk --param quantity=2 --device <serial>
ghost skill run ghost/shopping-list get_items --device <serial>
run_skill(name="ghost/shopping-list", action="get_items")
# {"items": [{"name": "Milk", "quantity": "2"}]}
Try asking: "Add milk, eggs and bread to my shopping list."
Real Samsung phone, Android 13 (720x1600, 300 dpi, en-GB), Shopping List 0.11.0. License: MIT.
| App version | Android | Device | Skill version | Dates |
|---|---|---|---|---|
| 0.11.0 | 13 | Samsung real phone (720x1600, 300 dpi, en-GB) | 1.0.0 | 2026-11-02 |
get_items presses BACK until the add button is visible.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 app of this kind or another version.
Package: com.woefe.shoppinglist (Shopping List, GPL-3.0, version 0.11.0 from the official F-Droid repository, sha256-verified)
Verified: 2026-11-02 on a real Samsung phone, Android 13, 720x1600 @ 300 dpi, en-GB. Offline, no account.
Skill class: HARD. No login, no checkpoints.
id/toolbar_main), one row per item with id/text_description and id/text_quantity, the add button id/fab_add.id/new_item_description, id/new_item_quantity, id/button_add_new_item (Done). The panel stays open after Done so several items can be added; the first BACK hides the keyboard, the second closes the panel.add_item(name, quantity)Open the add panel (tap the add button if closed), type the name, optionally tap the quantity field and type it, tap Done. Success: a row with that name (and quantity) is visible.
add_items(items)Same panel flow once per item, no quantities. Success: every item shows as a row.
get_items()Close the add panel (BACK until the add button shows), then pair each text_description with the text_quantity on the same row. Returns items: [{name, quantity}].
check_item(name)Tap the row whose text_description equals the name. The app does not expose the checked state to accessibility, so the result reports the tapped row.
remove_checked(confirm)Tap the toolbar delete button, wait for "Remove all checked items?", tap OK. Refuses unless confirm=yes. Returns the remaining items.
Other list apps keep the same ideas: an add field, an optional quantity, rows of text. Re-find the ids with dump_xml; the helpers only depend on the ids listed in the layout reference.
Try a sample prompt or run an action by name. Replace any parameters in braces with your own values.
add_itemTry asking
ghost skill run ghost/shopping-list add_item add_itemsTry asking
ghost skill run ghost/shopping-list add_items get_itemsTry asking
ghost skill run ghost/shopping-list get_items check_itemTry asking
ghost skill run ghost/shopping-list check_item remove_checkedTry asking
ghost skill run ghost/shopping-list remove_checked 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 | >=0.11.0 | pending | 16.0 KB | untagged |