optometry-ops
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.pybuilds overdue / due-soon eye-exam
recall lists from a patient CSV, sorted by days overdue; plus the frame-board margin basics playbook in references/.