diff --git a/skills/grounding-lite/SKILL.md b/skills/grounding-lite/SKILL.md
index 7c9953173..c65a6cd62 100644
--- a/skills/grounding-lite/SKILL.md
+++ b/skills/grounding-lite/SKILL.md
@@ -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