Journey Planning with Waypoints

Plan multi-waypoint journeys with route optimization, feasibility analysis, and time budget constraints. Use when you need to plan trips with multiple stops...

Security Scan

The skill's code, instructions, and required credential (CAMINO_API_KEY) are consistent with a multi-waypoint journey planning integration that calls api.getcamino.ai; nothing in the package suggests unexplained access or data exfiltration.

Purpose & Capability

Name/description match the implementation: the skill validates JSON input and POSTs it to https://api.getcamino.ai/journey using a single API key (CAMINO_API_KEY). Required tools (curl, jq) are appropriate for the provided shell script.

Instruction Scope

SKILL.md and scripts/journey.sh limit actions to validating input, checking CAMINO_API_KEY, and sending the request to the Camino API. The README suggests adding the key to ~/.claude/settings.json (agent config) — reasonable for convenience and expected for an API-key-backed skill.

Install Mechanism

No formal install spec is embedded in the package (instruction-only + included script). SKILL.md suggests using npx to install a GitHub-hosted 'camino-skills' collection or clawhub; GitHub and official npx usage are common, but fetching and running packages from third-party repos carries the usual supply-chain risk — this is optional and not required for the skill to work locally.

Credentials

Only one credential (CAMINO_API_KEY) is requested and used by the script. That is proportionate to the declared purpose. The skill does not request unrelated secrets or system credentials.

Persistence & Privilege

always:false and no attempt to modify other skills or system-wide settings. Writing the API key into the agent's settings.json is suggested for convenience but is normal for API-key-based skills and limited in scope.

Assessment

This skill appears to do what it says: it validates input and forwards it to Camino's journey endpoint, using only CAMINO_API_KEY. Before installing, confirm you trust the Camino service and the GitHub repo if you follow the npx install instructions. Use a dedicated API key (or the temporary trial key) rather than reusing high-privilege credentials, ensure jq and curl are installed, and be aware the README suggests storing the key in ~/.claude/settings.json (agent config) for convenience — store keys where you are comfortable and rotate them if needed.

Installation

Companion Skills: This is part of the Camino AI location intelligence suite. Install all available skills (query, places, relationship, context, route, journey, real-estate, hotel-finder, ev-charger, school-finder, parking-finder, fitness-finder, safety-checker, travel-planner) for comprehensive coverage.

# Install all skills from repo
npx skills add https://github.com/barneyjm/camino-skills

# Or install specific skills
npx skills add https://github.com/barneyjm/camino-skills --skill journey

Via clawhub:

npx clawhub@latest install journey
# or: pnpm dlx clawhub@latest install journey
# or: bunx clawhub@latest install journey

Journey - Multi-Stop Planning

Plan multi-waypoint journeys with route optimization, feasibility analysis, and time budget constraints.

Setup

Instant Trial (no signup required): Get a temporary API key with 25 calls:

curl -s -X POST -H "Content-Type: application/json" \
  -d '{"email": "[e-mail]"}' \
  https://api.getcamino.ai/trial/start

Returns: {"api_key": "camino-xxx...", "calls_remaining": 25, ...}

For 1,000 free calls/month, sign up at https://app.getcamino.ai/skills/activate.

Add your key to Claude Code:

Add to your ~/.claude/settings.json:

{
  "env": {
    "CAMINO_API_KEY": "your-api-key-here"
  }
}

Restart Claude Code.

Usage

Via Shell Script

# Plan a simple journey
./scripts/journey.sh '{
  "waypoints": [
    {"lat": 40.7128, "lon": -74.0060, "purpose": "Start at hotel"},
    {"lat": 40.7484, "lon": -73.9857, "purpose": "Visit Empire State Building"},
    {"lat": 40.7614, "lon": -73.9776, "purpose": "Lunch in Midtown"}
  ]
}'

# With transport mode and time budget
./scripts/journey.sh '{
  "waypoints": [
    {"lat": 40.7128, "lon": -74.0060, "purpose": "Start"},
    {"lat": 40.7484, "lon": -73.9857, "purpose": "Empire State"},
    {"lat": 40.7614, "lon": -73.9776, "purpose": "MoMA"}
  ],
  "constraints": {
    "transport": "foot",
    "time_budget": "3 hours"
  }
}'

Via curl

curl -X POST -H "X-API-Key: $CAMINO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "waypoints": [
      {"lat": 40.7128, "lon": -74.0060, "purpose": "Start"},
      {"lat": 40.7484, "lon": -73.9857, "purpose": "Empire State"}
    ],
    "constraints": {"transport": "foot"}
  }' \
  "https://api.getcamino.ai/journey"

Parameters

Field	Type	Required	Default	Description
waypoints	array	Yes	-	List of waypoints with lat, lon, and purpose (min 2)
constraints.transport	string	No	"walking"	Transport mode: "walking", "car", or "bike"
constraints.time_budget	string	No	-	Time constraint (e.g., "2 hours", "90 minutes")
constraints.preferences	array	No	[]	Route preferences

Waypoint Object

Field	Type	Required	Description
lat	float	Yes	Latitude of the waypoint
lon	float	Yes	Longitude of the waypoint
purpose	string	No	Description of why you're visiting this waypoint

Response Format

{
  "feasible": true,
  "total_distance_km": 4.2,
  "total_time_minutes": 52,
  "total_time_formatted": "52 minutes",
  "transport_mode": "foot",
  "route_segments": [
    {
      "from": "Start",
      "to": "Empire State",
      "distance_km": 4.2,
      "duration_minutes": 52
    }
  ],
  "analysis": {
    "summary": "This walking journey is feasible...",
    "optimization_opportunities": []
  }
}

Examples

Day trip planning

./scripts/journey.sh '{
  "waypoints": [
    {"lat": 48.8584, "lon": 2.2945, "purpose": "Eiffel Tower"},
    {"lat": 48.8606, "lon": 2.3376, "purpose": "Louvre Museum"},
    {"lat": 48.8530, "lon": 2.3499, "purpose": "Notre-Dame"},
    {"lat": 48.8867, "lon": 2.3431, "purpose": "Sacré-Cœur"}
  ],
  "constraints": {
    "transport": "foot",
    "time_budget": "6 hours"
  }
}'

Business meeting route

./scripts/journey.sh '{
  "waypoints": [
    {"lat": 40.7128, "lon": -74.0060, "purpose": "Office"},
    {"lat": 40.7580, "lon": -73.9855, "purpose": "Client meeting"},
    {"lat": 40.7614, "lon": -73.9776, "purpose": "Lunch"},
    {"lat": 40.7128, "lon": -74.0060, "purpose": "Return to office"}
  ],
  "constraints": {
    "transport": "car",
    "time_budget": "2 hours"
  }
}'

Cycling tour

./scripts/journey.sh '{
  "waypoints": [
    {"lat": 37.7749, "lon": -122.4194, "purpose": "Start downtown SF"},
    {"lat": 37.8199, "lon": -122.4783, "purpose": "Golden Gate Bridge"},
    {"lat": 37.8270, "lon": -122.4230, "purpose": "Sausalito"}
  ],
  "constraints": {
    "transport": "bike"
  }
}'

Use Cases

• Trip itinerary validation: Check if a planned itinerary is feasible within time constraints
• Route optimization: Get suggestions for optimizing multi-stop journeys
• Travel time estimation: Understand total journey time across multiple destinations
• Tour planning: Plan walking tours, cycling routes, or driving trips