bike-shop-ops

v1.0.0 MIT retail updated 2026-09-27

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.

← back to catalog