From 235ddd0527bd97a9fb1e2fa3103c39c53bb06355 Mon Sep 17 00:00:00 2001 From: Caio Moreira Date: Mon, 17 Aug 2026 16:53:04 -0300 Subject: [PATCH] docs(skills): update agent skills references to googlemaps/agent-skills --- GEMINI.md | 2 +- README.md | 17 ++++++++--- gemini-extension.json | 3 -- packages/code-assist/README.md | 9 ++++-- .../skills/gmp-code-assist/skill.md | 29 ------------------- 5 files changed, 21 insertions(+), 39 deletions(-) delete mode 100644 packages/code-assist/skills/gmp-code-assist/skill.md diff --git a/GEMINI.md b/GEMINI.md index a6fdf9c..2f98e49 100644 --- a/GEMINI.md +++ b/GEMINI.md @@ -43,7 +43,7 @@ After using tools to gather information: When setting up or debugging remote MCP servers (like Code Assist), it's critical to understand that modern implementations use **Streamable HTTP** endpoints (single-connection HTTP POST/GET streams) rather than the legacy two-connection SSE architectures. Keep the following client-specific formats in mind: - **MCP Spec** ([Docs](https://modelcontextprotocol.io/docs/concepts/transports)): Official reference distinguishing `stdio`, `streamable-http`, and legacy `sse`. - **Gemini CLI** ([Docs](https://geminicli.com/docs/tools/mcp-server/)): Uses `--transport http` in the CLI. In `settings.json` and `gemini-extension.json`, it uniquely requires the `httpUrl` property instead of the standard `url` and `type` fields. -- **Gemini Extensions** ([Docs](https://geminicli.com/docs/extensions/)): The recommended distribution mechanism is packaging the MCP server config alongside this very `GEMINI.md` and `SKILLS.md` into an extension (installed via `gemini extensions install ` or from the marketplace via `gemini extensions install google-maps-platform`). +- **Gemini Extensions** ([Docs](https://geminicli.com/docs/extensions/)): The recommended distribution mechanism is packaging the MCP server config alongside this very `GEMINI.md` into an extension (installed via `gemini extensions install ` or from the marketplace via `gemini extensions install google-maps-platform`). Dedicated agent skills are hosted separately at [googlemaps/agent-skills](https://github.com/googlemaps/agent-skills). - **Android Studio** ([Docs](https://developer.android.com/studio/gemini/add-mcp-server)): Enabled via Settings > Tools > AI > MCP Servers. Expects an `httpUrl` property in its internal `mcp.json` exactly like Gemini CLI. - **Antigravity** ([Docs](https://antigravity.google)): Use the built-in MCP Store in the agent panel, or manually configure the streamable HTTP endpoint in `mcp_config.json`. - **Claude Code** ([Docs](https://docs.anthropic.com/en/docs/agents-and-tools/claude-code/overview)): Uses the `claude mcp add http ` CLI command. Manual configs define the `mcpServers` object with `"type": "streamable-http"`. diff --git a/README.md b/README.md index 6ee243c..ab6e733 100644 --- a/README.md +++ b/README.md @@ -29,7 +29,7 @@ npm install -g @google/gemini-cli ``` 2. Install the Google Maps Platform extension - - Option 1 - Install Code Assist as a Gemini CLI extension with a skill, the Code Assist MCP tool, and a Google Maps Platform CLI theme: + - Option 1 - Install Code Assist as a Gemini CLI extension (includes context prompt, Code Assist MCP tool, and Google Maps Platform CLI theme): ```bash gemini extensions install https://github.com/googlemaps/platform-ai.git ``` @@ -39,13 +39,22 @@ npm install -g @google/gemini-cli ```json { "mcpServers": { - "gmp-code-assist": { - "httpUrl": "https://mapscodeassist.googleapis.com/mcp" - } + "gmp-code-assist": { + "httpUrl": "https://mapscodeassist.googleapis.com/mcp" + } } } ``` +## **Google Maps Platform Agent Skills** + +To equip your AI agents with specialized, portable Google Maps Platform workflows and best practices, check out the official [Google Maps Platform Agent Skills repository](https://github.com/googlemaps/agent-skills). + +Install the agent skills in Gemini CLI: +```bash +gemini skills install https://github.com/googlemaps/agent-skills.git +``` + ## 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/gemini-extension.json b/gemini-extension.json index dc386d6..e63ebbb 100644 --- a/gemini-extension.json +++ b/gemini-extension.json @@ -3,9 +3,6 @@ "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": "GEMINI.md", - "skills": { - "gmp-code-assist": "packages/code-assist/skills/gmp-code-assist" - }, "mcpServers": { "gmp-code-assist": { "httpUrl": "https://mapscodeassist.googleapis.com/mcp" diff --git a/packages/code-assist/README.md b/packages/code-assist/README.md index 9a72ee8..58efce2 100644 --- a/packages/code-assist/README.md +++ b/packages/code-assist/README.md @@ -80,11 +80,16 @@ The Code Assist MCP server is securely hosted by Google. No authentication is re Add the remote server URL to your preferred AI client's MCP configuration file or settings UI. Find your client below for specific, verified instructions. 1. **Gemini CLI** - - Option 1 (Recommended) - Install the Code Assist MCP server as a Gemini CLI extension. This provides the most complete experience, including specialized developer skills: + - Option 1 (Recommended) - Install the Code Assist MCP server as a Gemini CLI extension (includes context prompt, Code Assist MCP tool, and Google Maps Platform theme): ```bash gemini extensions install https://github.com/googlemaps/platform-ai.git ``` - _(Alternatively, you can install it directly from the Extension Marketplace using `gemini extensions install google-maps-platform`)_ + _(Alternatively, you can install it directly from the Extension Marketplace using `gemini extensions install google-maps-platform`.)_ + + To also install Google Maps Platform Agent Skills, see [googlemaps/agent-skills](https://github.com/googlemaps/agent-skills): + ```bash + gemini skills install https://github.com/googlemaps/agent-skills.git + ``` - Option 2 - Use the `mcp add` CLI command to add the server cleanly: ```bash gemini mcp add --transport http gmp-code-assist https://mapscodeassist.googleapis.com/mcp diff --git a/packages/code-assist/skills/gmp-code-assist/skill.md b/packages/code-assist/skills/gmp-code-assist/skill.md deleted file mode 100644 index dc3c873..0000000 --- a/packages/code-assist/skills/gmp-code-assist/skill.md +++ /dev/null @@ -1,29 +0,0 @@ ---- -name: gmp-code-assist -description: Expert assistant for Google Maps Platform development (Maps, Routes, Places, Environment APIs). Make sure to use this skill whenever the user mentions mapping, routing, location services, or Google Maps Platform, even if they don't explicitly ask for an assistant or use the word 'maps'. Use for coding, debugging, architecture, and solutioning. ---- - - -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. - - - -**Reasoning & Effective Use of GMP Code Assist** -When assisting with Google Maps Platform tasks, please adopt an analytical and specific reasoning process. Because GMP APIs update frequently and parameters change, it is best to avoid relying purely on your latent knowledge. Validate your assumptions through your available retrieval tools to ensure you don't confidently return outdated syntax or unsupported features. - -**Tool Workflow Strategy: Documentation & Context** -1. **Begin your workflow by calling the `retrieve-instructions` tool.** This is essential to ground yourself in the latest 2026+ foundational best practices and context for the platform. -2. After digesting the instructions, formulate highly targeted searches against the documentation tool based on that context. - -**Crafting Targeted Search Queries** -When making queries to your documentation retrieval tool, distinguish clearly between the distinct types of information you require: -- **Specific Product Names & Code**: For syntax or implementation details, mention the exact API or SDK name (e.g., "Places API Autocomplete", "Maps SDK for Android", "Deck.gl interleaved mode"). -- **Pricing & Quotas**: If evaluating cost, explicitly ask for "Pricing tables", "SKU costs", or "Usage limits" alongside the exact product name. -- **Architectural / Other Lookups**: Distinguish queries for high-level architectures, best practices, or specific SLA lookups from raw code generation. - -**Required Specificity for Requests** -To get the most relevant chunks from the RAG service, explicitly articulate all variables of your problem in your query: -- Specify the exact kind of help you are looking for (e.g., "React code sample", "troubleshooting an invalid request error", "migration guide"). -- Include the specific product names. -- Detail the exact solution names or use cases (e.g., "Store Locator integration", "Last Mile Delivery routing", "Checkout Address Validation"). -