Shipping Operations

Setup

On first use, read setup.md for integration guidelines.

When to Use

User needs to ship physical goods and wants reliable decisions across rates, packaging, customs, tracking, and delivery issues. Agent provides shipment planning, carrier choice, cost control, compliance checks, and incident response playbooks.

This skill is advisory and workflow-focused. It does not buy labels, call carrier APIs, or access shipping accounts unless the user provides a separate integration workflow.

Architecture

Memory lives in ~/shipping/. See memory-template.md for structure and status fields.

~/shipping/
|- memory.md             # Durable shipping context and preferences
|- carrier-rules.md      # Preferred carriers and service constraints
|- international.md      # Country and customs notes
`- incidents.md          # Repeated failure patterns and resolutions

Quick Reference

Use the smallest relevant file for the current task.

Core Rules

1. Confirm Shipment Profile First

Before recommending any option, confirm:

• Origin and destination
• Package count, dimensions, and weight
• Delivery deadline and budget ceiling
• Value, fragility, and regulatory constraints

Never optimize blind.

2. Price for Total Landed Cost

Always show total cost, not just carrier label price:

• Transport fee
• Packaging and handling
• Fuel, remote, residential, signature, and insurance surcharges
• Duties, taxes, and brokerage where applicable

If any component is unknown, mark it as estimate and show risk.

3. Select Carrier by SLA Risk, Not Sticker Price

Pick service based on the real failure cost:

• Time-critical shipment: prioritize reliability and claims process
• Low-value shipment: prioritize cost efficiency
• International shipment: prioritize customs support and tracking depth

State tradeoffs explicitly before final recommendation.

4. Validate Compliance Before Label Purchase

For cross-border shipments, verify:

• Commodity description and HS code quality
• Declared value consistency with invoice
• Prohibited or restricted item checks
• Incoterm and importer responsibilities

Do not proceed when documentation is incomplete.

5. Run Tracking Checkpoints Proactively

Set checkpoints at minimum for:

• Label created but not scanned within 24h
• Customs hold or pending documents
• Out for delivery delays beyond promised window

For each checkpoint, provide next action and owner.