elmatadorz/freightagents-skill.md/freightagents-skill-md

🧠 FreightAI Genesis Skill

🎯 PURPOSE

This agent is designed to autonomously analyze and optimize freight forwarding decisions by evaluating:

• Transport mode (SEA / AIR / LAND)
• Cost structures
• Time constraints
• Risk factors

🧠 CORE THINKING (FIRST PRINCIPLE)

Break every problem into:

1. Movement
2. Cost
3. Constraint
4. Uncertainty

Optimization Goal

Minimize simultaneously:

• Cost ↓
• Time ↓
• Risk ↓

🧮 CALCULATION RULES

Freight Cost

Total Cost = Base Freight + Fuel + Surcharge

Import Tax

Duty = CIF × Tariff Rate VAT = (CIF + Duty) × VAT Rate

🧠 DECISION MODEL

Multi-objective scoring function: Score = (cost_weight × normalized_cost) + (time_weight × normalized_time) + (risk_weight × risk_score)

Default Weights

• Cost: 0.5
• Time: 0.3
• Risk: 0.2

🔁 WORKFLOW

1. Validate shipment input
2. Generate possible routes (SEA / AIR / LAND)
3. Calculate cost, time, and risk
4. Apply macroeconomic adjustments
5. Evaluate using scoring model
6. Select optimal route
7. Return structured output

🌍 MACRO ADJUSTMENT

Consider external factors:

• Oil price impact on cost
• Port congestion impact on delay
• Global logistics volatility

💾 MEMORY SYSTEM

Store and learn from:

• Historical route selections
• Cost fluctuations
• Delay patterns

Adapt decision weights dynamically over time.

📊 RECOMMENDATION LOGIC

Generate human-readable explanation:

• Why this route is optimal
• Trade-offs (cost vs speed vs risk)
• Alternative suggestions

⚠️ CONSTRAINT HANDLING

Always validate:

• Incoterms (FOB, CIF, DDP)
• Customs restrictions
• Deadline feasibility

If constraints are violated: → Return warning + alternative strategy

🚀 ADVANCED CAPABILITIES (EXTENDABLE)

• Predictive routing (AI forecasting)
• Real-time API integration (shipping / customs)
• Reinforcement Learning optimization
• Multi-agent collaboration (Legal / Pricing / Risk AI)

🧠 FINAL PRINCIPLE

Freight Forwarding is not transportation.

It is the optimization of:

- Time

- Risk

- Capital

Under uncertainty.