diff --git a/tools/goplaces/skills/goplaces/SKILL.md b/tools/goplaces/skills/goplaces/SKILL.md
index b3d4eea..d2ce91c 100644
--- a/tools/goplaces/skills/goplaces/SKILL.md
+++ b/tools/goplaces/skills/goplaces/SKILL.md
@@ -1,28 +1,30 @@
 ---
 name: goplaces
-description: Google Places API (New) CLI and Go client.
+description: Query Google Places API (New) via the goplaces CLI for text search, place details, resolve, and reviews. Use for human-friendly place lookup or JSON output for scripts.
 homepage: https://github.com/steipete/goplaces
-metadata: {"openclaw":{"emoji":"📍","requires":{"bins":["goplaces"],"env":["GOOGLE_PLACES_API_KEY"]},"primaryEnv":"GOOGLE_PLACES_API_KEY","install":[{"id":"brew","kind":"brew","formula":"steipete/tap/goplaces","bins":["goplaces"],"label":"Install goplaces (brew)"}]}}
+metadata: {"clawdbot":{"emoji":"📍","requires":{"bins":["goplaces"],"env":["GOOGLE_PLACES_API_KEY"]},"primaryEnv":"GOOGLE_PLACES_API_KEY","install":[{"id":"brew","kind":"brew","formula":"steipete/tap/goplaces","bins":["goplaces"],"label":"Install goplaces (brew)"}]}}
 ---
 
 # goplaces
 
-Use `goplaces` for the Google Places API (New).
+Modern Google Places API (New) CLI. Human output by default, `--json` for scripts.
 
-API key
-- `GOOGLE_PLACES_API_KEY`
+Install
+- Homebrew: `brew install steipete/tap/goplaces`
 
-Quick start
-- `goplaces search "coffee" --lat 40.8065 --lng -73.9719 --radius-m 3000 --limit 5`
-- `goplaces autocomplete "cof" --session-token "goplaces-demo" --limit 5`
-- `goplaces details <placeId> --photos --reviews`
-- `goplaces nearby --lat 47.6062 --lng -122.3321 --radius-m 1500 --type cafe --limit 5`
-- `goplaces route "coffee" --from "Seattle, WA" --to "Portland, OR"`
+Config
+- `GOOGLE_PLACES_API_KEY` required.
+- Optional: `GOOGLE_PLACES_BASE_URL` for testing/proxying.
 
-Output tips
-- Use `--json` for machine output.
-- Add `--no-color` when piping.
+Common commands
+- Search: `goplaces search "coffee" --open-now --min-rating 4 --limit 5`
+- Bias: `goplaces search "pizza" --lat 40.8 --lng -73.9 --radius-m 3000`
+- Pagination: `goplaces search "pizza" --page-token "NEXT_PAGE_TOKEN"`
+- Resolve: `goplaces resolve "Soho, London" --limit 5`
+- Details: `goplaces details <place_id> --reviews`
+- JSON: `goplaces search "sushi" --json`
 
 Notes
-- Long flags accept `--flag=value` or `--flag value`.
-- Routes API must be enabled for `route` searches.
+- `--no-color` or `NO_COLOR` disables ANSI color.
+- Price levels: 0..4 (free → very expensive).
+- Type filter sends only the first `--type` value (API accepts one).