open_puzzle
Play demoTry asking
- Open the Net puzzle
- play a logic puzzle
- open Light Up
- start Simon Tatham's Net
ghost skill run ghost/sgt-puzzles open_puzzle Simon Tatham's Puzzles (F-Droid): open a puzzle (Net by default), start a new game, rotate tiles, undo, show the solution, read the status line. Offline, no account.
Agent run: finished 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.
36× fewer tokens, 1.4× faster with the skill. Agent run: finished without the skill, finished with it (not independently checked).
| Run | Time | Tokens | Tool calls | Result |
|---|---|---|---|---|
| No skill: agent drives by hand | 49.9 s | 1,413,843 | 29 | finished |
| With skill: find_skill, run_skill | 34.7 s | 39,684 | 5 | finished |
Prompt: Open the Net puzzle, start a new game and solve it.
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 Simon Tatham's Puzzles on Android with an AI agent. Play and auto-solve logic puzzles on your phone: an agent opens Net, rotates tiles and reads the progress.
Target search phrase: AI agent solves logic puzzles on Android
Demo shows: open_puzzle (name=Net)
Ghost in the Droid seed skill for Simon Tatham's Puzzles (
name.boyle.chris.sgtpuzzles), Simon Tatham's collection of 40 logic puzzles from F-Droid (this skill plays Net and can open any other puzzle). Offline, no account.
| Action | What it does | Params |
|---|---|---|
open_puzzle | Open any puzzle from the list by name (default Net) | name |
new_game | Open Net and generate a fresh board (optionally a size/type) | type |
tap_tile | Rotate a tile of the running Net board | row, col, times, size |
undo_move | Take back the last rotation | none |
show_solution | Let the app auto-solve the puzzle | none |
get_state | Read screen, puzzle name, status, active/total tiles, solved | none |
An agent can drive the whole app with these; compose them.
| Role | Action |
|---|---|
| Entry | open_puzzle, new_game |
| Primitives | tap_tile, undo_move, show_solution |
| Read state | get_state |
The app: F-Droid, or https://f-droid.org/packages/name.boyle.chris.sgtpuzzles/. 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/sgt-puzzles
ghost skill run ghost/sgt-puzzles open_puzzle --param name=Net --device <serial>
ghost skill run ghost/sgt-puzzles show_solution --device <serial>
run_skill(name="ghost/sgt-puzzles", action="get_state")
# {"state": {"screen": "puzzle", "puzzle": "Net", "status": "Active: 7/25", "active": 7, "total": 25, "solved": false}}
Try asking: "Open the Net puzzle, start a new game and solve it."
Real Samsung phone, Android 13 (720x1600, 300 dpi, en-GB), Simon Tatham's Puzzles 2025-09-12 (build 149). License: MIT.
| App version | Android | Device | Skill version | Dates |
|---|---|---|---|---|
| 2025-09-12 (build 149) | 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: name.boyle.chris.sgtpuzzles (Simon Tatham's Puzzles, MIT, version 2025-09-12 (build 149) 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/text, "Net: Rotate tiles ..."); Settings, Load, Help in the toolbar.Game (id/game_menu: New game, Restart, Show solution, Load, Save, Share, Settings) and Type (id/type_menu: sizes/variants) menus, id/status_bar text, bottom bar with Undo/Redo (content-desc).Active: n/25 (tiles connected to the centre) and Auto-solved. after Show solution. The skill taps tiles by computed coordinates (5x5 board at x 10-710, y 410-1105 on a 720 px screen).open_puzzle(name)Back to the puzzle list, scroll until an entry starting with <name>: shows, tap it. Returns the puzzle state.
new_game(type)Game > New game, or Type > when type is given. Success: puzzle screen, not solved.
tap_tile(row, col, times, size)Tap the computed tile centre times times (row/col 1-based from top left, size defaults to 5). Returns the status before and after.
undo_move()Tap the Undo button; the Active count returns.
show_solution()Game > Show solution. Success: status Auto-solved.
get_state()Reads status_bar and the toolbar title. Returns state.
The other 39 puzzles share the menus and the status line; open_puzzle, new_game, undo_move, show_solution and get_state work for them. Only tap_tile is Net specific (square grid of tiles).
Try a sample prompt or run an action by name. Replace any parameters in braces with your own values.
open_puzzleTry asking
ghost skill run ghost/sgt-puzzles open_puzzle new_gameTry asking
ghost skill run ghost/sgt-puzzles new_game tap_tileTry asking
ghost skill run ghost/sgt-puzzles tap_tile undo_moveTry asking
ghost skill run ghost/sgt-puzzles undo_move show_solutionTry asking
ghost skill run ghost/sgt-puzzles show_solution get_stateTry asking
ghost skill run ghost/sgt-puzzles get_state 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 | >=2025 | pending | 20.4 KB | untagged |