How this skill is triggered — by the user, by Claude, or both
Slash command
/cps-mar:maritime-port-operationsThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
---
Purpose: Execute structured port or terminal operations assessment, identify efficiency improvements, and develop optimization recommendations for maritime facilities.
When to Use:
Subagent Integration: This skill works with the .claude/subagents/industries/maritime-port-operations.md subagent, which provides deep domain expertise automatically.
Objective: Define project scope, identify stakeholders, and gather baseline operational data.
Actions:
Define Project Scope:
Stakeholder Identification:
Data Collection Requirements:
### Vessel Operations Data (12-month historical):
- [ ] Vessel arrival schedule (actual vs. planned)
- [ ] Vessel waiting times (by vessel type/size)
- [ ] Berth occupancy (by berth)
- [ ] Cargo volumes discharged/loaded (by vessel)
- [ ] Vessel turnaround times
- [ ] Crane assignments and productivity (moves/hour)
- [ ] Delays and downtime (by category)
### Yard Operations Data:
- [ ] Container/cargo inventory (daily snapshots)
- [ ] Dwell times (by cargo type, destination)
- [ ] Yard density and occupancy rates
- [ ] Rehandle rates
- [ ] Equipment utilization (RTGs, RMGs, reach stackers)
- [ ] Storage layout and zoning
### Gate Operations Data:
- [ ] Daily truck transactions (in/out)
- [ ] Truck turn times (distribution)
- [ ] Gate processing times (by transaction type)
- [ ] Peak hour volumes
- [ ] Appointment system data (if applicable)
### Equipment Data:
- [ ] Equipment inventory and specifications
- [ ] Equipment availability (uptime %)
- [ ] Maintenance records and downtime
- [ ] Utilization rates
- [ ] Age and condition assessments
### Financial Data:
- [ ] Revenue structure (per TEU, per tonne, per transaction)
- [ ] Operating costs (labor, equipment, utilities)
- [ ] Capital expenditure history
- [ ] Pricing and tariff schedules
Site Visit Planning:
Deliverables:
Acceptance Criteria:
Objective: Analyze current operational performance and establish baseline metrics.
Actions:
Calculate Key Performance Indicators:
Vessel Operations KPIs:
| Metric | Calculation | Baseline |
|---|---|---|
| Berth Productivity | Total moves / Total vessel hours | ___ GMPH |
| Crane Productivity | Net moves / Crane working hours | ___ NMPH |
| Vessel Turnaround Time | Average hours from arrival to departure | ___ hours |
| Vessel Waiting Time | Average hours waiting for berth | ___ hours |
| Berth Utilization | Berth occupied hours / Total hours | ___% |
Yard Operations KPIs:
| Metric | Calculation | Baseline |
|---|---|---|
| Yard Density | Occupied slots / Total slots | ___% |
| Average Dwell Time | Total days in yard / Container count | ___ days |
| Rehandle Rate | Rehandles / Total moves | ___% |
| Equipment Utilization | Productive hours / Available hours | ___% |
Gate Operations KPIs:
| Metric | Calculation | Baseline |
|---|---|---|
| Gate Throughput | Trucks processed / Hour | ___ trucks/hour |
| Truck Turn Time | Average gate-in to gate-out | ___ minutes |
| Peak Factor | Peak hour volume / Average hour volume | ___x |
Equipment KPIs:
| Metric | Calculation | Baseline |
|---|---|---|
| Equipment Availability | Uptime hours / Total hours | ___% |
| MTBF | Operating hours / Number of failures | ___ hours |
| MTTR | Repair hours / Number of repairs | ___ hours |
Performance Trend Analysis:
Bottleneck Identification:
Operational Observations:
Deliverables:
Acceptance Criteria:
Objective: Compare current performance against industry benchmarks and identify performance gaps.
Actions:
Identify Peer Ports for Benchmarking:
Benchmark Comparison:
Container Terminal Benchmarks:
| Metric | Current Performance | Peer Average | World-Class | Gap |
|---|---|---|---|---|
| Berth Productivity (GMPH) | ___ | 80-100 | 120-150 | ___ |
| Crane Productivity (NMPH) | ___ | 25-30 | 35-45 | ___ |
| Vessel Turnaround Time (hours) | ___ | 24-36 | <24 | ___ |
| Yard Density (%) | ___ | 60-70 | 70-75 | ___ |
| Dwell Time (days) | ___ | 5-7 | 3-5 | ___ |
| Truck Turn Time (minutes) | ___ | 45-60 | <30 | ___ |
| Equipment Availability (%) | ___ | 90-93 | >95 | ___ |
Bulk Terminal Benchmarks:
| Metric | Current Performance | Peer Average | World-Class | Gap |
|---|---|---|---|---|
| Loading Rate (tonnes/hour) | ___ | Varies by cargo | Varies by cargo | ___ |
| Vessel Turnaround (hours) | ___ | 48-72 | 24-48 | ___ |
| Storage Utilization (%) | ___ | 60-75 | 75-85 | ___ |
| Equipment Availability (%) | ___ | 85-90 | >92 | ___ |
Root Cause Analysis: For each significant performance gap:
SWOT Analysis:
Deliverables:
Acceptance Criteria:
Objective: Assess current capacity constraints and forecast future capacity requirements.
Actions:
Current Capacity Assessment:
Berth Capacity:
Annual Berth Capacity = (Number of Berths) × (Available Hours/Year) × (Productivity) / (Average Vessel Size)
Inputs:
- Number of berths: ___
- Availability: ___ hours/year (365 × 24 × Utilization Target)
- Productivity: ___ TEU/hour or tonnes/hour
- Average vessel call size: ___ TEU or tonnes
Current Capacity: ___________ TEU/year or tonnes/year
Current Throughput: ___________ TEU/year or tonnes/year
Capacity Utilization: ____%
Yard Capacity:
Annual Yard Capacity = (Ground Slots) × (Stack Height) × (Utilization) × (365 / Dwell Time)
Inputs:
- Ground slots: ___
- Stack height: ___
- Utilization target: ___%
- Average dwell time: ___ days
Current Capacity: ___________ TEU/year
Current Throughput: ___________ TEU/year
Capacity Utilization: ____%
Gate Capacity:
Annual Gate Capacity = (Gate Lanes) × (Operating Hours/Year) × (Trucks/Lane/Hour) × (TEU/Truck)
Inputs:
- Gate lanes: ___
- Operating hours: ___ hours/year
- Truck processing rate: ___ trucks/hour/lane
- Average TEU per truck: ___
Current Capacity: ___________ TEU/year
Current Throughput: ___________ TEU/year
Capacity Utilization: ____%
Bottleneck Identification: [Berth | Yard | Gate | Equipment] is the constraining factor.
Demand Forecasting:
Capacity Gap Analysis:
| Year | Forecast Volume | Current Capacity | Capacity Gap | Utilization |
|---|---|---|---|---|
| 2026 | ___ | ___ | ___ | ___% |
| 2027 | ___ | ___ | ___ | ___% |
| 2028 | ___ | ___ | ___ | ___% |
| 2029 | ___ | ___ | ___ | ___% |
| 2030 | ___ | ___ | ___ | ___% |
Capacity Expansion Options:
Deliverables:
Acceptance Criteria:
Objective: Develop specific, actionable recommendations to improve port operational efficiency.
Actions:
Categorize Improvement Opportunities:
Quick Wins (0-6 months, low cost):
| # | Recommendation | Impact | Cost | Timeline | Owner |
|---|---|---|---|---|---|
| QW-01 | [Description] | [KPI improvement] | $ | ___ months | TBD |
| QW-02 | [Description] | [KPI improvement] | $ | ___ months | TBD |
Operational Improvements (6-18 months, moderate cost):
| # | Recommendation | Impact | Cost | Timeline | Owner |
|---|---|---|---|---|---|
| OP-01 | [Description] | [KPI improvement] | $$ | ___ months | TBD |
| OP-02 | [Description] | [KPI improvement] | $$ | ___ months | TBD |
Strategic Initiatives (18+ months, high cost):
| # | Recommendation | Impact | Cost | Timeline | Owner |
|---|---|---|---|---|---|
| SI-01 | [Description] | [KPI improvement] | $$$ | ___ months | TBD |
| SI-02 | [Description] | [KPI improvement] | $$$ | ___ months | TBD |
Detailed Recommendation Format:
For each recommendation:
### [ID] [Recommendation Title]
**Description:**
[Detailed description of the recommendation]
**Current State:**
[What is currently happening that needs to change]
**Proposed Solution:**
[Specific actions to be taken]
**Expected Benefits:**
- [KPI 1]: Improve from X to Y (Z% improvement)
- [KPI 2]: Improve from X to Y (Z% improvement)
- [Additional benefits]
**Implementation Requirements:**
- Resources: [People, equipment, systems]
- Timeline: [Duration]
- Dependencies: [Prerequisites]
**Cost Estimate:**
- CAPEX: $___
- OPEX (annual): $___
**ROI Analysis:**
- Annual benefit: $___
- Payback period: ___ years
- NPV (5-year): $___
**Risks and Mitigation:**
- Risk 1: [Description] → Mitigation: [Action]
- Risk 2: [Description] → Mitigation: [Action]
Common Port Operations Recommendations:
Vessel Operations:
Yard Operations:
Gate Operations:
Equipment:
Technology and Systems:
Processes:
Prioritization Matrix: Plot all recommendations on Impact vs. Effort matrix:
Deliverables:
Acceptance Criteria:
Objective: Evaluate opportunities for technology adoption and automation to improve efficiency.
Actions:
Current Technology Inventory:
Automation Opportunities:
Quay Crane Automation:
Yard Automation:
Gate Automation:
TOS Upgrade or Replacement:
IoT and Smart Port Technologies:
Data Analytics and AI:
Automation Business Case:
### Automation Investment Analysis
**CAPEX Estimate:**
- Equipment: $___
- Software: $___
- Infrastructure: $___
- Integration: $___
- **Total:** $___
**OPEX Impact (annual):**
- Labor savings: $___
- Maintenance (change): $___
- Utilities (change): $___
- **Net savings:** $___
**Productivity Impact:**
- Berth productivity: +___%
- Equipment utilization: +___%
- Throughput capacity: +___%
**Financial Metrics:**
- Payback period: ___ years
- NPV (10-year): $___
- IRR: ___%
Implementation Roadmap:
Deliverables:
Acceptance Criteria:
Objective: Identify opportunities to improve environmental performance and safety standards.
Actions:
Environmental Assessment:
Air Quality:
Water Quality:
Waste Management:
Noise:
Sustainability Goals:
Safety Assessment:
Current Safety Performance:
Common Hazards:
Safety Improvement Opportunities:
Security Assessment (ISPS Compliance):
Deliverables:
Acceptance Criteria:
Objective: Develop comprehensive business case for recommended improvements, including ROI analysis.
Actions:
Cost Estimation:
CAPEX Breakdown:
| Category | Description | Cost Estimate |
|---|---|---|
| Equipment | [Cranes, yard equipment, trucks] | $__ |
| Infrastructure | [Berths, paving, buildings] | $__ |
| Technology | [TOS, automation, IT systems] | $__ |
| Other | [Contingency, soft costs] | $__ |
| Total CAPEX | $__ |
OPEX Impact (Annual):
| Category | Current | Post-Implementation | Change |
|---|---|---|---|
| Labor | $__ | $__ | $__ |
| Equipment maintenance | $__ | $__ | $__ |
| Utilities | $__ | $__ | $__ |
| Other | $__ | $__ | $__ |
| Total OPEX | $__ | $__ | $__ |
Revenue Impact:
Volume Growth:
Productivity Gains:
Financial Metrics:
NPV (Net Present Value) Calculation:
Inputs:
- Discount rate (WACC): ___%
- Time horizon: 15 years
- Annual cash flow: $__ (revenue increase + cost savings - OPEX change)
- Initial investment (CAPEX): $__
NPV = -CAPEX + Σ (Annual Cash Flow / (1 + discount rate)^year)
NPV = $___
IRR (Internal Rate of Return):
Payback Period:
Sensitivity Analysis:
| Variable | -20% | Base | +20% | Impact on NPV |
|---|---|---|---|---|
| Volume growth | ___% | ___% | ___% | $__ to $__ |
| CAPEX | $__ | $__ | $__ | $__ to $__ |
| Revenue/TEU | $__ | $__ | $__ | $__ to $__ |
| Discount rate | ___% | ___% | ___% | $__ to $__ |
Risk-Adjusted Returns:
Non-Financial Benefits:
Deliverables:
Acceptance Criteria:
Objective: Develop detailed implementation plan with change management strategy.
Actions:
Implementation Roadmap:
Phase 1: Quick Wins (Months 0-6):
| Initiative | Description | Owner | Duration | Dependencies |
|---|---|---|---|---|
| QW-01 | [Title] | TBD | ___ months | None |
| QW-02 | [Title] | TBD | ___ months | None |
Phase 2: Operational Improvements (Months 6-18):
| Initiative | Description | Owner | Duration | Dependencies |
|---|---|---|---|---|
| OP-01 | [Title] | TBD | ___ months | [ID] |
| OP-02 | [Title] | TBD | ___ months | [ID] |
Phase 3: Strategic Initiatives (Months 18-36):
| Initiative | Description | Owner | Duration | Dependencies |
|---|---|---|---|---|
| SI-01 | [Title] | TBD | ___ months | [ID] |
| SI-02 | [Title] | TBD | ___ months | [ID] |
Gantt Chart:
Resource Requirements:
### Project Team:
- Project Manager: [Full-time | Part-time]
- Operations Lead: [Full-time | Part-time]
- Technology Lead: [Full-time | Part-time]
- Training Coordinator: [Full-time | Part-time]
- External Consultants: [As needed]
### Budget:
- CAPEX: $___
- OPEX (annual): $___
- Contingency (10%): $___
- **Total:** $___
Change Management Plan:
Stakeholder Engagement:
Training and Capacity Building:
Organizational Change:
Resistance Management:
Performance Monitoring:
Risk Management:
| Risk | Probability | Impact | Mitigation Strategy | Owner |
|---|---|---|---|---|
| [Risk 1] | [H/M/L] | [H/M/L] | [Strategy] | TBD |
| [Risk 2] | [H/M/L] | [H/M/L] | [Strategy] | TBD |
Deliverables:
Acceptance Criteria:
Objective: Prepare and deliver executive presentation and comprehensive final report.
Actions:
Executive Presentation (PowerPoint):
Slide Structure:
Executive Summary (1 slide)
Current State Assessment (3-4 slides)
Recommendations Overview (2-3 slides)
Business Case (2-3 slides)
Implementation Roadmap (1-2 slides)
Next Steps (1 slide)
Final Report (Word Document):
Report Structure:
1. Executive Summary (3-5 pages)
2. Introduction and Project Scope
3. Current State Assessment
- Operational performance
- Benchmarking
- Gap analysis
4. Capacity Analysis
- Current capacity
- Demand forecast
- Capacity gap
5. Improvement Recommendations
- Quick wins
- Operational improvements
- Strategic initiatives
6. Technology and Automation
- Technology assessment
- Automation opportunities
- Business case
7. Environmental and Safety
- Current state
- Improvement opportunities
8. Financial Analysis
- Cost estimates
- Revenue impact
- NPV, IRR, sensitivity
9. Implementation Roadmap
- Phased approach
- Timeline and milestones
- Resource requirements
10. Change Management
- Stakeholder engagement
- Training plan
- Risk management
11. Conclusion and Next Steps
12. Appendices
- Detailed KPI calculations
- Benchmarking data sources
- Capacity calculation worksheets
- Financial model
- Stakeholder interview summaries
Supporting Materials:
Delivery and Q&A:
Deliverables:
Acceptance Criteria:
Before marking this skill as complete, verify:
How They Work Together:
Subagent Provides (Automatic Background Expertise):
Skill Provides (Executable Workflow):
Example Workflow:
/maritime-port-operations skill01_Discovery/port_operations_data/ - Collected operational data02_Analysis/baseline_assessment.md - Current state analysis02_Analysis/benchmarking_report.md - Performance vs. peers02_Analysis/capacity_analysis.xlsx - Capacity calculations03_Recommendations/improvement_opportunities.md - Prioritized recommendations03_Recommendations/technology_assessment.md - Automation opportunities03_Recommendations/financial_analysis.xlsx - Business case model04_Implementation/implementation_roadmap.xlsx - Gantt chart04_Implementation/change_management_plan.md - Change strategy05_Deliverables_Final/Port_Operations_Assessment_Report.docx - Final report05_Deliverables_Final/Executive_Presentation.pptx - Executive slidesVersion: 1.0 Last Updated: 2026-01-22 Skill Type: Industry-Specific (Maritime)
npx claudepluginhub hossamdaoud83/cps-plugins-official --plugin cps-marCreates, edits, and optimizes skills for Claude Code, including drafting, evaluating with test prompts, iterating on performance, and improving skill descriptions for better triggering accuracy.