ghost/contacts

Google Contacts on a device without a Google account: create, search, read and list local contacts.

Runs Score 20/100 Official hard skill python contacts

Before / after

Benchmark details ↓
Tokens saved343,499Paired medians · 1/1 tasks · N=5
UI actions saved9Paired medians · 1/1 tasks · N=5
Pass · before → with skill5/5 → 5/5Current arms · failures included

Before With skill · median tokens per task

Contacts: create Ada Lovelace Contacts: create Ada Lovelace. Median tokens: before 889,687, with skill 367,882. N=5 before / 5 with skill. 889,687367,882 −59% tokensN=5/5 N=5 before / 5 with skill
Before 5/5 · Wilson 95% CI 0.566–1.000; with skill 5/5 · Wilson 95% CI 0.566–1.000

3 more actions not benchmarked yet

maintainer-run, not independent · claude-haiku-5-5 · 2026-10-22. Every failure is counted (intention-to-treat).

No clean demo yet. Recordings will start on HOME and show the app launching.

contacts

Demo shows: create_contact (name=Grace Hopper, phone=+1 555 0199)

Ghost in the Droid seed skill for Google Contacts (com.google.android.contacts). Works without a Google account, on local device contacts.

ActionWhat it doesParams
create_contactCreate a local contact (insert form, then Save)name (required), phone, email (optional, default empty)
search_contactsNames matching a queryquery
get_contact_detailsPhones and emails of the first matchquery
list_contactsUnique names collected over at most 10 list scansnone

Install

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/contacts

Use

ghost skill run ghost/contacts create_contact --param "name=Ada Lovelace" --param phone=+15551234567 --device emulator-5554
ghost skill run ghost/contacts get_contact_details --param query=Ada --device emulator-5554

From any MCP agent:

run_skill(name="ghost/contacts", action="get_contact_details", params={"query": "Ada"})
# {"contact": {"name": "Ada Lovelace", "phones": [{"type": "Mobile", "number": "+1 555-123-4567"}], "emails": [...]}}

Tested on

Android 14 emulator (google_apis x86_64, 1080x2400, 420 dpi), Contacts 4.8.17, en-US. Signed self-runs live in runs/.

Notes

The first launch shows a Google sign-in screen and a notification prompt; the skill skips and denies them. create_contact does not deduplicate. The tested setup has no signed-in account; local contact creation changes device state. Account sync behavior on a signed-in device is outside that setup. License: MIT.

Known failure modes and versions tested

Versions tested

App versionAndroidDeviceSkill versionSigned self-runs (pass/total)Dates
4.8.17.52925902314Google/sdk_gphone64_x86_64 (emulator, 1080x2400, 420 dpi, en-US)1.0.012/122026-10-05

Untested so far: physical devices, other OEM skins, other screen sizes, other locales.

Historical self-run artifacts are retained in runs/, but the current registry rejects the pre-digest evidence as unbound-helper. These old counts do not establish current-version passing coverage; fresh digest-bound signed runs are pending.

Recorded failures

None in the signed self-runs.

Popups and first-run screens handled

  • First-run Google sign-in prompt
  • Notification permission prompt

Other known failure modes

  • With a Google account signed in, the list shows several account sections; names still come from id/cliv_name_textview.
  • Other locales change Call/Email prefixes in row descriptions.

Compatibility and validation

The manifest targets Android >=14, Contacts >=4.1.17, 1080x2400 at 420 dpi, en-US. create_contact checks the visible name and independently queries ContactsProvider for the saved name, phone and email on one contact ID. Search/details/list compare returned results against fresh provider rows; search and details also reread the UI. Empty search/list results pass only if no provider rows match. Denied provider access fails validation.

  • get_contact_details fails if no result matches. Search supports normalized phone fragments as well as name substrings. Untyped phone descriptions retain the full number.
  • List collection is capped at 10 scans and deduplicates names, so it is not a complete count of distinct contact records.

Try a sample prompt or run an action by name. Replace any parameters in braces with your own values.

create_contact

no demo yet

Try asking

  • Add Ada Lovelace to my contacts with number +1 555 123 4567
  • save Grace Hopper's number 555 0100
  • create a contact for Alan Turing with email alan@example.com
  • new contact Linus, phone +44 20 7946 0000
ghost skill run ghost/contacts create_contact

search_contacts

no demo yet

Try asking

  • Find Ada in my contacts
  • do I have a contact called Grace
  • search contacts for Turing
  • look up Lovelace
ghost skill run ghost/contacts search_contacts

get_contact_details

no demo yet

Try asking

  • What is Ada Lovelace's phone number?
  • get Grace Hopper's email
  • show contact info for Alan
  • what number do I have for Linus
ghost skill run ghost/contacts get_contact_details

list_contacts

no demo yet

Try asking

  • List all my contacts
  • who is in my address book
  • how many contacts do I have
  • show every contact
ghost skill run ghost/contacts list_contacts
Benchmark details

Ghost-native before/after

maintainer-run, not independent
Model: claude-haiku-5-5 · Date: 2026-10-22

Same task across three arms. Skill replay runs without a model. Medians include every valid episode, including failures.

Contacts: create Ada Lovelace

N=5 seeds · 2026-10-22

Arm / provenancePass a/b · Wilson 95% CITokens, median [q1–q3]LLM calls, medianUI actions, medianWall, median
Agent aloneclaude-haiku-5-5 · 2026-10-22
Skill 1.0.0 · SHA b37d4c36
5/5 · Wilson 95% CI 0.566–1.000889,687[743,265–896,962]131075 s
Skill replayno model · 2026-10-22
Skill 1.0.0 · SHA b37d4c36
5/5 · Wilson 95% CI 0.566–1.0000[0–0]0633 s
Agent + skillclaude-haiku-5-5 · 2026-10-22
Skill 1.0.0 · SHA b37d4c36
5/5 · Wilson 95% CI 0.566–1.000367,882[318,140–466,520]8284 s

Agent + skill vs agent alone: 5 paired seeds; 0 fail → pass, 0 pass → fail; McNemar exact p = 1. Median tokens saved: 343,499.

Skill replay vs agent alone: 5 paired seeds; 0 fail → pass, 0 pass → fail; McNemar exact p = 1. Median tokens saved: 889,687.

Episodes (15)
TaskArmSeedModelPassLLM callsTokensUI actionsWallTrace
Contacts: create Ada LovelaceAgent + skill0claude-haiku-5-52026-10-22 · Skill 1.0.0 · SHA b37d4c36pass8553k182 s
Contacts: create Ada LovelaceSkill replay0replay2026-10-22 · Skill 1.0.0 · SHA b37d4c36pass00633 s
Contacts: create Ada LovelaceAgent alone0claude-haiku-5-52026-10-22 · Skill 1.0.0 · SHA b37d4c36pass13897k1066 s
Contacts: create Ada LovelaceAgent + skill1claude-haiku-5-52026-10-22 · Skill 1.0.0 · SHA b37d4c36pass8314k284 s
Contacts: create Ada LovelaceSkill replay1replay2026-10-22 · Skill 1.0.0 · SHA b37d4c36pass00632 s
Contacts: create Ada LovelaceAgent alone1claude-haiku-5-52026-10-22 · Skill 1.0.0 · SHA b37d4c36pass231.41M451.8 min
Contacts: create Ada LovelaceAgent + skill2claude-haiku-5-52026-10-22 · Skill 1.0.0 · SHA b37d4c36pass9368k279 s
Contacts: create Ada LovelaceSkill replay2replay2026-10-22 · Skill 1.0.0 · SHA b37d4c36pass00634 s
Contacts: create Ada LovelaceAgent alone2claude-haiku-5-52026-10-22 · Skill 1.0.0 · SHA b37d4c36pass11402k1062 s
Contacts: create Ada LovelaceAgent + skill3claude-haiku-5-52026-10-22 · Skill 1.0.0 · SHA b37d4c36pass11467k286 s
Contacts: create Ada LovelaceSkill replay3replay2026-10-22 · Skill 1.0.0 · SHA b37d4c36pass00632 s
Contacts: create Ada LovelaceAgent alone3claude-haiku-5-52026-10-22 · Skill 1.0.0 · SHA b37d4c36pass15743k1075 s
Contacts: create Ada LovelaceAgent + skill4claude-haiku-5-52026-10-22 · Skill 1.0.0 · SHA b37d4c36pass8318k188 s
Contacts: create Ada LovelaceSkill replay4replay2026-10-22 · Skill 1.0.0 · SHA b37d4c36pass00634 s
Contacts: create Ada LovelaceAgent alone4claude-haiku-5-52026-10-22 · Skill 1.0.0 · SHA b37d4c36pass12890k102.3 min

Display only: points come from signed run artifacts.