start_game
Play demoTry asking
- Start a pinball game
- play pinball
- launch a pinball ball
- start the pinball table
ghost skill run ghost/vector-pinball start_game Vector Pinball (F-Droid): pick a table, start a game, launch the ball, work the flippers, end the game, read high scores. 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.
52× fewer tokens, 3.9× 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 | 76.0 s | 1,531,860 | 30 | stopped early |
| With skill: find_skill, run_skill | 19.4 s | 29,424 | 4 | finished |
Prompt: Start a pinball game and hit both flippers a few times.
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 Vector Pinball on Android with an AI agent. Play pinball on your phone: an agent picks a table, launches the ball and works the flippers.
Target search phrase: AI agent plays pinball on Android
Demo shows: start_game (side=both, times=6)
Ghost in the Droid seed skill for Vector Pinball (
com.dozingcatsoftware.bouncy), a free vector-graphics pinball game from F-Droid that runs fully offline. Offline, no account.
| Action | What it does | Params |
|---|---|---|
start_game | Start a game on the chosen table and launch the ball | table_steps, unlimited_balls |
flip | Hit the left, right or both flippers N times | side, times |
end_game | End the running game and return to the main menu | none |
select_table | Step to the next/previous table on the main menu | steps |
get_status | Read state (menu, playing, paused), table label and high scores | none |
An agent can drive the whole app with these; compose them.
| Role | Action |
|---|---|
| Entry | start_game |
| Primitives | flip, select_table, end_game |
| Read state | get_status |
The app: F-Droid, or https://f-droid.org/packages/com.dozingcatsoftware.bouncy/. 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/vector-pinball
ghost skill run ghost/vector-pinball start_game --device <serial>
ghost skill run ghost/vector-pinball flip --param side=both --param times=6 --device <serial>
run_skill(name="ghost/vector-pinball", action="get_status")
# {"status": {"state": "playing"}}
Try asking: "Start a pinball game and hit both flippers a few times."
Real Samsung phone, Android 13 (720x1600, 300 dpi, en-GB), Vector Pinball 1.16.0. License: MIT.
| App version | Android | Device | Skill version | Dates |
|---|---|---|---|---|
| 1.16.0 | 13 | Samsung real phone (720x1600, 300 dpi, en-GB) | 1.0.0 | 2026-11-02 |
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.dozingcatsoftware.bouncy (Vector Pinball, GPL-3.0, version 1.16.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.
startGameButton, highScoreButton, preferencesButton, nextTableButton / previousTableButton, unlimitedBallsToggle, and while paused resumeGameButton / endGameButton. The pause icon sits at the top left of the header (scoreView).startGameButton visible = main menu, resumeGameButton = paused, neither (but scoreView) = a ball is in play.start_game(table_steps, unlimited_balls)Open the main menu (pausing/ending any running game), optionally step tables, tap START GAME, tap the table once to launch. Success: state is playing.
flip(side, times)Resume the game if paused, then tap the lower left/right half N times. Success: still playing (or the game ended).
end_game()Pause (header icon), tap END GAME. Success: the main menu shows.
select_table(steps)Tap the table arrows steps times. The table label stays 'Select Table' (the name is part of the canvas).
get_status()Classifies the screen by widget ids; from the menu or pause screen it opens High Scores, reads the lines and closes it.
Other pinball or arcade apps use the same touch halves for flippers; classify the screen by widget ids and re-find the pause icon position.
Try a sample prompt or run an action by name. Replace any parameters in braces with your own values.
start_gameTry asking
ghost skill run ghost/vector-pinball start_game flipTry asking
ghost skill run ghost/vector-pinball flip end_gameTry asking
ghost skill run ghost/vector-pinball end_game select_tableTry asking
ghost skill run ghost/vector-pinball select_table get_statusTry asking
ghost skill run ghost/vector-pinball get_status 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.16.0 | pending | 18.6 KB | untagged |