ghost/settings

Android Settings: privacy-bounded native model/build, battery, storage totals and Wi-Fi yes/no reads; switch dark theme.

Runs 23× fewer tokens Score 33/100 Official hard skill python storagenetwork

Token savings

96% fewer tokens
Tokenswithout490,271with20,925 (96% fewer)
Timewithout23.1 swith17.1 s (26% less time)
Tool callswithout10with3 (70% fewer)

Task check: passed without the skill, passed with it.

One recorded run each way on set_dark_theme, claude-haiku-5-5, same phone and same prompt. Watch it in the Before / after tab.

Recorded: get_device_info · live agent session on a real phone

Control Settings on Android with an AI agent

Settings 1.1.0 reads native aggregates and can change the system theme. It requires no account.

ActionResultParameters
get_device_infoModel, Android version, build numbernone
get_battery_statusBattery level percent, charging booleannone
get_storage_usageTotal, used and free /data storage, in KiBnone
get_wifi_statusEnabled and connected booleansnone
set_dark_themeRequested theme and native state readbackenabled boolean

Behavior change in 1.1.0

The four read actions now use privacy-bounded native aggregates by default. The previous About-phone, battery, storage-category and Wi-Fi-list UI paths have been removed entirely; there is no flag to restore them. These actions neither open those pages nor read their accessibility trees. Device names, serials, IMEI, phone numbers, SSID/BSSID, IP addresses, nearby networks and per-app/category storage lists are excluded. Consumers must use the result fields above instead of the removed fields.

Device information uses only ro.product.model, ro.build.version.release and ro.build.display.id. Battery uses filtered dumpsys battery; storage uses numeric df -k /data totals. Wi-Fi filters cmd wifi status on the device before ADB returns output, exposing only booleans. Unsupported or incomplete native output fails explicitly rather than inventing a value. Charging means the platform reports actively charging; a full battery is not actively charging. Storage covers the data filesystem, rather than an advertised device capacity or a per-volume inventory.

The theme action opens Display, applies cmd uimode night yes/no and reads it back. Automatic, custom and unreadable night-mode states are refused before any change, preserving existing schedules. A temporary caller should restore the original fixed theme afterward. Settings data is never cleared.

Use

ghost skill run ghost/settings get_battery_status --device YOUR_DEVICE
ghost skill run ghost/settings set_dark_theme --param enabled=true --device YOUR_DEVICE

Verification scope and limits

The current scope is Android 16 on Samsung SM-A156B, 1080×2340, 450 dpi, en-US. Other OS/OEM combinations need live verification. The read actions depend on the documented native output formats and shell permission; unknown Wi-Fi state fails closed. Theme navigation still depends on the English Display heading.

Current signed artifacts in runs/ are maintainer self-runs made with the canonical local signing key using actual ghost skill run --record, after final file edits. They are not independent verification. Historical artifacts that no longer match the files have been removed. This version requires three successful runs per action before claiming Runs tier.

License: MIT.

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

get_device_info

Play demo

Try asking

  • What Android version is this phone running?
  • which phone model is this
  • tell me the build number
  • read the Android version
ghost skill run ghost/settings get_device_info

get_battery_status

Play demo

Try asking

  • How much battery do I have left?
  • what is my battery percentage
  • is the battery charging
  • check the phone charge level
ghost skill run ghost/settings get_battery_status

get_storage_usage

Play demo

Try asking

  • How much storage is free on my phone?
  • how full is my storage
  • read storage totals
  • show total free space
ghost skill run ghost/settings get_storage_usage

get_wifi_status

Play demo

Try asking

  • Is Wi-Fi enabled and connected?
  • am I connected to wifi
  • is wifi on
  • check wifi connection status
ghost skill run ghost/settings get_wifi_status

set_dark_theme

Play demo

Try asking

  • Turn on dark mode
  • switch to light theme
  • enable night mode
  • turn dark theme off
ghost skill run ghost/settings set_dark_theme