landscaping-ops

v1.0.0 MIT business updated 2026-09-27

Turn a bid JSON (materials list, labor hours, hourly rate, overhead %, margin %) into a customer-facing quote with line items and total, plus a private internal cost breakdown. Use when pricing landscaping jobs and you need the same documented markup math on every bid. Includes a seasonal upsell calendar playbook (spring cleanup through winter holiday lights) for selling to the same customer five times a year.

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

Landscaping Ops

Overview

Guessing at prices is how landscaping jobs lose money. Landscaping Ops takes a bid JSON — materials with costs, labor hours and rate, overhead percent, margin percent — and prints two things: a clean customer quote with line items and a total, and an internal cost breakdown showing exactly where the margin came from. The pricing formula is documented in the script's --help, in this file, and in the worked example, so you can check any quote by hand in ten seconds. Margin is applied as a markup on total cost (see Inputs). The playbook in references/seasonal-upsell-calendar.md covers the sales side: what to pitch each month, when to send it, and how to bundle seasonal work into monthly plans.

Installation

1. Copy the landscaping-ops/ directory anywhere convenient. 2. Make the script executable (Unix):


   chmod +x scripts/bid.py

No pip install needed — standard library only.

Configuration

No config file. Each job is a bid JSON file:


{
  "materials": [
    {"item": "Premium mulch (10 yd)", "cost": 450.00},
    {"item": "Paver stones (60 pcs)", "cost": 240.00}
  ],
  "labor_hours": 12,
  "hourly_rate": 65.00,
  "overhead_pct": 10,
  "margin_pct": 25
}

All numbers must be >= 0. materials may be empty (labor-only jobs). Money is rounded to 2 decimals (half-up) on each printed line.

Inputs

| Command | Arguments | Returns | |---------|-----------|---------| | bid.py | bid.json | Customer quote (line items + total) and internal cost breakdown |

The math, exactly as implemented:


direct_cost = sum(material costs) + labor_hours * hourly_rate
cost        = direct_cost * (1 + overhead_pct / 100)
quote_total = cost * (1 + margin_pct / 100)     # margin = markup on cost

Exit 0 on success. Missing file, invalid JSON, or negative numbers prints a clear message to stderr and exits nonzero — never a traceback.

Worked example

Sample input, bid.json:


{
  "materials": [
    {"item": "Premium mulch (10 yd)", "cost": 450.00},
    {"item": "Paver stones (60 pcs)", "cost": 240.00},
    {"item": "Edging + fabric", "cost": 160.00}
  ],
  "labor_hours": 12,
  "hourly_rate": 65.00,
  "overhead_pct": 10,
  "margin_pct": 25
}

$ ./scripts/bid.py bid.json
CUSTOMER QUOTE
============================================================
Materials:
  Premium mulch (10 yd)                           $450.00
  Paver stones (60 pcs)                           $240.00
  Edging + fabric                                 $160.00
  Materials total                                 $850.00
Labor (12 h @ $65.00/h)
  Labor total                                     $780.00
------------------------------------------------------------
  QUOTE TOTAL                                   $2,241.25

INTERNAL COST BREAKDOWN (keep this to yourself)
============================================================
  Materials                                       $850.00
  Labor                                           $780.00
  Direct cost                                   $1,630.00
  Overhead (10%)                                  $163.00
  Cost                                          $1,793.00
  Margin (25%)                                    $448.25
------------------------------------------------------------
  QUOTE TOTAL                                   $2,241.25

Hand-check: materials $850 + labor 12 × $65 = $780 → direct $1,630; 10% overhead = $163 → cost $1,793; 25% margin = $448.25 → total $2,241.25. Send the customer the top half only.

Safety notes

These are benign business tools. bid.py reads your JSON and prints to the terminal — it never uploads anything. Your pricing and margins stay on your machine.

Version history

1.0.0 — 2026-09-27

  • Initial release: scripts/bid.py bid calculator from bid JSON (customer quote + internal cost breakdown with documented markup math); references/seasonal-upsell-calendar.md with monthly pitching schedule.
  • Zero-dependency Python 3 scripts (stdlib only), MIT license.

← back to catalog