handyman-ops
Price handyman jobs from a task list — compares the pure-hourly total against a recommended flat price (hourly plus a 15% risk buffer, rounded to the nearest $5) so scope creep stops coming out of your pocket. Use when quoting multi-task repair and fix-it jobs.
$ skillbank install handyman-ops@1.0.0 # pins exactly 1.0.0 · README + changelog included
Handyman Ops
Overview
Hourly handyman billing has a quiet failure mode: every "simple" job hides a second coat, a stripped screw, or a customer who adds "one more little thing" while you're there — and hourly billing makes you eat all of it while punishing you for working fast. Handyman Ops takes your task list with estimated hours and shows both numbers side by side: the pure-hourly total, and a recommended flat price (hourly × 1.15, rounded to the nearest $5) that prices the risk into the job instead of your evening.
Everything runs on your own machine. The script reads a JSON task list and prints the comparison — nothing is uploaded anywhere.
Installation
1. Copy the handyman-ops/ directory anywhere convenient. 2. Make the script executable (Unix):
chmod +x scripts/price.py
No pip install needed — standard library only.
Configuration
There is no config file — the two inputs are the task list and your rate:
| Input | Meaning | |----------------|----------------------------------------------------------------| | tasks_json | JSON file: array of {"task": "...", "hours": 1.5} objects. | | --rate | Your hourly rate (must be positive). |
The flat formula: flat = round((total_hours × rate × 1.15) / 5) × 5 — the 15% is a risk buffer for scope creep, rounded to the nearest $5 so the number you say out loud sounds like a real quote. Malformed JSON, missing task names, or non-positive hours stop the run with a clear message naming the offending item.
Inputs
| Command | Arguments | Returns | |------------|------------------------------|----------------------------------------------| | price.py | <tasks.json> --rate R | Hourly total vs recommended flat price. |
Worked example
tasks.json (the exact file this output was tested against):
[
{"task": "Patch drywall", "hours": 2.5},
{"task": "Replace door handle", "hours": 1.0},
{"task": "Caulk bathroom", "hours": 1.5}
]
$ ./scripts/price.py tasks.json --rate 75
Patch drywall 2.50 h
Replace door handle 1.00 h
Caulk bathroom 1.50 h
Total hours 5.00 h @ $75.00/h
Pure-hourly total: $375.00
Recommended flat: $430.00 (hourly x 1.15 = $431.25, rounded to nearest $5)
Give the customer the flat price. The buffer is yours to keep when the job runs clean.
Check by hand: 5.0 h × $75 = $375.00 hourly; $375.00 × 1.15 = $431.25, rounded to the nearest $5 → $430.00. Quote $430 flat. If the job runs clean, the $55 buffer is your reward for estimating well; if the drywall needs a second coat, you're covered.
Playbooks
- Job scoping guide — how to walk a job and estimate hours that survive contact with reality.
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.
Version history
Changelog
1.0.0 — 2026-09-27
- Initial release:
scripts/price.pyprices handyman jobs from a task-list references/job-scoping-guide.md: job scoping and hour-estimation guide.
JSON ({"task", "hours"} per task) and an hourly rate — compares the pure-hourly total against a recommended flat price (hourly + 15% risk buffer, rounded to the nearest $5).