ghost/gpa-calculator

GPA Calculator (F-Droid): pick UG or MBA grading, add courses with credit and grade, read the semester GPA. Offline, no account.

Runs 12.7× fewer tokens Score 31/100 Official hard skill python

Token savings

92% fewer tokens
Tokenswithout532,053with41,801 (92% fewer)
Timewithout110 swith63.1 s (42% less time)
Tool callswithout29with5 (83% fewer)

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.

calculate no clean demo yet
Recorded: set_scheme · live agent session on a real phone

Control GPA Calculator on Android with an AI agent

Control GPA Calculator on Android with an AI agent. Calculate your GPA on your phone: an agent adds courses with credits and grades and reads the semester GPA.

Target search phrase: AI agent calculates GPA on Android

Demo shows: set_scheme (scheme=UG)

Ghost in the Droid seed skill for GPA Calculator (com.gpa.calculator.gpa_calculator), an offline GPA calculator. Courses, credits, grades and the result are all readable, so an agent can compute a semester GPA exactly as the app does. Offline, no account.

ActionWhat it doesParams
set_schemeChoose the grading scheme: UG or MBA.scheme
add_courseAdd a course: optional name, credit (1, 2, 3, 4 or 6) and grade (A to F); returns the form with the course rows.credit, grade, name
get_coursesRead the scheme, every course row and the total quality points.none
calculatePress Calculate and return the semester GPA (needs at least one complete course).none
clear_coursesRemove all courses (needs confirm=yes).confirm

Toolkit

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

RoleAction
Entryset_scheme
Primitivesadd_course, clear_courses
Read stateget_courses, calculate

Install

The app: F-Droid, or https://f-droid.org/packages/com.gpa.calculator.gpa_calculator/. 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/gpa-calculator

Use

ghost skill run ghost/gpa-calculator add_course --param credit=3 --param grade=A --device <serial>
ghost skill run ghost/gpa-calculator calculate --device <serial>
run_skill(name="ghost/gpa-calculator", action="calculate")
# {"result": {"gpa": "4.00", "courses": 1, "scheme": "UG"}}

Try asking: "Add a 3 credit A in Maths and a 4 credit B in Physics, then calculate my GPA."

Tested on

Real Samsung phone, Android 13 (720x1600, 300 dpi, en-GB), GPA Calculator 13. License: MIT.

Known failure modes and versions tested

Versions tested

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

Recorded failures

  • calculate needs at least one complete course (credit and grade chosen); otherwise it fails with a message.
  • Only the credit and grade values the app offers are accepted.
  • clear_courses is destructive and needs confirm=yes.

Popups and first-run screens handled

  • None.

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

set_scheme

Play demo

Try asking

  • Use the MBA grading scheme in the GPA calculator
  • switch to UG grading
  • use MBA grades
ghost skill run ghost/gpa-calculator set_scheme

add_course

Play demo

Try asking

  • Add a 3 credit course with grade A to the GPA calculator
  • add a course with credit 4 and grade B
  • new course, 2 credits, grade C+
ghost skill run ghost/gpa-calculator add_course

get_courses

Play demo

Try asking

  • Show the courses in the GPA calculator
  • what courses did I enter
  • list my courses
ghost skill run ghost/gpa-calculator get_courses

calculate

no demo yet

Try asking

  • Calculate my semester GPA
  • what is my GPA
  • calculate the GPA
ghost skill run ghost/gpa-calculator calculate

clear_courses

Play demo

Try asking

  • Clear all the courses in the GPA calculator
  • start over with the GPA calculator
ghost skill run ghost/gpa-calculator clear_courses