add_task
Play demoTry asking
- Add a task to water the plants
- remind me to buy stamps
- new todo: call the bank, about the card
- put renew passport on my task list
ghost skill run ghost/tasks add_task Tasks.org (F-Droid), local lists only: add a task, list open tasks, search, mark a task done. No account, no sync.
Task check: passed without the skill, passed with it.
One recorded run each way on add_task, claude-haiku-5-5, same phone and same prompt. Watch it in the Before / after tab.
2.5× fewer tokens, about the same time with the skill. Task check: passed without the skill, passed with it.
| Run | Time | Tokens | Tool calls | Result |
|---|---|---|---|---|
| No skill: agent drives by hand | 17.8 s | 145,510 | 13 | passed |
With skill: find_skill, run_skill (add_task) | 18.6 s | 58,333 | 4 | passed |
Prompt: Add a task called Buy milk
Both sides created Buy milk in local-only mode. AFTER was 0.74s slower in this observed pair (18.58 vs 17.84), with 4 vs 13 calls; elapsed advantage is not assumed from call or token reduction.
One recorded pair on samsung-demo, 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.
Demo shows: add_task (title=Water the plants)
Ghost in the Droid seed skill for Tasks.org (
org.tasks), a FOSS to-do app from F-Droid. Local lists only: no account, no sync.
| Action | What it does | Params |
|---|---|---|
add_task | New task in the default local list | title, notes |
list_tasks | Open tasks with notes and section | none |
search_tasks | Tasks matching a text | query |
complete_task | Tick a task by exact title | title |
Install the app from F-Droid (org.tasks), 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/tasks
ghost skill run ghost/tasks add_task --param "title=Buy stamps" --device emulator-5554
ghost skill run ghost/tasks complete_task --param "title=Buy stamps" --device emulator-5554
From any MCP agent:
run_skill(name="ghost/tasks", action="list_tasks")
# {"tasks": [{"title": "Call the bank", "notes": "about the card", "section": "No due date"}], "count": 1}
Android 14 emulator (google_apis x86_64, 1080x2400, 420 dpi), Tasks.org 15.12, en-US. Signed self-runs live in runs/.
The editor's Save button is in the top toolbar; the skill taps it only when no heads-up notification is showing. Tasks are never deleted. License: MIT (the skill; the app is GPL-3.0).
| App version | Android | Device | Skill version | Signed self-runs (pass/total) | Dates |
|---|---|---|---|---|---|
| 15.12 | 14 | Google/sdk_gphone64_x86_64 (emulator, 1080x2400, 420 dpi, en-US) | 1.0.0 | 12/12 | 2026-10-05 |
Android 13 was additionally replayed on a 720x1600 Samsung SM-A037F (300 dpi, en-GB) and a 1080x2400 emulator (420 dpi, en-US). See the cross-device report for measured outcomes and limitations; other profiles remain unverified.
The historical runs above were green. Samsung failures and subsequent fixes are recorded in the cross-device report.
complete_task would then need a checked-state check.complete_task ticks the first match.On OEMs without the AOSP pinned-notification field, toolbar taps require Tasks focus and an independently unobscured target. Compose controls additionally use the focused window bounds and every higher visible window; unknown geometry or an overlap refuses the tap.
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 to-do app or version.
Package: org.tasks (Tasks.org, 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, Tasks.org 15.12, en-US.
Skill class: HARD. No login, no checkpoints. Local lists only: first run is answered with Continue without sync; the skill never adds an account (Google Tasks, CalDAV, DAVx5, EteSync) and never syncs.
id/rowBody with id/completeBox (checkbox), id/title, id/description; section headers id/header (No due date, Today, ...). Bottom bar: id/menu_search, id/menu_sort, id/menu_voice_add; FAB id/fab (Create new task).Save) at the top left. BACK asks "discard your changes?" instead of saving.Enable reminders banner card appears at the top of the list until dismissed (detector taps Dismiss).Save sits where heads-up notifications appear, and a heads-up may carry one-tap actions (for SMS: smart replies that send). helpers.guarded_top_tap reads mHeadsUpPinnedMode from the SystemUI dump and refuses to tap while a heads-up is pinned (waits up to 15 s, then fails). Test pools should also run with settings put global heads_up_notifications_enabled 0.
add_task(title, notes)Share a text to Tasks.org (android.intent.action.SEND, text/plain, -p org.tasks, EXTRA_SUBJECT = title, EXTRA_TEXT = notes): the editor opens prefilled. Guarded tap on Save. Success: a list row with that exact title.
list_tasks()Read rows (title, notes, section) while scrolling. The validator rewinds and rereads the device list, requiring equality with the returned rows and count.
search_tasks(query)Tap the bottom-bar search, type the query, dismiss the keyboard with BACK, and require the requested query to remain in id/search_src_text before reading the filtered rows. Dismissing the keyboard prevents scrolling gestures from typing into the focused search field. Scrolling can collapse the query toolbar offscreen, so the validator rewinds to reveal it before checking the query. It then independently rereads the filtered device list and rewinds again to verify the query stayed unchanged. It requires equality with the returned rows/count and checks that every returned task mentions the query in its title or notes. A falsely empty result is rejected when matching rows are visible; two empty reads cannot pass under a changed or missing query.
complete_task(title)Tap the id/completeBox on the row with that exact title. Completed tasks leave the open list (default "hide completed"). Success: no open row with that title.
complete_task would then need a checked-state check.complete_task ticks the first match.Try a sample prompt or run an action by name. Replace any parameters in braces with your own values.
add_taskTry asking
ghost skill run ghost/tasks add_task list_tasksTry asking
ghost skill run ghost/tasks list_tasks search_tasksTry asking
ghost skill run ghost/tasks search_tasks complete_taskTry asking
ghost skill run ghost/tasks complete_task 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 | >=15.12 | pending | 23.9 KB | untagged |