vessel-entities

Define TypeScript vessel data models and factory helpers for terminal simulations.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Canonicalize vessel data models, schemas, and default values for container vessel simulations, ensuring consistent data across modules and experiments.

Core Features & Use Cases

  • Strong-typed data models: TypeScript interfaces for Vessel, VesselClass, and related entities.
  • Defaulted object factories: Prebuilt defaults for class dimensions, capacities, and performance metrics.
  • Generation utilities: Helpers to derive vessel geometry, sample vessels, voyages, and stowage slots for testing and demos.
  • Use Case: Generate a complete vessel with default values and a sample voyage to validate integration.

Quick Start

Create a sample Feeder vessel using the vessel-entities skill and generate a basic voyage to demonstrate the defaults.

Frequently Asked Questions about vessel-entities

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

FAQPage Schema
How do I define TypeScript data models for container vessel simulations?

To define TypeScript data models for container vessel simulations, use schema-driven interfaces and factory helpers that establish canonical types for vessels, slots, and coordinate systems. This ensures consistent data representation across all simulation modules.

What is the best way to generate sample vessel data and default voyages for terminal simulation testing?

The best way to generate sample vessel data and default voyages for terminal simulation testing is using prebuilt factory helpers. These utilities instantiate canonical vessel models with default class dimensions, capacities, and performance metrics to validate integrations.

Can I use these vessel data models for stowage logic and stability calculations?

Yes, you can use these vessel data models for stowage logic and stability calculations. The canonical schemas, coordinate systems, and slot entities are explicitly designed to provide consistent, validated data across bay plan generation and stability computations.

Does this approach provide default dimensions and capacities for different vessel classes?

Yes, this approach provides default dimensions and capacities for different vessel classes. It includes prebuilt defaulted object factories that supply default values for vessel class geometry, capacity metrics, and performance characteristics out of the box.

How do vessel entities handle coordinate systems and stowage slots in TypeScript?

Vessel entities handle coordinate systems and stowage slots in TypeScript by implementing structured interfaces and generation utilities. These tools validate and instantiate slot geometries and related entities to maintain spatial consistency throughout the simulation.