pet-care-ops
Generate vaccination reminders from a pet CSV (pet, owner, last vaccine date, interval) — prints due and overdue reminders sorted by days overdue, each with a ready-to-send owner message. Use when running a grooming salon, doggie daycare, or boarding business that needs to remind owners vaccines are due. Pairs with booking confirmation and reminder text templates plus a reminder-cadence playbook (3 days before, day-of).
$ skillbank install pet-care-ops@1.0.0 # pins exactly 1.0.0 · README + changelog included
Pet Care Ops
Overview
Boarding and grooming businesses live or die on keeping pets current on vaccinations — and on reminding owners before the shot lapses. Pet Care Ops takes a simple CSV of your pets and produces a sorted reminder list: overdue first (most overdue at the top), then pets due within your warning window, each with a ready-to-send text message for the owner. Month math handles year rollover and end-of-month clamping correctly, so 2023-01-10 + 36 months lands on 2026-01-10 without surprises. The playbook in references/booking-templates.md covers the rest of the revenue cycle: booking confirmations, the 3-day / 1-day / day-of reminder cadence that cuts no-shows, and a no-show policy you can put on your booking page.
Installation
1. Copy the pet-care-ops/ directory anywhere convenient. 2. Make the script executable (Unix):
chmod +x scripts/vax.py
No pip install needed — standard library only.
Configuration
No config file. Your pet list is a CSV with this header row (exact column names):
pet,owner,last_vaccine_date,vaccine,interval_months
last_vaccine_dateis ISO:YYYY-MM-DD.interval_monthsis a whole number (12 for annual, 36 for 3-year rabies).- Rows with other columns are ignored; missing required columns are an
error with the column name printed.
Optional flags:
| Flag | Default | Description | |------|---------|-------------| | --today YYYY-MM-DD | actual today | Pretend "today" is this date — for reproducible reports and testing | | --due-within DAYS | 30 | Also flag pets due within this many days |
Inputs
| Command | Arguments | Returns | |---------|-----------|---------| | vax.py | pets.csv [--today YYYY-MM-DD] [--due-within DAYS] | Overdue + due-soon reminders, most overdue first, each with an owner message |
Exit 0 on success (even when reminders are found). Missing file, bad CSV, bad dates, or a non-positive interval prints a clear message to stderr and exits nonzero — never a traceback.
Worked example
Sample input, pets.csv:
pet,owner,last_vaccine_date,vaccine,interval_months
Max,Dana Reyes,2023-01-10,Rabies,36
Bella,Chris Pruitt,2025-10-15,Distemper,12
Coco,Amir Khan,2024-06-01,Rabies,36
Rex,Jordan Lee,2026-08-20,Bordetella,12
Whiskers,Sam Ortiz,2024-09-15,FVRCP,24
(--today 2026-09-27 is passed so the output below is reproducible; drop it to use the real date.)
$ ./scripts/vax.py pets.csv --today 2026-09-27
VACCINATION REMINDERS (as of 2026-09-27)
============================================================
OVERDUE — 260 day(s) overdue: Max (owner: Dana Reyes)
Vaccine: Rabies (36 mo) — last given 2023-01-10, due 2026-01-10
Message: "Hi Dana Reyes! Quick reminder that Max was due for Rabies on 2026-01-10. Reply to book a slot."
------------------------------------------------------------
OVERDUE — 12 day(s) overdue: Whiskers (owner: Sam Ortiz)
Vaccine: FVRCP (24 mo) — last given 2024-09-15, due 2026-09-15
Message: "Hi Sam Ortiz! Quick reminder that Whiskers was due for FVRCP on 2026-09-15. Reply to book a slot."
------------------------------------------------------------
DUE SOON — in 18 day(s): Bella (owner: Chris Pruitt)
Vaccine: Distemper (12 mo) — last given 2025-10-15, due 2026-10-15
Message: "Hi Chris Pruitt! Quick reminder that Bella was due for Distemper on 2026-10-15. Reply to book a slot."
------------------------------------------------------------
summary: 3 reminder(s) from 5 pet(s)
Hand-check on Max: 2023-01-10 + 36 months = 2026-01-10; 2026-01-10 to 2026-09-27 is 260 days. Coco (due 2027-06-01) and Rex (due 2027-08-20) are correctly omitted.
Safety notes
These are benign business tools. vax.py only reads your CSV and prints to the terminal — it never sends messages itself and never uploads anything. Your client and pet data stays on your machine.
Version history
1.0.0 — 2026-09-27
- Initial release: scripts/vax.py vaccination reminder generator from pet CSV (due/overdue sorted by days overdue, owner-ready messages); references/booking-templates.md with booking confirmation, reminder cadence, and no-show policy.
- Zero-dependency Python 3 scripts (stdlib only), MIT license.