> ## Documentation Index
> Fetch the complete documentation index at: https://docs.datadocked.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Claude Code Skills

> Slash commands for maritime intelligence in Claude Code

Skills are slash commands that extend Claude Code with pre-built workflows for maritime data queries.

## Installation

<Tabs>
  <Tab title="Quick Setup">
    If you ran `datadocked-mcp --setup`, skills are already installed.
  </Tab>

  <Tab title="Manual Install">
    ```bash theme={null}
    datadocked-skills --install-skills
    ```

    Or copy skill files directly:

    ```bash theme={null}
    cp *.md ~/.claude/skills/
    ```
  </Tab>
</Tabs>

<Note>
  The DataDocked MCP Server must be installed and configured with your API key.
</Note>

***

## Basic Skills

Quick lookups using single API calls.

<CardGroup cols={3}>
  <Card title="/track-vessel" icon="location-dot">
    **1 credit** · IMO, MMSI, or name

    Real-time position, speed, course, and ETA for any vessel. Vessel names are resolved using `search_vessel_by_name`.

    ```
    /track-vessel Ever Given
    /track-vessel 9811000
    ```
  </Card>

  <Card title="/vessel-info" icon="ship">
    **5 credits** · IMO, MMSI, or name

    Comprehensive vessel details including type, flag, dimensions, tonnage, engine specs, and management info. Vessel names are resolved using `search_vessel_by_name`.

    ```
    /vessel-info MSC Oscar
    /vessel-info 9247431
    ```
  </Card>

  <Card title="/port-traffic" icon="anchor">
    **5 credits** · Port code

    View arrivals and departures at any port worldwide.

    ```
    /port-traffic SGSIN
    /port-traffic NLRTM
    ```
  </Card>
</CardGroup>

***

## Intelligence Reports

Comprehensive reports combining multiple data sources.

<CardGroup cols={2}>
  <Card title="/vessel-dossier" icon="file-lines">
    **\~13 credits** · IMO, MMSI, or name

    Complete intelligence report combining position, specifications, management, port history, and PSC inspections. Vessel names are resolved using `search_vessel_by_name`.

    ```
    /vessel-dossier 9811000
    /vessel-dossier Ever Given
    ```

    <Accordion title="What's included">
      * Current position & navigation status
      * Full vessel specifications (from `get_vessel_details`)
      * Engine & fuel details
      * Owner, operator & manager info
      * Recent port calls
      * PSC inspection history (requires IMO)
      * Risk assessment score
    </Accordion>
  </Card>

  <Card title="/voyage-brief" icon="route">
    **\~38 credits** · IMO, MMSI, or name

    Current voyage narrative with weather conditions, route context, and ETA analysis. Vessel names are resolved using `search_vessel_by_name`.

    ```
    /voyage-brief Ever Given
    /voyage-brief 9811000
    ```

    <Accordion title="What's included">
      * Current voyage details
      * Weather at vessel location
      * Historical position data
      * Port call context
      * ETA reliability analysis
    </Accordion>
  </Card>
</CardGroup>

***

## Fleet & Area Monitoring

Track multiple vessels or monitor geographic regions.

<CardGroup cols={2}>
  <Card title="/fleet-monitor" icon="radar">
    **\~6 credits/vessel** · IMO or MMSI

    Track multiple vessels in a dashboard view with real-time positions. Uses bulk endpoint then fetches details by IMO.

    ```
    /fleet-monitor 9811000, 9321483, 9454450
    ```

    <Accordion title="What's included">
      * Position for each vessel
      * Speed & heading comparison
      * ETA summary table
      * Fleet status overview
    </Accordion>
  </Card>

  <Card title="/area-watch" icon="map-location-dot">
    **\~85 credits** · Circular search

    Monitor all vessels in a geographic region using circular search (center point + radius, max 50km).

    ```
    /area-watch 1.25, 103.75, 50 tanker
    /area-watch Singapore Strait tanker
    ```

    <Accordion title="What's included">
      * All vessels within radius
      * Filter by vessel type
      * Position & heading data
      * Traffic density analysis
    </Accordion>

    <Warning>
      Maximum radius is 50 km. Uses circular search with latitude, longitude, and radius\_km.
    </Warning>
  </Card>
</CardGroup>

***

## Compliance & Risk

Assess vessel compliance and operational risk.

<CardGroup cols={2}>
  <Card title="/compliance-audit" icon="clipboard-check">
    **\~10 credits** · IMO only

    PSC risk assessment with detention history and deficiency analysis.

    ```
    /compliance-audit 9811000
    ```

    <Accordion title="What's included">
      * PSC inspection history
      * Detention records
      * Deficiency breakdown
      * Risk score calculation
      * Flag state performance
    </Accordion>

    <Warning>
      PSC inspections require IMO number. Resolve vessel names to IMO first using `/track-vessel`.
    </Warning>
  </Card>

  <Card title="/port-intel" icon="building-flag">
    **\~55 credits** · Port code

    Comprehensive port activity analysis with traffic patterns.

    ```
    /port-intel SGSIN
    /port-intel NLRTM
    ```

    <Accordion title="What's included">
      * Recent arrivals/departures
      * Vessel type breakdown
      * Traffic volume trends
      * Average port time
      * Key operators analysis
    </Accordion>
  </Card>
</CardGroup>

***

## Historical Analysis

Analyze vessel patterns over time.

<CardGroup cols={2}>
  <Card title="/route-history" icon="clock-rotate-left">
    **\~156 credits (30 days)** · IMO or MMSI

    Historical voyage patterns and port call analysis over time.

    ```
    /route-history 9811000 90
    ```

    <Accordion title="What's included">
      * Historical positions
      * Port call timeline
      * Trade route patterns
      * Seasonal variations
      * Speed/efficiency trends
    </Accordion>
  </Card>

  <Card title="/competitor-watch" icon="users">
    **\~210 credits** · Circular search

    Analyze vessels by owner/operator in a specific region using circular search (max 50km).

    ```
    /competitor-watch 25.0, -90.0, 50
    /competitor-watch Singapore Strait
    ```

    <Accordion title="What's included">
      * Vessels by operator
      * Fleet composition
      * Market share analysis
      * Activity patterns
    </Accordion>

    <Warning>
      Maximum radius is 50 km. Uses circular search with latitude, longitude, and radius\_km.
    </Warning>
  </Card>
</CardGroup>

***

## Usage Tips

<CardGroup cols={2}>
  <Card title="Vessel Name Resolution" icon="magnifying-glass">
    Skills accept vessel names (e.g., "Ever Given"). Names are resolved to IMO/MMSI using `search_vessel_by_name` (+1 credit).
  </Card>

  <Card title="Use IMO Numbers" icon="hashtag">
    IMO numbers (7 digits) are most reliable and skip the name lookup. PSC inspections require IMO only.
  </Card>

  <Card title="Check Credits First" icon="coins">
    Each skill shows estimated cost before execution.
  </Card>

  <Card title="Combine Skills" icon="layer-group">
    Start with `/track-vessel` to get IMO, then use `/vessel-dossier` for deep dives.
  </Card>
</CardGroup>

### Disable Credit Warnings

```bash theme={null}
export DATADOCKED_SHOW_COST=false
```