Anatomía de una Skill de Agente

## Purpose

Given a list of vessels or routes, evaluate rental/charter opportunity quality using multi-factor scoring: traffic density, seasonal demand, vessel utilization rates, competitive pricing, and route profitability. Returns a ranked shortlist with scores and rationale for maritime operators and investors.

## Trigger

Use when the user provides vessel types, ports, or routes and asks for:

• Charter opportunity screening
• Route profitability analysis
• Vessel utilization benchmarking
• Maritime traffic demand assessment

## Inputs

• vessels: list of vessel descriptors (e.g. ["tanker 50k DWT", "yacht 30m", "ferry Palma-Ibiza"])
• context: optional string (e.g. "Mediterranean summer season", "post-Suez disruption")
• budget_range: optional (e.g. "$5k-$20k/day")

## Scoring Dimensions (weighted composite 0–10)

1. Route Demand (25%) — AIS traffic density, port call frequency, seasonal patterns
2. Utilization Rate (25%) — historical charter fill rate for vessel class on route
3. Price Competitiveness (20%) — day rate vs. comparable vessels in region
4. Operational Risk (15%, inverted) — weather exposure, piracy zones, port congestion
5. Regulatory Clarity (15%) — flag state compliance, cabotage restrictions, customs complexity

## Steps

1. Parse vessel type, size class, and proposed route/region
2. Retrieve traffic and demand signals for the route
3. Score each dimension 0–10 vs. regional benchmarks
4. Compute weighted composite score
5. Flag red flags: sanctioned ports, storm season overlap, draft restrictions
6. Return ranked candidates with score breakdown and one-sentence rationale

## Output Format

JSON:

{
  "screened_at": "<ISO date>",
  "context": "<user context>",
  "candidates": [
    {
      "vessel": "tanker 50k DWT",
      "route": "Rotterdam → Trieste",
      "composite_score": 8.1,
      "scores": {
        "route_demand": 9,
        "utilization_rate": 8,
        "price_competitiveness": 7,
        "operational_risk_inv": 8,
        "regulatory_clarity": 9
      },
      "red_flags": [],
      "rationale": "High-frequency crude corridor with strong Q4 demand and minimal regulatory friction."
    }
  ],
  "skipped": []
}
                        

## Error Handling

• If vessel descriptor is ambiguous, make best-effort classification and note assumption
• If fewer than 2 valid vessels, return warning and screen what's available
• Flag any vessel/route combination with composite score < 4 as "not recommended"

## Notes

• Always contextualize within season: Mediterranean peaks June–Sept, North Sea peaks Oct–Mar
• Distinguish spot market vs. time charter dynamics
• Prefer routes with AIS coverage > 90%
• Never recommend routes overlapping with active conflict zones or OFAC sanctions