cleaning-service-ops
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.