bike-shop-ops
Build repair ticket quotes from a JSON repair menu — each job's labor minutes and parts cost combined with your shop's hourly labor rate into parts and labor line items with subtotals and a grand total. Use when quoting bike repairs at the service counter.
$ skillbank install bike-shop-ops@1.0.0 # pins exactly 1.0.0 · README + changelog included
Bike Shop Ops
Overview
Quoting repairs off the top of your head is how you underprice the job. This skill reads your repair menu — each job with its labor minutes and parts cost — and your shop's hourly labor rate, then builds a service ticket quote with parts and labor line items, subtotals, and a grand total. Quote one job, several, or the whole menu. Useful at the service counter: consistent quotes, every time, with the math printed for the customer.
Installation
1. Copy the bike-shop-ops/ directory anywhere convenient. 2. Make the script executable (Unix):
chmod +x scripts/service.py
No pip install needed — standard library only. All data stays local — nothing is uploaded.
Configuration
Input file: a repair menu JSON passed with --menu (a starter is bundled at samples/repair-menu.json). Either an object with a jobs list or a bare list:
{
"jobs": [
{"job": "Basic tune-up", "labor_minutes": 45, "parts_cost": 25.00},
{"job": "Brake bleed (hydraulic)", "labor_minutes": 30, "parts_cost": 12.50},
{"job": "Wheel truing", "labor_minutes": 20, "parts_cost": 0.00}
]
}
| Field | Required | Description | |-----------------|----------|----------------------------------------------------------| | job | yes | Job name, unique within the menu. | | labor_minutes | yes | Hands-on time in minutes (non-negative). | | parts_cost | yes | Parts cost in dollars (non-negative). |
The labor rate is passed per quote with --rate (dollars per hour), so the same menu works if you change the rate next season.
Inputs
| Command | Arguments | Returns | |--------------------------------------------------------------|--------------------------------------------------------|------------------------------------------------------| | service.py --menu <json> --rate R [--job NAME ...] | Menu JSON (required), labor $/hr (required), jobs to include | Parts + labor line items, subtotals, quote total. |
Repeat --job for each job on the ticket; omit it to quote every job on the menu. Labor is prorated by the minute. Bad input (missing file, invalid JSON, unknown job name, non-positive rate) exits nonzero with a plain-English error — never a traceback.
Worked example
$ ./scripts/service.py --menu samples/repair-menu.json --rate 95 \
--job "Basic tune-up" --job "Brake bleed (hydraulic)"
Service ticket — labor rate $95.00/hr
Job Labor Parts Line total
--------------------------------------------------------------------
Basic tune-up $ 71.25 $ 25.00 $ 96.25
Brake bleed (hydraulic) $ 47.50 $ 12.50 $ 60.00
--------------------------------------------------------------------
Parts subtotal $ 37.50
Labor subtotal $ 118.75
Quote total $ 156.25
$ ./scripts/service.py --menu samples/repair-menu.json --rate 95
# quotes all four jobs on the menu
Hand the customer the line items, not just the total — it sells the labor.
Version history
Changelog
1.0.0 — 2026-09-27
- Initial release. Service ticket quote builder (scripts/service.py) with sample repair menu JSON.