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.
86
83%
Does it follow best practices?
Impact
97%
3.88xAverage score across 3 eval scenarios
Advisory
Suggest reviewing before use
Quality
Discovery
67%Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.
The description is strong in specificity and distinctiveness, clearly naming the tool, API, and supported operations. However, it falls short on trigger term quality by using mostly technical terms rather than natural user language, and the 'when to use' guidance is implicit rather than explicit, which caps completeness.
Suggestions
Add an explicit 'Use when...' clause with natural trigger terms, e.g., 'Use when the user asks to find places, look up business details, search for restaurants or shops, or retrieve Google Maps reviews.'
Include common natural language variations users might say, such as 'find nearby', 'business hours', 'restaurant search', 'location info', or 'Google Maps'.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Lists multiple specific concrete actions: 'text search, place details, resolve, and reviews' via a named CLI tool ('goplaces'). Also specifies output modes: 'human-friendly place lookup or JSON output for scripts.' | 3 / 3 |
Completeness | The 'what' is well-covered (query Google Places API via goplaces CLI for text search, details, resolve, reviews). However, the 'when' is only weakly implied with 'Use for human-friendly place lookup or JSON output for scripts' — this doesn't provide explicit trigger guidance like 'Use when the user asks about...'. | 2 / 3 |
Trigger Term Quality | Includes some relevant keywords like 'Google Places API', 'place lookup', 'reviews', 'text search', and 'goplaces CLI', but misses common natural user terms like 'find a restaurant', 'nearby places', 'location search', 'business info', or 'maps'. | 2 / 3 |
Distinctiveness Conflict Risk | Very distinct niche: specifically targets Google Places API (New) via a named CLI tool 'goplaces'. Unlikely to conflict with other skills due to the specific API and tool references. | 3 / 3 |
Total | 10 / 12 Passed |
Implementation
100%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This is an excellent, concise skill that provides exactly what Claude needs to use the goplaces CLI effectively. It assumes competence, provides concrete executable examples for all major commands, and is well-structured with clear sections. The only minor improvement would be showing an example of chaining commands or noting error handling for missing API keys, but these are not significant gaps.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Extremely lean and efficient. Every line provides new, non-obvious information (install source, env vars, CLI flags with examples). No unnecessary explanation of what Google Places API is or how CLIs work. | 3 / 3 |
Actionability | All commands are copy-paste ready with realistic arguments. Covers the main use cases (search, resolve, details, JSON output, pagination, geo-biasing) with concrete flag examples. | 3 / 3 |
Workflow Clarity | This is a simple, single-purpose CLI skill with no multi-step or destructive operations. The commands are unambiguous and self-contained, which is appropriate for a lookup/query tool. | 3 / 3 |
Progressive Disclosure | For a skill under 50 lines with a single-purpose CLI, the content is well-organized into clear sections (Install, Config, Common commands, Notes) with no need for external references. | 3 / 3 |
Total | 12 / 12 Passed |
Validation
72%Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.
Validation — 8 / 11 Passed
Validation for skill structure
| Criteria | Description | Result |
|---|---|---|
metadata_version | 'metadata.version' is missing | Warning |
metadata_field | 'metadata' should map string keys to string values | Warning |
frontmatter_unknown_keys | Unknown frontmatter key(s) found; consider removing or moving to metadata | Warning |
Total | 8 / 11 Passed | |
af8bd5f
Table of Contents
If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.