optometry-ops

v1.0.0 MIT health updated 2026-09-27

Reads a patient CSV (name, last exam date, recall interval in months) and prints who is due or overdue for an eye exam, sorted by days overdue so the call list writes itself. Use to run weekly recall campaigns. Ships with a frame-board margin basics playbook in references/.

$ skillbank install optometry-ops@1.0.0
# pins exactly 1.0.0 · README + changelog included

Optometry Ops

Overview

Recall is the cheapest revenue in optometry: patients who already trust you, just overdue for their exam. This skill takes a simple CSV of patients — name, last exam date, recall interval in months — and prints an OVERDUE list sorted by days overdue (worst first) followed by a DUE SOON list. Run it weekly, work the top of the list, and the call campaign prioritizes itself.

Installation

1. Copy the optometry-ops/ directory anywhere convenient. 2. Make the script executable (Unix):


   chmod +x scripts/recall.py

No pip install needed — standard library only.

Configuration

The patient CSV has three columns (header row required):


name,last_exam_date,interval_months
Elena Voss,2024-03-15,12
Marcus Hale,2025-01-10,12

| Column | Format | |--------------------|-------------------------------------------------| | name | Patient name (any text). | | last_exam_date | YYYY-MM-DD. | | interval_months | Positive integer (6 or 12 are the usual ones). |

Due dates use calendar-month arithmetic (Jan 31 + 1 month = Feb 28/29).

Inputs

scripts/recall.py --csv FILE [--as-of YYYY-MM-DD] [--soon-days N]

| Flag | Required | Description | |---------------|----------|----------------------------------------------------------| | --csv | yes | Path to the patient CSV. | | --as-of | no | Reference date (default: today). Useful for testing. | | --soon-days | no | Days ahead that counts as "due soon" (default: 30). |

Worked example


$ ./scripts/recall.py --csv examples/sample-recalls.csv --as-of 2026-09-27
recall list as of 2026-09-27 (5 overdue, 0 due soon)

== OVERDUE ==
 561 days overdue  Elena Voss  (last exam 2025-03-15 due)
 269 days overdue  Priya Nair  (last exam 2026-01-01 due)
 260 days overdue  Marcus Hale  (last exam 2026-01-10 due)
  26 days overdue  Tom Becker  (last exam 2026-09-01 due)
   7 days overdue  Dana Whitfield  (last exam 2026-09-20 due)

== DUE SOON (next 30 days) ==
(none)

Elena Voss is 561 days overdue — she goes at the top of the call list. Names in examples/sample-recalls.csv are fictional.

Not medical advice

This skill manages appointment scheduling data only. It makes no clinical judgments about who needs an exam — recall intervals come from your exam records, not from this tool.

Version history

Changelog

1.0.0 — 2026-09-27

  • Initial release: scripts/recall.py builds overdue / due-soon eye-exam
  • recall lists from a patient CSV, sorted by days overdue; plus the frame-board margin basics playbook in references/.

← back to catalog