Route between two locations

Get detailed routing between two points with distance, duration, and optional turn-by-turn directions. Use when you need navigation instructions or travel ti...

Security Scan

The skill is internally consistent: it simply validates input and calls the Camino routing API using a single CAMINO_API_KEY; nothing in the files or instructions requests unrelated credentials or system access.

Purpose & Capability

Name and description match the code and instructions: the script builds a query from start/end coordinates and calls https://api.getcamino.ai/route. The only required credential is CAMINO_API_KEY, which is appropriate for this purpose. Note: the registry metadata listed no required binaries, but SKILL.md and the script require curl and jq — this is a minor metadata inconsistency.

Instruction Scope

SKILL.md and scripts stay within scope: they validate JSON, require start/end coords, read CAMINO_API_KEY, and make an HTTPS GET to the Camino API. No instructions to read other files, harvest unrelated env vars, or POST data to third-party endpoints are present. The doc does advise adding the API key to ~/.claude/settings.json and offers a trial endpoint (https://api.getcamino.ai/trial/start), both of which are reasonable for this integration.

Install Mechanism

There is no formal install spec (instruction-only), and the included scripts are simple and static. However, the README suggests installing an entire GitHub repo via npx (npx skills add https://github.com/barneyjm/camino-skills), which will pull remote code — review that repository before running the installer. The provided local script does not download or execute remote code itself.

Credentials

The skill only requests one credential (CAMINO_API_KEY) and uses it directly in API calls. No extra tokens, keys, or unrelated environment variables are requested. This is proportionate to a routing API integration. (Again: SKILL.md expects curl/jq even though registry metadata omitted them.)

Persistence & Privilege

The skill does not request always:true or attempt to modify other skills or system settings. It runs on demand and only requires the user-provided API key to operate.

Assessment

This skill appears to do only routing queries and needs just a CAMINO_API_KEY. Before installing: (1) verify the API host (https://api.getcamino.ai) and the GitHub repo if you plan to use npx to install the whole collection, (2) ensure you have curl and jq installed (SKILL.md and scripts require them), (3) avoid pasting your API key into public places and consider setting it in your agent's config with correct file permissions, and (4) review any remote-install commands (npx/clawhub) to see what code will be executed. The included script is small and straightforward, but installing the full repo could introduce other code — review that repository first.

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 route

Via clawhub:

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

Route - Point-to-Point Navigation

Get detailed routing between two points with distance, duration, and optional turn-by-turn directions.

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

# Get driving directions
./scripts/route.sh '{
  "start_lat": 40.7128,
  "start_lon": -74.0060,
  "end_lat": 40.7589,
  "end_lon": -73.9851
}'

# Walking directions
./scripts/route.sh '{
  "start_lat": 40.7128,
  "start_lon": -74.0060,
  "end_lat": 40.7589,
  "end_lon": -73.9851,
  "mode": "foot"
}'

# With route geometry for mapping
./scripts/route.sh '{
  "start_lat": 40.7128,
  "start_lon": -74.0060,
  "end_lat": 40.7589,
  "end_lon": -73.9851,
  "mode": "bike",
  "include_geometry": true
}'

Via curl

curl -H "X-API-Key: $CAMINO_API_KEY" \
  "https://api.getcamino.ai/route?start_lat=40.7128&start_lon=-74.0060&end_lat=40.7589&end_lon=-73.9851&mode=car"

Parameters

Parameter	Type	Required	Default	Description
start_lat	float	Yes	-	Starting latitude
start_lon	float	Yes	-	Starting longitude
end_lat	float	Yes	-	Ending latitude
end_lon	float	Yes	-	Ending longitude
mode	string	No	"car"	Transport mode: "car", "bike", or "foot"
include_geometry	bool	No	false	Include detailed route geometry for mapping
include_imagery	bool	No	false	Include street-level imagery at waypoints

Response Format

{
  "distance_km": 6.8,
  "duration_minutes": 18,
  "mode": "car",
  "summary": "Head north on Broadway, then east on 42nd Street",
  "steps": [
    {
      "instruction": "Head north on Broadway",
      "distance_m": 2400,
      "duration_s": 420
    },
    {
      "instruction": "Turn right onto 42nd Street",
      "distance_m": 1800,
      "duration_s": 300
    }
  ]
}

Examples

Walking directions

./scripts/route.sh '{
  "start_lat": 51.5074,
  "start_lon": -0.1278,
  "end_lat": 51.5014,
  "end_lon": -0.1419,
  "mode": "foot"
}'

Cycling with geometry

./scripts/route.sh '{
  "start_lat": 37.7749,
  "start_lon": -122.4194,
  "end_lat": 37.8199,
  "end_lon": -122.4783,
  "mode": "bike",
  "include_geometry": true
}'

Driving directions with imagery

./scripts/route.sh '{
  "start_lat": 40.7128,
  "start_lon": -74.0060,
  "end_lat": 40.7589,
  "end_lon": -73.9851,
  "mode": "car",
  "include_imagery": true
}'

Use Cases

• Navigation: Get turn-by-turn directions for any transport mode
• Travel time estimation: Know how long it takes to get between two points
• Map visualization: Include geometry data for drawing routes on maps
• Commute planning: Compare driving, cycling, and walking times