romtuck/openclaw
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

docs(grounding-lite): apply Anthropic best practices

Browse Source 
- Add "When to use each tool" section per MCP tool design guidance
- Add Parameters section with per-parameter documentation
- Use natural language (no CRITICAL/MUST per Claude 4.x guidance)
- Maintain concise format while adding essential context

Sources:
- https://www.anthropic.com/engineering/claude-code-best-practices
- https://docs.claude.com/en/docs/build-with-claude/prompt-engineering/claude-4-best-practices
- https://anthropic.skilljar.com/introduction-to-model-context-protocol

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
This commit is contained in:
Ryan Baumann 2026-01-26 11:52:54 -08:00
parent 3bb29a7816
commit 850ba136a4
1 changed files with 42 additions and 17 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

59
skills/grounding-lite/SKILL.md
View File

@ -7,30 +7,55 @@ metadata: {"clawdbot":{"emoji":"🗺️","requires":{"bins":["mcporter"],"env":[
# Grounding Lite
Google Maps Grounding Lite MCP for AI-grounded location data. Experimental (pre-GA), free during preview.
Google Maps Grounding Lite MCP provides AI-grounded location data. Experimental (pre-GA), free during preview.
Setup
- Configure once: `mcporter config add grounding-lite --url https://mapstools.googleapis.com/mcp --header "X-Goog-Api-Key=$GOOGLE_MAPS_API_KEY"`
- Or ad-hoc: `mcporter call "https://mapstools.googleapis.com/mcp.search_places" --header "X-Goog-Api-Key=$GOOGLE_MAPS_API_KEY" text_query="..."`
## When to use each tool
Search places
- **search_places**: Use when the user asks about places, businesses, restaurants, addresses, or points of interest. Returns AI-generated summaries with Google Maps links.
- **lookup_weather**: Use when the user asks about weather conditions or forecasts for a location. Works best with US locations.
- **compute_routes**: Use when the user asks about travel distance, duration, or directions between two locations.
## Setup (one-time)
```
mcporter config add grounding-lite --url https://mapstools.googleapis.com/mcp --header "X-Goog-Api-Key=$GOOGLE_MAPS_API_KEY"
```
## Commands
Search places:
- `mcporter call grounding-lite.search_places text_query="coffee shops near Central Park"`
- With bias: `mcporter call grounding-lite.search_places text_query="pizza" location_bias='{"center":{"latitude":40.7829,"longitude":-73.9654},"radius":2000}'`
- With location bias: `mcporter call grounding-lite.search_places text_query="pizza" location_bias='{"center":{"latitude":40.7829,"longitude":-73.9654},"radius":2000}'`
Lookup weather
Weather lookup:
- `mcporter call grounding-lite.lookup_weather location='{"address":"San Francisco, CA"}' units_system=IMPERIAL`
- By coords: `mcporter call grounding-lite.lookup_weather location='{"lat_lng":{"latitude":37.77,"longitude":-122.41}}'`
- Forecast: `mcporter call grounding-lite.lookup_weather location='{"address":"New York, NY"}' date='{"year":2026,"month":1,"day":28}' hour=14`
- By coordinates: `mcporter call grounding-lite.lookup_weather location='{"lat_lng":{"latitude":37.77,"longitude":-122.41}}'`
Compute routes
Compute routes:
- `mcporter call grounding-lite.compute_routes origin='{"address":"San Francisco, CA"}' destination='{"address":"Los Angeles, CA"}' travel_mode=DRIVE`
- Walking: `mcporter call grounding-lite.compute_routes origin='{"address":"Times Square, NYC"}' destination='{"address":"Central Park, NYC"}' travel_mode=WALK`
- Travel modes: DRIVE (default), WALK
List tools
List available tools:
- `mcporter list grounding-lite --schema`
Notes
- Rate limits: search_places (100 QPM, 1K QPD), lookup_weather (300 QPM), compute_routes (300 QPM)
- Weather has regional restrictions (US locations work; some international may not)
- Responses include Google Maps links - include in user-facing output
- API key security: restrict to `mapstools.googleapis.com` in Cloud Console
## Parameters
**search_places**:
- `text_query` (required): Natural language search query
- `location_bias` (optional): Prioritize results near a location
**lookup_weather**:
- `location` (required): Address, coordinates, or place_id
- `units_system` (optional): METRIC or IMPERIAL
- `date`, `hour` (optional): For forecasts
**compute_routes**:
- `origin`, `destination` (required): Address, coordinates, or place_id
- `travel_mode` (optional): DRIVE or WALK
## Notes
- Rate limits: search_places (100 QPM), lookup_weather (300 QPM), compute_routes (300 QPM)
- Weather has regional restrictions; US locations work reliably
- Include Google Maps links from responses in user-facing output
- Restrict API key to `mapstools.googleapis.com` in Cloud Console