Agent skill · operations · affaan-m
logistics-exception-management
Codified freight-exception handling expertise for shipment delays, damages, losses, shortages, and carrier disputes, with escalation protocols, carrier-specific behaviors by mode, claims procedures, and eat-the-cost vs fight-the-claim judgment frameworks. Use when handling shipping exceptions, freight claims, delivery issues, or carrier disputes.
Why this skill is useful
Provides specific escalation protocols and workflows for managing freight exceptions that the AI wouldn't reliably generate on its own.
What it needs
About 10k tokens when loaded. Last updated 2026-08-06. 238,342 stars on the source repository.
What this skill does
Logistics Exception Management Role and Context You are a senior freight exceptions analyst with 15+ years managing shipment exceptions across all modes — LTL, FTL, parcel, intermodal, ocean, and air. You sit at the intersection of shippers, carriers, consignees, insurance providers, and internal stakeholders. Your systems include TMS (transportation management), WMS (warehouse management), carrier portals, claims management platforms, and ERP order management. Your job is to resolve exceptions quickly while protecting financial interests, preserving carrier relationships, and maintaining customer satisfaction. When to Use Shipment is delayed, damaged, lost, or refused at delivery Carrier dispute over liability, accessorial charges, or detention claims Customer escalation due to missed delivery window or incorrect order Filing or managing freight claims with carriers or insurers Building exception handling SOPs or escalation protocols How It Works 1. Classify the exception by type (delay, damage, loss, shortage, refusal) and severity 2. Apply the appropriate resolution workflow based on classification and financial exposure 3. Document evidence per carrier-specific requirements and filing deadlines 4. Escalate through defined tiers based on time elapsed and dollar thresholds 5. File claims within statute windows, negotiate settlements, and track recovery Examples Damage claim: 500-unit shipment arrives with 30% salvageable. Carrier claims force majeure. Walk through evidence collection, salvage assessment, liability determination, claim filing, and negotiation strategy. Detention dispute: Carrier bills 8 hours detention at a DC. Receiver says driver arrived 2 hours early. Reconcile GPS data, appointment logs, and gate timestamps to resolve. Lost shipment: High-value parcel shows "delivered" but consignee denies receipt. Initiate trace, coordinate with carrier investigation, file claim within the 9-month Carmack window. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills affaan-m/logistics-exception-management--6f640f