appliance-repair-ops
Build appliance-repair quotes from a diagnostic fee, parts cost with markup, and labor hours times rate — prints an itemized customer quote plus what the ticket actually earns you. Use when quoting in-home appliance repairs with parts on the ticket.
$ skillbank install appliance-repair-ops@1.0.0 # pins exactly 1.0.0 · README + changelog included
Appliance Repair Ops
Overview
Appliance-repair quotes have three parts that get muddled together: the trip/diagnostic, the parts, and the labor. Muddle them and you either undercharge for the part run or can't explain the number when the customer asks. This skill keeps the three as separate line items — diagnostic fee, parts cost × (1 + markup%), labor hours × rate — and prints a customer quote plus the gross the ticket earns you after your parts cost.
Everything runs on your own machine. The script does the arithmetic and prints results — nothing is uploaded anywhere.
Installation
1. Copy the appliance-repair-ops/ directory anywhere convenient. 2. Make the script executable (Unix):
chmod +x scripts/quote.py
No pip install needed — standard library only.
Configuration
There is no config file — every input is a command-line flag so each quote is explicit and auditable:
| Flag | Default | Meaning | |----------------|---------|-------------------------------------------------------| | --diagnostic | — | Diagnostic / trip fee (zero or positive). | | --parts | — | Parts cost to you, before markup (zero or positive). | | --markup | 40 | Parts markup percent. | | --hours | — | Estimated labor hours (positive). | | --rate | — | Your hourly labor rate (positive). |
The math: parts price = parts × (1 + markup/100); `labor = hours × rate; total = diagnostic + parts price + labor`. The diagnostic is a line item on every quote — if you waive it when the customer approves the repair, say so on the ticket rather than quietly eating it.
Inputs
| Command | Arguments | Returns | |------------|--------------------------------------------------------------------|--------------------------------| | quote.py | --diagnostic D --parts P [--markup M] --hours H --rate R | Itemized customer quote. |
Negative values and non-positive hours/rate stop the run with a clear message, not a traceback.
Worked example
A dishwasher control board: $89 diagnostic, the board costs you $145 with a 40% markup, 1.5 hours of labor at $95/hour.
$ ./scripts/quote.py --diagnostic 89 --parts 145 --markup 40 --hours 1.5 --rate 95
CUSTOMER QUOTE
Diagnostic fee $89.00
Parts $145.00 x (1 + 40%) $203.00
Labor 1.5 h x $95.00/h $142.50
TOTAL $434.50
Your cost: parts $145.00 + labor time; gross on this ticket $289.50.
Check by hand: parts $145.00 × 1.40 = $203.00; labor 1.5 × $95 = $142.50; $89.00 + $203.00 + $142.50 = $434.50. Gross on the ticket: $434.50 − $145.00 parts cost = $289.50 before your labor time.
Playbooks
- Phone triage guide — the questions to ask before you roll the truck, so the right part is on it.
Safety notes
This is a benign business tool. All job inputs stay on your machine; the script makes no network calls and never uploads anything. Quotes are yours to give — the calculator shows the arithmetic behind them. (Electrical and gas safety on the actual repair is in the triage guide.)
Version history
Changelog
1.0.0 — 2026-09-27
- Initial release:
scripts/quote.pybuilds appliance-repair quotes from references/phone-triage-guide.md: phone triage questions for repair calls.
a diagnostic fee, parts cost with markup % (default 40), and labor hours × rate — itemized customer quote plus gross on the ticket.