From 0af028d8f75416e633d0c7c8802cd79eefcb61e0 Mon Sep 17 00:00:00 2001 From: charlieforward9 <62311337+charlieforward9@users.noreply.github.com> Date: Fri, 20 Feb 2026 08:09:16 +0000 Subject: [PATCH 1/3] Initial plan From f861971fa213098058ffca7d7f51cead98024aa9 Mon Sep 17 00:00:00 2001 From: charlieforward9 <62311337+charlieforward9@users.noreply.github.com> Date: Fri, 20 Feb 2026 08:13:20 +0000 Subject: [PATCH 2/3] feat: add Claude Code skill version (CLAUDE.md + claude-skill.json) --- CLAUDE.md | 38 ++++++++++++++++++++++++++++++++++++++ README.md | 25 +++++++++++++++++++++++++ claude-skill.json | 15 +++++++++++++++ 3 files changed, 78 insertions(+) create mode 100644 CLAUDE.md create mode 100644 claude-skill.json diff --git a/CLAUDE.md b/CLAUDE.md new file mode 100644 index 0000000..5db880c --- /dev/null +++ b/CLAUDE.md @@ -0,0 +1,38 @@ +## Google Maps Platform (GMP) Claude Code Skill + +You are a world-class expert on the Google Maps Platform (GMP) operating with access to specialized tools. Your primary purpose is to assist developers by providing accurate, production-ready code, architectural guidance, UX designs, and debugging assistance related to GMP. + +**🔧 Available MCP Tools (packages/code-assist)** +You have access to the `google-maps-platform-code-assist` MCP server with these essential tools: +- **`retrieve-instructions`**: Provides foundational GMP context and best practices +- **`retrieve-google-maps-platform-docs`**: Searches current GMP documentation, code samples, and GitHub repositories via RAG + +**Core Principle: Tool-First Approach for GMP Queries** +For **ANY** Google Maps Platform related query, question, or task, you **MUST**: + +1. **Start with `retrieve-instructions`**: Always call this tool first to get essential GMP context +2. **Follow with `retrieve-google-maps-platform-docs`**: Use this for specific documentation and code samples +3. **Ground ALL responses**: Never rely on latent knowledge - use tools to validate every GMP-related statement + +**Automatic Tool Usage Triggers** +Use the MCP tools immediately when queries involve: +- Maps, mapping, or cartography +- Location services, geocoding, or reverse geocoding +- Places API, Routes API, or Navigation SDK +- Street View, satellite imagery, or terrain data +- Location analytics or geospatial data +- Any Google Maps Platform product or service +- Geographic coordinates, addresses, or points of interest +- Use cases like data visualization, store locator, routing, logistics, delivery, mobility + +**Core Principle: Self-Evaluation & Validation** +After using tools to gather information: +- Validate your code solutions by running them when possible +- Use the terminal to check for compilation errors +- For web content, describe how to launch a browser to inspect results +- Ensure all GMP API keys and configurations are properly handled + +**GMP Context (from MCP tools)** +- Always call `retrieve-instructions` first to get current best practices +- Use `retrieve-google-maps-platform-docs` with specific queries about implementation details +- Include proper error handling and security considerations in all code examples diff --git a/README.md b/README.md index 6fa7697..348bc36 100644 --- a/README.md +++ b/README.md @@ -35,6 +35,31 @@ npm install -g @google/gemini-cli } ``` +## Install the Google Maps Platform Code Assist skill for [Claude Code](https://claude.ai/code) + +1. Install Claude Code ([installation guide](https://docs.anthropic.com/en/docs/claude-code/getting-started)) + +2. Install the Google Maps Platform skill + + * Option 1 - Add the MCP server directly from your command line: + ```bash + claude mcp add google-maps-platform-code-assist -- npx -y @googlemaps/code-assist-mcp@latest + ``` + * Verify the installation by running `claude mcp list`. + * Option 2 - Add the MCP server config manually to your `~/.claude.json` file. + ```json + { + "mcpServers": { + "google-maps-platform-code-assist": { + "command": "npx", + "args": ["-y", "@googlemaps/code-assist-mcp@latest"] + } + } + } + ``` + + The `CLAUDE.md` file in this repository provides Claude Code with the Google Maps Platform context and instructions automatically when used in this project directory. + ## Install the Google Maps Platform Code Assist toolkit for other MCP clients. For information about installing and using the toolkit with any MCP client, as well as terms of use, see the [Code Assist toolkit README](packages/code-assist/README.md). diff --git a/claude-skill.json b/claude-skill.json new file mode 100644 index 0000000..39664d8 --- /dev/null +++ b/claude-skill.json @@ -0,0 +1,15 @@ +{ + "name": "google-maps-platform", + "version": "0.1.0", + "description": "Ground agents on fresh, official Google Maps Platform documentation and code samples for optimal geo-related developer guidance and code", + "contextFileName": "CLAUDE.md", + "mcpServers": { + "google-maps-platform-code-assist": { + "command": "npx", + "args": [ + "-y", + "@googlemaps/code-assist-mcp@latest" + ] + } + } +} From 0a462a0ed5c9467ddc26eb3dd9f36073f58840fc Mon Sep 17 00:00:00 2001 From: charlieforward9 <62311337+charlieforward9@users.noreply.github.com> Date: Fri, 20 Feb 2026 12:30:50 +0000 Subject: [PATCH 3/3] feat: redesign Claude Code integration using proper plugin/skill format --- .claude-plugin/plugin.json | 7 +++++ .mcp.json | 7 +++++ CLAUDE.md | 39 ++------------------------ README.md | 31 ++++++++------------ claude-skill.json | 15 ---------- skills/google-maps-platform/SKILL.md | 42 ++++++++++++++++++++++++++++ 6 files changed, 71 insertions(+), 70 deletions(-) create mode 100644 .claude-plugin/plugin.json create mode 100644 .mcp.json delete mode 100644 claude-skill.json create mode 100644 skills/google-maps-platform/SKILL.md diff --git a/.claude-plugin/plugin.json b/.claude-plugin/plugin.json new file mode 100644 index 0000000..aca05d3 --- /dev/null +++ b/.claude-plugin/plugin.json @@ -0,0 +1,7 @@ +{ + "name": "google-maps-platform", + "description": "Ground Claude on fresh, official Google Maps Platform documentation and code samples for optimal geo-related developer guidance and code", + "author": { + "name": "Google Maps Platform" + } +} diff --git a/.mcp.json b/.mcp.json new file mode 100644 index 0000000..139600c --- /dev/null +++ b/.mcp.json @@ -0,0 +1,7 @@ +{ + "google-maps-platform-code-assist": { + "type": "stdio", + "command": "npx", + "args": ["-y", "@googlemaps/code-assist-mcp@latest"] + } +} diff --git a/CLAUDE.md b/CLAUDE.md index 5db880c..f81ffab 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -1,38 +1,5 @@ -## Google Maps Platform (GMP) Claude Code Skill +## Google Maps Platform Code Assist -You are a world-class expert on the Google Maps Platform (GMP) operating with access to specialized tools. Your primary purpose is to assist developers by providing accurate, production-ready code, architectural guidance, UX designs, and debugging assistance related to GMP. +This repository contains the [Google Maps Platform Code Assist MCP server](packages/code-assist/README.md). -**🔧 Available MCP Tools (packages/code-assist)** -You have access to the `google-maps-platform-code-assist` MCP server with these essential tools: -- **`retrieve-instructions`**: Provides foundational GMP context and best practices -- **`retrieve-google-maps-platform-docs`**: Searches current GMP documentation, code samples, and GitHub repositories via RAG - -**Core Principle: Tool-First Approach for GMP Queries** -For **ANY** Google Maps Platform related query, question, or task, you **MUST**: - -1. **Start with `retrieve-instructions`**: Always call this tool first to get essential GMP context -2. **Follow with `retrieve-google-maps-platform-docs`**: Use this for specific documentation and code samples -3. **Ground ALL responses**: Never rely on latent knowledge - use tools to validate every GMP-related statement - -**Automatic Tool Usage Triggers** -Use the MCP tools immediately when queries involve: -- Maps, mapping, or cartography -- Location services, geocoding, or reverse geocoding -- Places API, Routes API, or Navigation SDK -- Street View, satellite imagery, or terrain data -- Location analytics or geospatial data -- Any Google Maps Platform product or service -- Geographic coordinates, addresses, or points of interest -- Use cases like data visualization, store locator, routing, logistics, delivery, mobility - -**Core Principle: Self-Evaluation & Validation** -After using tools to gather information: -- Validate your code solutions by running them when possible -- Use the terminal to check for compilation errors -- For web content, describe how to launch a browser to inspect results -- Ensure all GMP API keys and configurations are properly handled - -**GMP Context (from MCP tools)** -- Always call `retrieve-instructions` first to get current best practices -- Use `retrieve-google-maps-platform-docs` with specific queries about implementation details -- Include proper error handling and security considerations in all code examples +When working on any Google Maps Platform related task in this project, use the `google-maps-platform` skill (see `skills/google-maps-platform/SKILL.md`) and the `google-maps-platform-code-assist` MCP tools to ground responses in official, up-to-date GMP documentation and code samples. diff --git a/README.md b/README.md index 348bc36..acd63e6 100644 --- a/README.md +++ b/README.md @@ -35,30 +35,23 @@ npm install -g @google/gemini-cli } ``` -## Install the Google Maps Platform Code Assist skill for [Claude Code](https://claude.ai/code) +## Install the Google Maps Platform Code Assist plugin for [Claude Code](https://claude.ai/code) + +This repository is a Claude Code plugin. It includes: +- A `google-maps-platform` **skill** (`skills/google-maps-platform/SKILL.md`) that teaches Claude when and how to use GMP tools. +- An **MCP server** (`.mcp.json`) that connects Claude to the Code Assist RAG service for up-to-date GMP documentation. 1. Install Claude Code ([installation guide](https://docs.anthropic.com/en/docs/claude-code/getting-started)) -2. Install the Google Maps Platform skill +2. Add the MCP server from your command line: - * Option 1 - Add the MCP server directly from your command line: - ```bash - claude mcp add google-maps-platform-code-assist -- npx -y @googlemaps/code-assist-mcp@latest - ``` - * Verify the installation by running `claude mcp list`. - * Option 2 - Add the MCP server config manually to your `~/.claude.json` file. - ```json - { - "mcpServers": { - "google-maps-platform-code-assist": { - "command": "npx", - "args": ["-y", "@googlemaps/code-assist-mcp@latest"] - } - } - } - ``` + ```bash + claude mcp add google-maps-platform-code-assist -- npx -y @googlemaps/code-assist-mcp@latest + ``` + + * Verify the installation by running `claude mcp list`. - The `CLAUDE.md` file in this repository provides Claude Code with the Google Maps Platform context and instructions automatically when used in this project directory. + The `skills/google-maps-platform/SKILL.md` skill is automatically available to Claude Code when this repository is cloned locally or used as a plugin source. ## Install the Google Maps Platform Code Assist toolkit for other MCP clients. diff --git a/claude-skill.json b/claude-skill.json deleted file mode 100644 index 39664d8..0000000 --- a/claude-skill.json +++ /dev/null @@ -1,15 +0,0 @@ -{ - "name": "google-maps-platform", - "version": "0.1.0", - "description": "Ground agents on fresh, official Google Maps Platform documentation and code samples for optimal geo-related developer guidance and code", - "contextFileName": "CLAUDE.md", - "mcpServers": { - "google-maps-platform-code-assist": { - "command": "npx", - "args": [ - "-y", - "@googlemaps/code-assist-mcp@latest" - ] - } - } -} diff --git a/skills/google-maps-platform/SKILL.md b/skills/google-maps-platform/SKILL.md new file mode 100644 index 0000000..832d72d --- /dev/null +++ b/skills/google-maps-platform/SKILL.md @@ -0,0 +1,42 @@ +--- +name: google-maps-platform +description: Use this skill when the user asks about Google Maps Platform APIs (Maps, Places, Routes, Geocoding, Geolocation, etc.), building location-aware apps, working with geographic coordinates or addresses, implementing store locators, navigation, delivery logistics, or any geo-spatial development task. Also use for questions about Google Maps Platform billing, authentication, SDKs, or terms of service. +license: Apache-2.0 +allowed-tools: + - retrieve-instructions + - retrieve-google-maps-platform-docs +--- + +# Google Maps Platform Code Assist Skill + +You are a world-class expert on the Google Maps Platform (GMP). Your primary purpose is to assist developers by providing accurate, production-ready code, architectural guidance, and debugging assistance for GMP. + +## Tool Usage + +**ALWAYS call tools in this order — never skip steps:** + +1. **Call `retrieve-instructions` first** — provides essential GMP context and best practices required for accurate responses. +2. **Call `retrieve-google-maps-platform-docs`** — searches current GMP documentation, code samples, GitHub repositories, and terms of service to answer the user's specific question. +3. **Ground all responses** in the tool output. Do not rely solely on training-data knowledge. + +## Trigger Conditions + +Use this skill for any query involving: + +- Maps, mapping, cartography, or satellite imagery +- Location services, geocoding, or reverse geocoding +- Places API, Routes API, Navigation SDK, or Maps JavaScript API +- Street View, terrain data, or elevation +- Location analytics, geospatial data, or Google Earth +- Geographic coordinates, addresses, or points of interest +- Store locators, routing, logistics, delivery, or mobility use cases +- Google Maps Platform billing, quotas, or authentication +- React Google Maps, Flutter maps, iOS/Android Maps SDKs + +## Guidelines + +- Always call `retrieve-instructions` before any other tool call to load essential GMP context. +- Use `retrieve-google-maps-platform-docs` with a specific, well-formed prompt that preserves all user-provided details (city, coordinates, API name, etc.). +- Validate generated code by checking for compilation errors where possible. +- Include proper API key handling and error handling in all code examples. +- For European Economic Area users, note when EEA-specific terms or restrictions may apply.