coding-standards
Baseline cross-project coding conventions for naming, readability, immutability, and code-quality review. Use detailed frontend or backend skills for framework-specific patterns.
logistics-exception-management
Codified expertise for handling freight exceptions, shipment delays, damages, losses, and carrier disputes. Informed by logistics professionals with 15+ years operational experience. Includes escalation protocols, carrier-specific behaviors, claims procedures, and judgment frameworks. Use when handling shipping exceptions, freight claims, delivery issues, or carrier disputes.
Full skill instructions
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.
Every exception falls into a classification that determines the resolution workflow, documentation requirements, and urgency:
Understanding how different carrier types operate changes your resolution strategy:
Assess every exception on three axes and take the highest severity:
Financial Impact:
Customer Impact:
Time Sensitivity:
This is the most common judgment call. Thresholds:
When multiple exceptions are active simultaneously (common during peak season or weather events), prioritize:
These are situations where the obvious approach is wrong. Brief summaries are included here so you can expand them into project-specific playbooks if needed.
Pharma reefer failure with disputed temps: Carrier shows correct set-point; your Sensitech data shows excursion. The dispute is about sensor placement and pre-cooling. Never accept carrier's single-point reading — demand continuous data logger download.
Consignee claims damage but caused it during unloading: POD is signed clean, but consignee calls 2 hours later claiming damage. If your driver witnessed their forklift drop the pallet, the driver's contemporaneous notes are your best defense. Without that, concealed damage claim against you is likely.
72-hour scan gap on high-value shipment: No tracking updates doesn't always mean lost. LTL scan gaps happen at busy terminals. Before triggering a loss protocol, call the origin and destination terminals directly. Ask for physical trailer/bay location.
Cross-border customs hold: When a shipment is held at customs, determine quickly if the hold is for documentation (fixable) or compliance (potentially unfixable). Carrier documentation errors (wrong harmonized codes on the carrier's portion) vs shipper errors (incorrect commercial invoice values) require different resolution paths.
Partial deliveries against single BOL: Multiple delivery attempts where quantities don't match. Maintain a running tally. Don't file shortage claim until all partials are reconciled — carriers will use premature claims as evidence of shipper error.
Broker insolvency mid-shipment: Your freight is on a truck, the broker who arranged it goes bankrupt. The actual carrier has a lien right. Determine quickly: is the carrier paid? If not, negotiate directly with the carrier for release.
Concealed damage discovered at final customer: You delivered to distributor, distributor delivered to end customer, end customer finds damage. The chain-of-custody documentation determines who bears the loss.
Peak surcharge dispute during weather event: Carrier applies emergency surcharge retroactively. Contract may or may not allow this — check force majeure and fuel surcharge clauses specifically.
Match communication tone to situation severity and relationship:
Brief templates appear below. Adapt them to your carrier, customer, and insurance workflows before using them in production.
Initial carrier inquiry: Subject: Exception Notice — PRO# {pro} / BOL# {bol}. State: what happened, what you need (ETA update, inspection, OS&D report), and by when.
Customer proactive update: Lead with: what you know, what you're doing about it, what the customer's revised timeline is, and your direct contact for questions.
Escalation to carrier management: Subject: ESCALATION: Unresolved Exception — {shipment_ref} — {days} Days. Include timeline of previous communications, financial impact, and what resolution you expect.
| Trigger | Action | Timeline |
|---|---|---|
| Exception value > $25,000 | Notify VP Supply Chain immediately | Within 1 hour |
| Enterprise customer affected | Assign dedicated handler, notify account team | Within 2 hours |
| Carrier non-response | Escalate to carrier account manager | After 4 hours |
| Repeated carrier (3+ in 30 days) | Carrier performance review with procurement | Within 1 week |
| Potential fraud indicators | Notify compliance and halt standard processing | Immediately |
| Temperature excursion on regulated product | Notify quality/regulatory team | Within 30 minutes |
| No scan update on high-value (> $50K) | Initiate trace protocol and notify security | After 24 hours |
| Claims denied > $10,000 | Legal review of denial basis | Within 48 hours |
Level 1 (Analyst) → Level 2 (Team Lead, 4 hours) → Level 3 (Manager, 24 hours) → Level 4 (Director, 48 hours) → Level 5 (VP, 72+ hours or any Level 5 severity)
Track these metrics weekly and trend monthly:
| Metric | Target | Red Flag |
|---|---|---|
| Mean resolution time | < 72 hours | > 120 hours |
| First-contact resolution rate | > 40% | < 25% |
| Financial recovery rate (claims) | > 75% | < 50% |
| Customer satisfaction (post-exception) | > 4.0/5.0 | < 3.5/5.0 |
| Exception rate (per 1,000 shipments) | < 25 | > 40 |
| Claims filing timeliness | 100% within 30 days | Any > 60 days |
| Repeat exceptions (same carrier/lane) | < 10% | > 20% |
| Aged exceptions (> 30 days open) | < 5% of total | > 15% |
Baseline cross-project coding conventions for naming, readability, immutability, and code-quality review. Use detailed frontend or backend skills for framework-specific patterns.
Go testing patterns including table-driven tests, subtests, benchmarks, fuzzing, and test coverage. Follows TDD methodology with idiomatic Go practices.
Docker and Docker Compose patterns for local development, container security, networking, volume strategies, and multi-service orchestration.
Spring Boot architecture patterns, REST API design, layered services, data access, caching, async processing, and logging. Use for Java Spring Boot backend work.
AI-assisted video editing workflows for cutting, structuring, and augmenting real footage. Covers the full pipeline from raw capture through FFmpeg, Remotion, ElevenLabs, fal.ai, and final polish in Descript or CapCut. Use when the user wants to edit video, cut footage, create vlogs, or build video content.
Pythonic idioms, PEP 8 standards, type hints, and best practices for building robust, efficient, and maintainable Python applications.
Create stunning, animation-rich HTML presentations from scratch or by converting PowerPoint files. Use when the user wants to build a presentation, convert a PPT/PPTX to web, or create slides for a talk/pitch. Helps non-designers discover their aesthetic through visual exploration rather than abstract choices.
REST API design patterns including resource naming, status codes, pagination, filtering, error responses, versioning, and rate limiting for production APIs.
Django architecture patterns, REST API design with DRF, ORM best practices, caching, signals, middleware, and production-grade Django apps.
PostgreSQL database patterns for query optimization, schema design, indexing, and security. Based on Supabase best practices.
Use this skill when writing new features, fixing bugs, or refactoring code. Enforces test-driven development with 80%+ coverage including unit, integration, and E2E tests.
Analyze raw prompts, identify intent and gaps, match ECC components (skills/commands/agents/hooks), and output a ready-to-paste optimized prompt. Advisory role only — never executes the task itself. TRIGGER when: user says "optimize prompt", "improve my prompt", "how to write a prompt for", "help me prompt", "rewrite this prompt", or explicitly asks to enhance prompt quality. Also triggers on Chinese equivalents: "优化prompt", "改进prompt", "怎么写prompt", "帮我优化这个指令". DO NOT TRIGGER when: user wants the task executed directly, or says "just do it" / "直接做". DO NOT TRIGGER when user says "优化代码", "优化性能", "optimize performance", "optimize this code" — those are refactoring/performance tasks, not prompt optimization.
Generate, edit, and beat-sync AI video with leading models in one workspace.
The world's fastest calendar for remote work
Transform Your Design with AI Designer by ImgCreator.ai
Revolutionizing Video Production with AI-Powered Creativity
Extend an image past the frame and let AI fill the new aspect ratio.
Discover your celebrity doppelgänger with StarByFace!
ChainClarity explains 700+ crypto whitepapers in plain English, with layered summaries, comparisons, research tools, alerts, and a $4.99 Pro plan.
Opus.ai: Revolutionize Your Web Experience