locksmith-ops

v1.0.0 MIT trades updated 2026-09-27

Price locksmith jobs from service type (lockout, rekey, install), an after-hours flag, and one-way mileage — base price plus after-hours surcharge plus mileage with the first 15 miles free. Use when quoting residential and small-commercial lock work.

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

Locksmith Ops

Overview

Locksmith pricing has exactly three moving parts: what the job is, when it is, and how far the drive is. Mixing them into one gut-feel number is how 2 a.m. lockouts across town get quoted like Tuesday-afternoon rekeys. This skill keeps them separate — a base price per service type, a flat after-hours surcharge, and mileage with the first 15 one-way miles free — and prints the breakdown so the customer sees what they're paying for.

Everything runs on your own machine. The script does the arithmetic and prints results — nothing is uploaded anywhere.

Installation

1. Copy the locksmith-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 price model is defined at the top of the script so it is always visible next to the math:

| Component | Value | |----------------|--------------------------------------------------------------| | Base: lockout | $85 | | Base: rekey | $95 | | Base: install | $150 | | After-hours | +$50 flat (nights, weekends, holidays) | | Mileage | First 15 one-way miles free, then $2.50/mile |

Price = base + (after-hours ? $50 : $0) + max(0, miles − 15) × $2.50. Rekey is priced per job here — if the job covers many cylinders, price per cylinder separately and say so.

Inputs

| Command | Arguments | Returns | |------------|--------------------------------------------------|-----------------------| | price.py | --service S --miles M [--after-hours] | Priced job breakdown. |

--service is one of lockout, rekey, install. Mileage must be zero or positive; anything else stops the run with a clear message, not a traceback.

Worked example

A 2 a.m. lockout, 22 miles out (after-hours applies):


$ ./scripts/price.py --service lockout --miles 22 --after-hours
Service     lockout    $85.00
After-hours yes        $50.00
Mileage     22 one-way miles (first 15 free) = $17.50
PRICE       $152.50

Check by hand: $85.00 base + $50.00 after-hours + (22 − 15) × $2.50 = $17.50 mileage → $152.50. A daytime rekey 8 miles out is simply $95.00 — inside the free mileage band, no surcharge.

Playbooks

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.py prices locksmith jobs from service
  • type (lockout $85 / rekey $95 / install $150), an --after-hours flag (+$50), and one-way mileage (first 15 miles free, then $2.50/mile).

  • references/dispatch-checklist.md: verify-before-you-roll dispatch checklist.

← back to catalog