Generate a professional branded freight quote PDF for any load. Use this skill whenever someone asks for a freight quote, rate quote, shipping quote, or any quote to send to a customer or shipper — even if they just paste an email or say "quote this load." Also trigger on: "make a quote for", "send a quote to", "put together a quote", "need a PDF quote", "create a quote for [customer/load]", "quote this", or when load details are pasted with a dollar amount. This skill reads your brokerage config and produces a ready-to-send branded PDF every time. Never attempt to build the PDF from scratch without reading this skill first.
Produces a professional, branded freight quote PDF from any load input.
Reads broker info from config.json — one setup, every quote branded automatically.
Before generating, read the broker's config.json to get branding and contact info.
Look for it in the skill folder. If it doesn't exist, ask the user to set it up
by copying config.example.json → config.json and filling in their details.
Required fields from config:
broker_company, broker_mc, broker_addressbroker_email, broker_phone_office, broker_phone_mobile, broker_contact_namebrand_color_navy, brand_color_goldquote_prefix, default_valid_daysPull the following from the conversation. Ask only for fields that are missing and genuinely needed to produce a useful quote:
| Field | Required | Notes |
|---|---|---|
| Customer / Quoted To | Yes | Company name + contact name |
| Seller / Requested By | If applicable | Name, company, email, phone |
| Origin | Yes | City, State ZIP |
| Destination | Yes | City, State ZIP |
| Commodity | Yes | What is being shipped |
| Weight | Yes | In lbs |
| Dimensions | Yes | L x W x H |
| Service Type | Yes | Flatbed, Conestoga LTL, Heavy Haul, Reefer, Van, etc. |
| Quoted Rate | Yes | Dollar amount |
| Estimated Miles | Optional | Estimate if not given |
| Est. Transit | Optional | e.g. 3–5 Business Days |
| Equipment | Optional | Specific trailer type |
| Permit Class | Optional | Standard / Overweight / Over-Dimensional |
| Extra line items | Optional | Permits, escorts, etc. |
| Extra terms | Optional | Anything beyond the 8 standard terms |
Once you have all required fields, run the bundled script:
python skills/freight-quote/scripts/generate_quote.py '<JSON>' '<CONFIG_PATH>'
Pass the config file path as the second argument. The script outputs the PDF file path on success.
{
"quote_num": "FMQ-2026-0407",
"valid_days": 14,
"quoted_to": {
"company": "Customer Company Name",
"contact": "Contact Name",
"address": "123 Street, City, ST 00000",
"phone": "555-000-0000",
"seller_name": "Seller Name, Title",
"seller_company": "Seller Company",
"seller_email": "[email protected]",
"seller_phone": "555-000-0001"
},
"shipment": {
"origin": "City, ST ZIP",
"destination": "City, ST ZIP",
"est_miles": "~1,200 miles",
"service_type": "Conestoga LTL",
"commodity": "Industrial Machinery",
"equipment": "Conestoga Trailer",
"weight": "13,000 lbs",
"permit_class": "Standard",
"dimensions": "15' L x 4' W x 7' H",
"est_transit": "3–5 Business Days"
},
"line_items": [
{"description": "Freight Transportation", "notes": "Origin to Destination | ~1,200 miles", "amount": "Included"},
{"description": "Fuel Surcharge", "notes": "Included in flat rate", "amount": "Included"},
{"description": "Accessorial Charges", "notes": "None anticipated (see notes)", "amount": "—"}
],
"total_label": "TOTAL FLAT RATE",
"total_note": "All-inclusive | No hidden fees",
"total_amount": "$1,850.00",
"extra_terms": []
}
extra_terms is optional — add strings to append after the 8 standard terms.
After the script runs, call present_files with the output path.
Give a brief summary: lane, service type, quoted amount, valid through date.
FreightQuote_[CustomerSlug]_[ServiceSlug].pdf
e.g. FreightQuote_AcmeCorp_Flatbed.pdf