Cold Chain Risk Calculator

Fallback template: If scripts/main.py fails or required inputs are absent, report: (a) which parameter is missing, (b) what partial assessment is still possible, (c) the manual risk-scoring approach.

Parameters

Usage

python scripts/main.py --route "NYC-Boston" --duration 48 --packaging dry-ice
python scripts/main.py --route "LAX-London" --duration 120 --packaging liquid-nitrogen --output risk_report.json

Output Format

The script outputs a structured JSON object:

{
  "route": "NYC-Boston",
  "duration_hours": 48,
  "packaging": "dry-ice",
  "risk_score": 19.2,
  "risk_level": "Medium",
  "mitigation_recommendations": [
    "Add temperature logger to shipment",
    "Pre-condition dry ice 2h before packing",
    "Notify recipient of expected arrival window"
  ]
}

The mitigation_recommendations field is always present and contains at least one actionable item. Recommendations are generated based on risk level and packaging type.

Risk Model

Risk score = duration_hours × 0.5 × packaging_factor

Risk levels: Low (< 15), Medium (15–30), High (> 30)

Model limitations: The formula does not account for route complexity, number of transit legs, or ambient temperature variability. A 120-hour international flight may score lower than a 48-hour domestic route due to packaging factor alone. Document these assumptions in every response.

Features

• Route risk assessment based on duration and packaging type
• Structured JSON output with risk score, level, and mitigation recommendations
• Input validation: rejects negative or zero duration (exit code 1)
• Mitigation action list generated per risk level and packaging type

Output Requirements

Every response must make these explicit:

• Objective and deliverable
• Inputs used and assumptions introduced (ambient temperature assumed standard; no transit-leg complexity modeled)
• Workflow or decision path taken
• Core result: risk score, risk level, and mitigation recommendations
• Constraints, risks, caveats (e.g., model does not account for route complexity or number of transit legs)
• Unresolved items and next-step checks

Input Validation

This skill accepts: cold chain transport scenarios defined by a route, duration, and optional packaging type.

If the request does not involve temperature-controlled shipping risk — for example, asking to track a shipment in real time, calculate drug dosing, or assess non-temperature logistics — do not proceed. Instead respond:

"cold-chain-risk-calculator is designed to assess temperature excursion risk for cold chain transport. Your request appears to be outside this scope. Please provide a route, duration, and packaging type, or use a more appropriate tool for your task."

Error Handling

• If --duration is ≤ 0, print Error: --duration must be a positive integer (hours). to stderr and exit with code 1.
• If --packaging is not one of dry-ice, liquid-nitrogen, gel-packs, reject with a clear error listing valid options.
• If required inputs are missing, state exactly which fields are missing and request only the minimum additional information.
• If the task goes outside the documented scope, stop instead of guessing or silently widening the assignment.
• If scripts/main.py fails, report the failure point, summarize what still can be completed safely, and provide a manual fallback.
• Do not fabricate files, citations, data, search results, or execution outcomes.

Response Template

1. Objective
2. Inputs Received
3. Assumptions
4. Workflow
5. Deliverable
6. Risks and Limits
7. Next Checks