# SKILL: vessel-opportunity-screener

## 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