Skip to content

Conversation

@ryanbaumann
Copy link
Collaborator

Summary

Adds a Google Maps Platform Agent Skill following the AgentSkills.io v1.0 specification. This skill embeds foundational context directly into skill-aware agents, reducing latency by eliminating the need for an extra retrieve-instructions tool call before each query.

Key Benefits

  • Reduced Latency: Context loaded at startup, not on every query
  • Improved Reliability: Works even if backend RAG service is slow/unavailable
  • Progressive Disclosure: Only loads detailed reference files when needed
  • Cross-Platform: Compatible with Claude Code, Cursor, Windsurf, Roo Code, Gemini CLI, Codex

Files Added

File Description
skills/google-maps-platform/SKILL.md Core skill with AgentSkills.io frontmatter (~3500 tokens)
skills/google-maps-platform/references/code-examples.md Web/Android/iOS/Flutter examples with attribution IDs
skills/google-maps-platform/references/decision-trees.md ASCII decision trees for API selection
skills/google-maps-platform/references/eea-compliance.md EU Digital Markets Act requirements
skills/google-maps-platform/references/attribution.md Attribution ID integration guide
BACKLOG.md Deprecation plan for retrieve-instructions tool (v1.0)

Files Modified

File Change
package.json Added "skills" to files array for npm bundling
README.md Added Agent Skill section with installation instructions
CHANGELOG.md Added [Unreleased] section with feature documentation

Testing

  • npm run build - Passed (bundled 465 modules)
  • npm test - 43 tests passed, 0 failed

Attribution

All code examples include the required attribution ID: gmp_mcp_codeassist_v0.1_github

Notes

  • The retrieve-instructions tool is NOT deprecated in this PR (per user request)
  • Tool description changes deferred to future PR
  • PLAN.md excluded from commit (planning document only)

- Create skill directory with SKILL.md following AgentSkills.io v1.0 spec
- Add reference files for code examples, decision trees, EEA compliance, attribution
- All code examples include required attribution ID: gmp_mcp_codeassist_v0.1_github
- Bundle skills/ directory with npm package
- Add skill installation instructions to README
- Create BACKLOG.md with deprecation plan for retrieve-instructions tool (v1.0)

Compatible with: Claude Code, Cursor, Windsurf, Roo Code, Gemini CLI, Codex
@snippet-bot
Copy link

snippet-bot bot commented Jan 21, 2026

Here is the summary of changes.

You are about to add 1 region tag.

This comment is generated by snippet-bot.
If you find problems with this result, please file an issue at:
https://github.com/googleapis/repo-automation-bots/issues.
To update this comment, add snippet-bot:force-run label or use the checkbox below:

  • Refresh this comment

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant