ghost/flashcards

Flash Deck (F-Droid): create decks and cards, list decks, review due cards and grade them (again, hard, good, easy). Offline, no account; the Gemini generators are never used.

Runs 17.1× fewer tokens Score 38/100 Official hard skill python

Token savings

94% fewer tokens
Tokenswithout1,761,635with102,984 (94% fewer)
Timewithout153 swith101 s (34% less time)
Tool callswithout61with10 (84% fewer)

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.

Recorded: add_deck · live agent session on a real phone

Control Flash Deck on Android with an AI agent — study flashcards

Control Flash Deck on Android with an AI agent. Make and study flashcards on your phone: an agent creates decks and cards, quizzes itself or you, and grades each card.

Target search phrase: AI agent makes flashcards on Android

Demo shows: add_deck (name=Spanish)

Ghost in the Droid seed skill for Flash Deck (m.co.rh.id.a_flash_deck), an offline flashcard app with spaced-repetition grading. Every control has a resource id, so decks, cards and the review session are fully readable and drivable. Offline, no account.

ActionWhat it doesParams
add_deckCreate a deckname
add_cardAdd a card to an existing deckdeck, question, answer
list_decksList decks with card countsnone
start_reviewOpen Study due and read the first cardnone
reveal_answerShow the answer of the current cardnone
gradeGrade the card again/hard/good/easy; returns the next cardrating
get_cardRead the card on screennone

Toolkit

An agent can drive the whole app with these; compose them.

RoleAction
Entryadd_deck, start_review
Primitivesadd_card, reveal_answer, grade
Read statelist_decks, get_card

Install

The app: F-Droid, or https://f-droid.org/packages/m.co.rh.id.a_flash_deck/. 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/flashcards

Use

ghost skill run ghost/flashcards add_deck --param name=Spanish --device <serial>
ghost skill run ghost/flashcards add_card --param deck=Spanish --param question=hola --param answer=hello --device <serial>
run_skill(name="ghost/flashcards", action="grade", params={"rating": "good"})
# {"result": {"rating": "good", "state": {"question": "gato", "progress": "2 / 2"}}}

Try asking: "Make a Spanish flashcard deck, add hola/hello and gato/cat, then study them."

Tested on

Real Samsung phone, Android 13 (720x1600, 300 dpi, en-GB), Flash Deck 64. License: MIT.

Known failure modes and versions tested

Versions tested

App versionAndroidDeviceSkill versionDates
6413Samsung real phone (720x1600, 300 dpi, en-GB)1.0.02026-11-02

Recorded failures

  • Cards typed with other characters (accents, emoji) are refused: adb text input is ASCII only.
  • Grading the last due card ends the session; get_card then reports in_review: false.
  • The first-run notifications prompt is dismissed with CANCEL, notifications stay off.

Popups and first-run screens handled

  • The notifications prompt is dismissed by go_home.

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

add_deck

Play demo

Try asking

  • Create a flashcard deck called Spanish
  • make a deck named French
  • new flashcard deck
ghost skill run ghost/flashcards add_deck

add_card

Play demo

Try asking

  • Add the card hola / hello to Spanish
  • add a flashcard to Spanish
  • new card in my deck
ghost skill run ghost/flashcards add_card

list_decks

Play demo

Try asking

  • Which flashcard decks do I have?
  • show my decks
  • how many cards in each deck
ghost skill run ghost/flashcards list_decks

start_review

Play demo

Try asking

  • Start studying my flashcards
  • study my due cards
  • quiz me with my flashcards
ghost skill run ghost/flashcards start_review

reveal_answer

Play demo

Try asking

  • Show the answer
  • flip the card
  • what is the answer
ghost skill run ghost/flashcards reveal_answer

grade

Play demo

Try asking

  • Grade this card good
  • mark it easy
  • I got it wrong, grade again
ghost skill run ghost/flashcards grade

get_card

Play demo

Try asking

  • What card am I on?
  • read the current flashcard
ghost skill run ghost/flashcards get_card