nail-salon-ops

v1.0.0 MIT beauty-wellness updated 2026-09-27

Get a nail salon's daily booking capacity from a services JSON list (service, minutes) plus tech count and open hours — per-tech-per-day and salon-per-day bookings for each service, with turnover time between appointments. Use when running a nail salon that needs to know how many gel manicures, pedicures, or full sets each tech can actually complete in a day before overbooking.

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

Nail Salon Ops

Overview

Overbooking a nail salon doesn't look like an empty chair — it looks like a full waiting room and walkouts. Nail Salon Ops reads your service menu (service name, minutes) and your staffing (techs, open hours, turnover between bookings) and prints a capacity table: how many of each service each tech can finish per day, and what the whole salon can do. Book to this, not to optimism.

Everything runs on your own machine. The script reads your JSON and prints the table — nothing is uploaded anywhere.

Installation

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


   chmod +x scripts/schedule.py

No pip install needed — standard library only.

Configuration

The services JSON is a list of objects:


[
  {"service": "Gel manicure", "minutes": 60},
  {"service": "Basic pedicure", "minutes": 45},
  {"service": "Full set acrylic", "minutes": 90}
]

Minutes should be the real average including polish and drying time, not the best case. Flags: --techs (required) is the number of techs, --hours (required) is open hours per day, --turnover-mins (default 10) is reset time between bookings.

Inputs

| Input | Required | Description | |------------------|----------|-------------------------------------------------| | services.json | yes | JSON list of {service, minutes} objects. | | --techs | yes | Number of nail techs. | | --hours | yes | Open hours per day. | | --turnover-mins| no | Reset minutes between bookings (default 10). |

Output: a per-service table with minutes, bookings per tech per day, and bookings for the whole salon per day, computed as floor(open hours × 60 / (minutes + turnover)).

Worked example


$ cat services.json
[
  {"service": "Gel manicure", "minutes": 60},
  {"service": "Basic pedicure", "minutes": 45},
  {"service": "Full set acrylic", "minutes": 90}
]

$ ./scripts/schedule.py services.json --techs 3 --hours 9
Daily capacity  (3 techs x 9 h/day, 10 min turnover)

Service                     Minutes  Per tech/day   Salon/day
-------------------------------------------------------------
Gel manicure                     60             7          21
Basic pedicure                   45             9          27
Full set acrylic                 90             5          15
-------------------------------------------------------------

Per tech/day = floor(open hours x 60 / (minutes + turnover)).

With 9 hours (540 minutes) and 10 minutes of turnover, one tech fits seven 60-minute gel manicures (7 × 70 = 490 ≤ 540), so three techs cap at 21 gel manicures a day. Full sets are the bottleneck: five per tech, fifteen for the salon.

Playbooks

Version history

Changelog

1.0.0 — 2026-09-27

Initial release.

← back to catalog