branded-proposal-builder

v1.0.0 MIT business updated 2026-09-27

Turn a JSON brief plus a brand kit into a styled, print-ready HTML proposal — cover block, scope of work, pricing table, terms, and signature block in one self-contained file. Use when you need a professional-looking proposal for a client job and want to print or email it as-is.

$ skillbank install branded-proposal-builder@1.0.0
# pins exactly 1.0.0 · README + changelog included

Branded Proposal Builder

Overview

You describe the job in a JSON brief, you drop your colors and business name in a brand file, and scripts/proposal.py hands you back one self-contained HTML file: a styled cover block, a scope-of-work section, a pricing table with a computed total, a numbered terms list, and a two-party signature block. Inline CSS, @media print rules so it prints cleanly from any browser, no external assets to lose track of. Standard library only.

Installation

1. Copy the branded-proposal-builder/ directory anywhere convenient. 2. Make the script executable (Unix):


   chmod +x scripts/proposal.py

No pip install needed — standard library only.

Configuration

Two JSON files. See references/brief-schema.md for the full field list.

brief.json — the job you are proposing:


{
  "title": "Backyard Renovation Proposal",
  "client": {"name": "Susan Whitfield", "contact": "susan.whitfield@example.com"},
  "date": "2026-10-01",
  "scope": [
    {"title": "Paver patio installation",
     "description": "Remove sod, grade 320 sq ft, install pavers."}
  ],
  "pricing": [
    {"description": "Paver patio installation", "amount": 2600}
  ],
  "terms": [
    "50% deposit due at signing; balance due on completion."
  ]
}

brand.json — your brand kit:


{
  "business_name": "GreenEdge Landscaping",
  "tagline": "Backyards built to last",
  "colors": {
    "primary": "#1e5631",
    "accent": "#8fce62",
    "text": "#222222",
    "muted": "#6b7c6f"
  }
}

Colors are optional — missing entries fall back to neutral defaults (primary #1a3c5e, accent #2e9e6b, text #222222, muted #666666), so the script still works with {"business_name": "My Co"} alone. Scope items may be plain strings or {"title", "description"} objects.

Inputs

scripts/proposal.py --brief <brief.json> --brand <brand.json> --out <proposal.html>

| Flag | Required | Description | |-----------|----------|----------------------------------------------------| | --brief | yes | Path to the brief JSON file. | | --brand | yes | Path to the brand JSON file. | | --out | yes | Path to write the HTML proposal to. |

The script validates that both input files exist and parse as JSON before doing any work; bad input exits nonzero with a plain-English message (no tracebacks). All client text is HTML-escaped, so stray < or & in your copy can't break the page.

Worked example


$ ./scripts/proposal.py \
    --brief references/sample-brief.json \
    --brand references/sample-brand.json \
    --out proposal.html
wrote proposal.html

$ grep -o '\$4,800.00' proposal.html
$4,800.00

The sample brief is a $4,800 landscaping proposal: 4 scope items (paver patio, raised beds, lighting, sod/mulch) and 3+1 pricing lines whose total renders as $4,800.00 in the pricing table. Open proposal.html in a browser, print or save-as-PDF — the cover block, scope section, pricing table, terms list, and signature block are all there, in your colors.

Safety notes

This skill is a local document generator: it reads two JSON files and writes one HTML file. It never uploads anything, never makes network calls, and never runs remote commands. The generated proposal is a static page — double-check the numbers yourself before sending it to a client.

Version history

1.0.0 — 2026-09-27

  • Initial release: scripts/proposal.py builds a self-contained,
  • print-ready HTML proposal (cover block, scope, pricing table with computed total, terms, signature block) from --brief + --brand JSON.

  • Brand colors fall back to sane defaults when missing.
  • All client text HTML-escaped; invalid JSON/missing files exit nonzero
  • with a plain error message.

← back to catalog