terminal-economics

Model container terminal tariffs, charges, and invoicing in TypeScript.

1|Updated Mar 26, 2026
One-click install
npx skills add https://github.com/MrCull/shipping-container-sims --skill terminal-economics
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: terminal-economics
Source: https://github.com/MrCull/shipping-container-sims/tree/main/.ai/skills/terminal-economics
Command: npx skills add https://github.com/MrCull/shipping-container-sims --skill terminal-economics

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Data structures, schemas, and default values for container terminal economics: tariff structures, handling charges, storage fees, surcharges, and cost modeling. Use when implementing economic models, billing systems, or cost tracking in terminal simulations.

Core Features & Use Cases

  • TypeScript-first interfaces for tariffs (HandlingCharge, Surcharge, StoragePolicy, ServiceCharge, CargoClassModifier) and realistic defaults.
  • Region-based tariff book creation via createTariffBook(region) and end-to-end invoicing via generateInvoice.
  • Utilities for storage costing, revenue/cost tracking, and profitability metrics across container visits.

Quick Start

Create a region-specific TariffBook with createTariffBook(region), then generate an invoice using generateInvoice for a sample container visit.

Frequently Asked Questions about terminal-economics

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I model container terminal tariffs and handling charges in TypeScript?

You can model container terminal tariffs using TypeScript-first interfaces like HandlingCharge, Surcharge, and StoragePolicy. This Skill provides strict data structures and default values to define handling charges, storage fees, and surcharges for terminal billing systems.

What is the best way to generate invoices for container terminal visits?

The best way to generate invoices for container visits is using the generateInvoice utility. It creates end-to-end invoices by applying a region-specific TariffBook to calculate handling, storage, and service charges automatically.

Can I use region-based tariff structures for terminal cost tracking?

Yes, you can create region-based tariff structures using the createTariffBook(region) factory. This provides default datasets and region-specific configurations for terminal cost tracking and profitability metrics across container visits.

Do I need external dependencies to implement terminal billing and cost modeling?

No external dependencies are required. This Skill is implemented in TypeScript with strict mode and includes built-in interfaces, default datasets, and utilities for terminal economic modeling, invoicing, and revenue tracking out of the box.

How do storage fees and surcharges work in container terminal cost models?

Storage fees and surcharges work through dedicated TypeScript interfaces like StoragePolicy and Surcharge. These structures model time-based storage costs and additional terminal charges, enabling accurate cost tracking and profitability analysis for container visits.

What utilities are available for calculating terminal profitability metrics?

Utilities for storage costing, revenue tracking, and profitability metrics are included. By applying TariffBook configurations to container visits, you can calculate total revenue, costs, and profitability across handling, surcharges, storage, and service charges.