Install all skills from repo Skill

Installation

Companion Skills: This is part of the Camino AI location intelligence suite. Install all available skills (camino-query, camino-places, camino-relationship, camino-context, camino-route, camino-journey, camino-real-estate, camino-hotel-finder, camino-ev-charger, camino-school-finder, camino-parking-finder, camino-fitness-finder, camino-safety-checker, camino-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 camino-query

Via clawhub:

npx clawhub@latest install camino-query
# or: pnpm dlx clawhub@latest install camino-query
# or: bunx clawhub@latest install camino-query

Query - Natural Language Place Search

Search for places using natural language. The AI automatically generates coordinates for known locations when not provided.

Setup

These skills shell out to curl and authenticate via the CAMINO_API_KEY environment variable. Sign up at https://app.getcamino.ai/skills/activate for 100 free calls/month and an API key.

Add your key to Claude Code:

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

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

Restart Claude Code.

Alternative — pay-per-request via x402: Camino's paid endpoints also accept HTTP 402 payments in USDC on Base ($0.001/request) from any x402-capable client, with no signup or API key. These skills don't use this path; it's for agents and clients that speak x402 natively.

Usage

Via Shell Script

# Search for coffee shops near Times Square
./scripts/query.sh '{"query": "coffee shops near Times Square", "limit": 5}'

# Search with specific coordinates
./scripts/query.sh '{"query": "quiet cafes with wifi", "lat": 40.7589, "lon": -73.9851, "radius": 500}'

# Get AI-generated answer with results
./scripts/query.sh '{"query": "best pizza in Manhattan", "answer": true, "rank": true}'

Via curl

curl -H "X-API-Key: $CAMINO_API_KEY" \
  "https://api.getcamino.ai/query?query=coffee+shops+near+Times+Square&limit=5"

Parameters

| Parameter | Type | Required | Default | Description | |-----------|------|----------|---------|-------------| | query | string | Yes* | - | Natural language query (e.g., "coffee shops near Times Square") | | lat | float | No | - | Latitude for search center. AI generates if omitted for known locations. | | lon | float | No | - | Longitude for search center. AI generates if omitted for known locations. | | radius | int | No | 1000 | Search radius in meters (100-50000) | | rank | bool | No | true | Use AI to rank results by relevance | | limit | int | No | 20 | Maximum results (1-100) | | offset | int | No | 0 | Pagination offset | | answer | bool | No | false | Generate human-readable summary | | time | string | No | - | Temporal query: "2020-01-01", "2020..", or "2020..2024" | | osm_ids | string | No | - | Comma-separated OSM IDs (e.g., "node/123,way/456") | | mode | string | No | "basic" | "basic" (OSM only) or "advanced" (web enrichment) | | engine | string | No | auto | Backend: "overture" (BigQuery, default) or "osm" (Overpass). Auto-routes to "osm" when osm_ids or time are set. |

*Either query or osm_ids is required.

Response Format

{
  "query": "quiet coffee shops with wifi",
  "results": [
    {
      "name": "Blue Bottle Coffee",
      "lat": 40.7601,
      "lon": -73.9847,
      "type": "cafe",
      "distance_m": 150,
      "relevance_score": 0.95,
      "address": "..."
    }
  ],
  "ai_ranked": true,
  "pagination": {
    "total_results": 23,
    "limit": 5,
    "offset": 0,
    "has_more": true
  },
  "answer": "I found several quiet coffee shops with wifi near Times Square..."
}

Examples

Find nearby restaurants

./scripts/query.sh '{"query": "Italian restaurants", "lat": 40.7128, "lon": -74.0060, "limit": 10}'

Search with AI answer

./scripts/query.sh '{"query": "best brunch spots in Brooklyn", "answer": true}'

Historical data query

./scripts/query.sh '{"query": "restaurants", "lat": 40.7589, "lon": -73.9851, "time": "2020-01-01"}'

Best Practices

For known locations (cities, landmarks), you can omit lat/lon and let the AI generate coordinates
Use rank: true for more relevant results when searching by attributes (e.g., "quiet", "cheap")
Enable answer: true when you need a natural language summary of results
Use mode: "advanced" for richer place data from web sources
Keep queries descriptive but concise for best AI interpretation

Agent Skills: Install all skills from repo

Install this agent skill to your local

Skill Files