branded-proposal-builder
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.pybuilds a self-contained, - Brand colors fall back to sane defaults when missing.
- All client text HTML-escaped; invalid JSON/missing files exit nonzero
print-ready HTML proposal (cover block, scope, pricing table with computed total, terms, signature block) from --brief + --brand JSON.
with a plain error message.