landscaping-ops
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.