dental-practice-ops

v1.0.0 MIT business updated 2026-09-27

Build a hygiene recall call list from a patient CSV — reads name, last hygiene visit, and recall interval, then prints who is due or overdue sorted by days overdue. Use when a dental office needs its weekly recall list or wants to feed the case-acceptance follow-up playbook.

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

Dental Practice Ops

Overview

Empty hygiene chairs are the most expensive problem in a dental office, and they are usually a paperwork problem: nobody worked the recall list. This skill reads your patient CSV and prints a due/overdue recall list sorted by days overdue, so the front desk knows exactly who to call first on Monday morning. Month arithmetic is calendar-safe — adding 6 months to January 31 lands on July 31, and to August 31 lands on February 28/29, not March.

Pair the list with the case-acceptance playbook in references/case-acceptance-playbook.md: the 48-hour call for unscheduled treatment plans, the 2-week check, and how to mention financing without discounting your fees.

Installation

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


   chmod +x scripts/recall.py

No pip install needed — standard library only.

Configuration

The script reads a plain CSV with exactly these columns:


name,last_hygiene_visit,recall_interval_months
Ana Ruiz,2026-01-15,6

| Column | Format | |------------------------|---------------------------------------------| | name | Patient name, non-empty. | | last_hygiene_visit | ISO date YYYY-MM-DD of the last hygiene visit. | | recall_interval_months | Whole positive number of months (usually 6 or 12). |

Pass --today YYYY-MM-DD to run the list as of a specific date (useful for testing or backfilling); otherwise it uses the real date.

Inputs

| Command | Arguments | Returns | |----------------------------------------|---------------------------------|------------------------------------------| | recall.py | --csv <file> [--today <date>] | Due/overdue patients sorted by days overdue. |

A patient is due when today ≥ last visit + interval months. Bad dates or intervals print a clear error to stderr and exit nonzero — never a traceback. No arguments prints usage to stderr and exits 2.

Worked example


$ ./scripts/recall.py --csv patients.csv --today 2026-09-27
Recall list as of 2026-09-27 — 3 patient(s) due or overdue
Patient                 Last visit    Due date      Days overdue
----------------------------------------------------------------
Ana Ruiz                2026-01-15    2026-07-15              74
Dan Ellis               2025-08-30    2026-08-30              28
Ben Cole                2026-03-10    2026-09-10              17

Tested with a 5-patient CSV: 3 came out overdue (74, 28, and 17 days), 2 were not yet due and correctly excluded. Month-end clamping verified: add_months(2025-08-31, 6) → 2026-02-28, and year rollover verified: add_months(2025-12-15, 2) → 2026-02-15.

Safety notes

The script reads your patient CSV and prints to stdout — it never uploads, emails, or transmits anything. Patient names stay on your machine, which is where they belong. Treat the CSV like any other piece of PHI: keep it in a folder with proper access controls, and do not paste it into a public chatbot.

Version history

Changelog

1.0.0 — 2026-09-27

  • Initial public release.
  • scripts/recall.py: due/overdue hygiene recall list from a patient CSV, sorted by days overdue.
  • Calendar-safe month arithmetic (year rollover + month-end clamping, e.g. 2025-08-31 + 6 months → 2026-02-28).
  • references/case-acceptance-playbook.md: 48-hour call, 2-week check, financing mention, weekly routine.
  • Zero dependencies; tested against a 5-patient sample CSV plus bad-input cases.

← back to catalog