---

name: freight-compliance-docs description: Generate freight documents (Bill of Lading, Rate Confirmation) and check carrier/broker compliance via FMCSA. Track insurance expiries and authority status. Use when a broker needs to generate a BOL or Rate Con, wants to verify carrier compliance, needs to check upcoming document expiries, or when booking a load. Triggered by phrases like "generate BOL", "generate rate con", "compliance check MC#", "upcoming expiries", or "document for load".

Freight Compliance & Documents

Generates BOLs and Rate Confirmations as PDFs. Checks carrier compliance via FMCSA and tracks insurance expiries.

Usage

Generate BOL

cd skills/freight-compliance-docs/scripts
python3 bol_generator.py --shipper "ABC Corp" --consignee "XYZ Inc" --origin "Dallas, TX" --dest "Chicago, IL"

Generate Rate Con

python3 rate_con_generator.py --carrier "XYZ Trucking" --mc 123456 --origin "Dallas, TX" --dest "Chicago, IL" --rate 3200

Check compliance

python3 compliance_checker.py --mc 123456
python3 compliance_checker.py --scan-all
python3 compliance_checker.py --expiry-alerts

Broker Text Commands

Command	Action
generate BOL [load ID]	Create BOL PDF
generate rate con [load ID]	Create Rate Con PDF
compliance check MC#[number]	Check carrier compliance
upcoming expiries	List expiring insurance

Example SMS Outputs

Doc generated:

📄 DOCS GENERATED - Load #12345
✅ BOL attached
✅ Rate Con attached
Carrier: XYZ Trucking (MC#123456) ✅ Compliant

Reply 'send carrier' to email docs

Compliance alert:

⚠️ COMPLIANCE ALERT
XYZ Logistics (MC#789012)
Insurance expires in 14 days

Do not book new loads until renewed

Integrations

This skill uses the following external services. See INTEGRATIONS.md for detailed setup instructions, API documentation links, and implementation guidance.

Service	Purpose	Section in INTEGRATIONS.md
FMCSA SAFER API	Carrier insurance verification	Skill 6: FMCSA SAFER
DocuSign/HelloSign	E-signatures (future)	Skill 6: DocuSign/HelloSign
Twilio	SMS compliance alerts	Shared Infrastructure: Twilio

Document Storage

• PDFs: ~/.freight-broker/documents/
• Naming: BOL-{timestamp}.pdf, RC-{timestamp}.pdf
• See INTEGRATIONS.md for complete integration architecture