cleaning-service-ops

v1.0.0 MIT business updated 2026-09-27

Estimate residential cleaning prices from square footage, bedroom/bathroom counts, and clean type (standard, deep, move-out) using a documented public rate table — a per-sqft tier, per-room adders, and a type multiplier. Use when quoting house cleanings over the phone or by email and you want every quote to follow the same published rates. Includes room-by-room cleaning checklists for kitchen, bathrooms, bedrooms, and living areas.

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

Cleaning Service Ops

Overview

Quoting by gut feel means two customers with identical homes get different prices — and one of them will find out. Cleaning Service Ops prices every job from one public rate table: a per-square-foot tier, a flat adder per bedroom and bathroom, and a multiplier for the clean type. The table is printed in quote.py --help and below, and the script implements exactly that table — show the customer the table and the quote defends itself. The playbook in references/room-checklists.md is the crew-side companion: checklists for kitchen, bathrooms, bedrooms, and living areas, with the extra deep / move-out items marked, plus a final walkthrough list.

Installation

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


   chmod +x scripts/quote.py

No pip install needed — standard library only.

Configuration

No config file — the rate table *is* the configuration, and it is fixed so quotes stay consistent:

| Step | Rule | |------|------| | 1. Base | up to 999 sq ft → $0.16/sq ft; 1000–1999 → $0.13/sq ft; 2000+ → $0.11/sq ft | | 2. Adders | + $12 per bedroom, + $18 per bathroom (half-baths like 2.5 allowed) | | 3. Subtotal | base + bedroom adder + bathroom adder | | 4. Multiplier | standard ×1.0, deep ×1.6, move-out ×1.9 | | 5. Total | subtotal × multiplier, rounded to 2 decimals (half-up) |

Deep clean adds baseboards, inside oven/fridge, ceiling fans. Move-out adds everything in deep plus inside cabinets, walls, and garage.

Inputs

| Command | Arguments | Returns | |---------|-----------|---------| | quote.py | --sqft N --bedrooms N --bathrooms N --type {standard,deep,move-out} | Itemized price estimate with subtotal and total |

With no arguments (or invalid ones) the script prints usage to stderr and exits 2. Negative or unrealistic numbers (e.g. > 20,000 sq ft) print a clear message to stderr and exit 1 — never a traceback.

Worked example


$ ./scripts/quote.py --sqft 1500 --bedrooms 3 --bathrooms 2 --type deep
CLEANING QUOTE
============================================================
  1500 sq ft — 1000-1999 sq ft @ $0.13/sq ft             $195.00
  Bedrooms: 3 @ $12 each                                          $36.00
  Bathrooms: 2 @ $18 each                                        $36.00
------------------------------------------------------------
  Subtotal                                            $267.00
  Clean type: deep (x1.6)
  QUOTE TOTAL                                         $427.20

Hand-check: base 1500 × $0.13 = $195.00; adders 3 × $12 = $36.00 and 2 × $18 = $36.00; subtotal $267.00; deep multiplier ×1.6 = $427.20.

Safety notes

These are benign business tools. quote.py computes from the arguments you give it and prints to the terminal — it never uploads anything. Your quotes and customer details stay on your machine.

Version history

1.0.0 — 2026-09-27

  • Initial release: scripts/quote.py price estimator with documented public rate table (per-sqft tier + per-room adders + type multiplier); references/room-checklists.md for kitchen, bathrooms, bedrooms, living areas.
  • Zero-dependency Python 3 scripts (stdlib only), MIT license.

← back to catalog