\n\n[](https://www.claudepluginhub.com/plugins/jpantsjoha-googlecloud-plugin?ref=badge)\n[](https://agent-plugins.org/specification)\n[](https://agentskills.io/specification)\n\n# GoogleCloud Plugin\n\n> **Install once, and your coding agent gains a full Google Cloud delivery team — a vendor-objective solution designer, a GCP architect, an agentic-systems architect, plus security, SRE, and QA — wired into a design-first, security-first delivery gate.**\n\n> **All the GCP skills. All the MCP servers available today. Assembled to fast-track the right architecture for your requirements.**\n\nSkill libraries for Google Cloud are everywhere. What they miss is the operating contract: who designs before anyone writes code, who signs off on least-privilege before anything deploys, what \"done\" means when an agent ships to a billable cloud. This plugin ships that contract, with the GCP know-how built in.\n\nOne install gives an agent (Claude, Codex, or Antigravity) six personas, eleven service skills, and a research pipeline that keeps every reference current. A plugin that goes stale in silence is worse than none.\n\n**Compliant with [Agent Plugins 1.0.0](https://agent-plugins.org/specification)** — the open, vendor-neutral packaging standard co-maintained by Amazon, Cursor, Google, Microsoft, OpenAI and Vercel ([announcement](https://developers.googleblog.com/agent-plugins-package-your-skills-tools-and-more/)) — and with the [Agent Skills specification](https://agentskills.io/specification) it references. One directory layout works across conformant clients, rather than a bespoke wrapper per harness. Enforced in CI by `make spec` and verified against the official reference validator; see [Standards and compliance](#standards-and-compliance).\n\nThe plugin is **GCP-only and opinionated by design**. It covers the services a builder reaches for — Firebase, Cloud Run, BigQuery, GKE — and the agent frameworks now built on top: ADK, and the MCP / A2A / AP2 protocol stack, deployed on the Gemini Enterprise Agent Platform. Refine it for your team. Keep the contract coherent as you do.\n\n> **Speed is easy. Safe speed is engineered.**\n\n---\n\n## Install\n\nOne plugin, four coding assistants. Skills live in `skills/`; each harness reads its own manifest.\n\n**Claude Code**\n\n```text\n/plugin marketplace add jpantsjoha/googlecloud-plugin\n/plugin install googlecloud-plugin@googlecloud-plugin-marketplace\n```\n\n**Antigravity (Gemini)**\n\n```bash\nagy plugin install https://github.com/jpantsjoha/googlecloud-plugin\n```\n\n**Kimi Code**\n\n```text\n/plugins install https://github.com/jpantsjoha/googlecloud-plugin\n```\n\n**Codex** — no install step. Codex discovers `.agents/skills/` natively and reads `AGENTS.md` as its always-on adapter. Clone the repo and Codex picks up the contract:\n\n```bash\ngit clone https://github.com/jpantsjoha/googlecloud-plugin\n```\n\nAfter cloning to work on the plugin itself, install the pre-commit gate once:\n\n```bash\nmake hooks # runs `make gate` (validate + manifest + mermaid + lint + test) on every commit\n```\n\nThe plugin running in Antigravity — asked what it is and how it delivers value, the agent introduces the team and the delivery gate:\n\n
\n \n
\n\n---\n\n## The Solution → Delivery Workflow\n\nEvery piece of work flows through sequential gates. No gate opens until the one before it clears. Human intent enters at the top; a human authorises production at the bottom. The AI personas scale the execution in between — they never grant their own authority.\n\n```mermaid\n%%{init: {'theme':'neutral', 'sequence': {'useMaxWidth': true, 'diagramMarginX': 24, 'diagramMarginY': 18, 'actorMargin': 44, 'boxMargin': 15, 'boxTextMargin': 8, 'noteMargin': 12, 'messageMargin': 42}}}%%\nsequenceDiagram\n autonumber\n actor Req as Requirement\n participant Sol as solution-designer\n participant Arch as gcp-architect + agent-architect\n participant Sec as gcp-security\n participant Impl as Service Skills\n participant QA as gcp-qa\n actor Ops as gcp-ops\n\n rect rgb(238, 242, 255)\n note over Req,Sol: Solution Gate — is this even GCP? (skip if unambiguously GCP-only)\n Req->>Sol: 1. Submit intent / problem\n Sol-->>Arch: 2. Master HLD + vendor scope (hands GCP slice down)\n end\n\n rect rgb(237, 233, 254)\n note over Arch: GCP Design Gate — design before code\n Arch->>Arch: 3. GCP HLD/LLD + ADRs (agentic: topology, protocols, model, eval set)\n end\n\n rect rgb(252, 231, 243)\n note over Arch,Sec: Security Gate — reviews the design, not the diff\n Arch->>Sec: 4. Submit design\n Sec-->>Impl: 5. Least-privilege IAM, no secrets, WAF pillar — pass or BLOCK\n end\n\n rect rgb(240, 253, 244)\n note over Sec,Impl: Implementation — known-good GCP patterns, cost-warned\n Impl->>Impl: 6. Build on google-cloud patterns, warn before every billable action\n end\n\n rect rgb(254, 249, 231)\n note over Impl,QA: Quality Gate — receipts, not polish\n Impl->>QA: 7. Submit candidate\n QA-->>Ops: 8. make gate (all checks) + agent-eval — pass or BLOCK\n end\n\n rect rgb(224, 242, 254)\n note over QA,Ops: Operational Readiness Gate — no dark production\n Ops->>Ops: 9. SLO + alerting + runbook present?\n Ops-->>Req: 10. Authorise release & emit status\n end\n```\n\n### Gate ownership\n\n| Gate | Owner | Blocks release when |\n| :--- | :--- | :--- |\n| **Solution** | `solution-designer` | Vendor choice unclear, or GCP scope not delimited (skips if GCP-only) |\n| **GCP Design** | `gcp-architect` (+ `agent-architect` if agentic) | No GCP HLD, or HLD contradicts the solution design |\n| **Security** | `gcp-security` | IAM over-permissive, secrets in code, GCP risks unaddressed |\n| **Quality** | `gcp-qa` (+ `agent-architect` agent-eval) | `make gate` fails, acceptance criteria unmet, agent eval fails |\n| **Operational Readiness** | `gcp-ops` | No SLO, alerting, or runbook for a production workload |\n\nThe rule underneath every gate: **infer intent, never infer permission.** An AI persona drafts, designs, and validates; a named human authorises anything consequential, billable, or irreversible.\n\n---\n\n## What you install\n\n**Six personas** — the team:\n\n| Persona | Tier | Owns |\n| :--- | :--- | :--- |\n| `solution-designer` | 1 · vendor-agnostic | The overarching solution; objective vendor selection across GCP / AWS / Azure |\n| `gcp-architect` | 2 · GCP | GCP infrastructure design — HLD/LLD, ADRs, IAM and network topology |\n| `agent-architect` | 2 · GCP agentic | Agentic systems on GEAP — ADK, Agent Runtime, MCP/A2A/AP2, and agent evaluation |\n| `gcp-security` | 3 | Least-privilege IAM, secrets, Well-Architected security pillar |\n| `gcp-ops` | 3 | SLOs, alerting, runbooks, operational readiness |\n| `gcp-qa` | 3 | Validation, linting, smoke tests, the quality gate |\n\n**Eight first-wave service skills:** Cloud Run · GKE · IAM · BigQuery · Cloud Storage · Vertex AI · Networking · Logging/Monitoring.\n\n**Three cross-cutting skills:** `mcp-servers` (Google-managed + self-hosted MCP setup) · `well-architected` (the six-pillar framework) · `terraform-gcp` (CFT + provider patterns).\n\n---\n\n## Standards and compliance\n\nThis plugin conforms to the open, vendor-neutral packaging standards — not to any\nsingle vendor's plugin format.\n\n| Standard | Version | What conforms | How it's verified |\n|---|---|---|---|\n| [Agent Plugins](https://agent-plugins.org/specification) | 1.0.0 | `plugin.json`, `mcp.json`, the `skills/` layout | `make spec` + [`plugin.schema.json`](https://agent-plugins.org/schemas/1.0.0/plugin.schema.json) / [`mcp.schema.json`](https://agent-plugins.org/schemas/1.0.0/mcp.schema.json) |\n| [Agent Skills](https://agentskills.io/specification) | current | all 17 `SKILL.md` files | `make validate` + the official [`skills-ref`](https://github.com/agentskills/agentskills/tree/main/skills-ref) reference validator |\n| [Model Context Protocol](https://modelcontextprotocol.io) | stdio transport | `mcp.json` server declarations | `make spec` transport + placeholder checks |\n\nAgent Plugins 1.0.0 is co-maintained by Amazon, Cursor, Google, Microsoft, OpenAI\nand Vercel. Conforming to it means one directory layout works across conformant\nclients instead of a bespoke wrapper per harness. The per-harness manifests\n(`.claude-plugin/`, `.kimi-plugin/`, `gemini-extension.json`, `.agents/`) remain\nalongside it, so existing installs are unaffected.\n\nVerify it yourself, without trusting this repo's own scripts:\n\n```bash\nuvx --from \"git+https://github.com/agentskills/agentskills.git#subdirectory=skills-ref\" \\\n skills-ref validate skills/cloud-run\nuvx check-jsonschema --schemafile https://agent-plugins.org/schemas/1.0.0/plugin.schema.json plugin.json\n```\n\nSee [ADR-007](architecture/decisions/ADR-007-agent-plugins-conformance.md) for the\nadoption decision and its trade-offs.\n\n---\n\n## Validation\n\nThe plugin validates itself. Every skill conforms to a machine-readable contract; every reference URL is checked live; every source carries a retrieval date and content hash for audit.\n\n```bash\nmake gate # the full gate: spec + validate + manifest + mermaid + lint + test\nmake spec # Agent Plugins 1.0.0 conformance (plugin.json + mcp.json + skills/)\nmake validate # SKILL.md frontmatter vs the Agent Skills specification\nmake manifest # per-harness manifests present and consistent\nmake lint # every reference URL resolves (HTTP 200)\nmake test # skill smoke tests\nmake check # freshness: content-hash drift vs live GCP docs\nmake crawl # refresh the research corpus (weekly)\n```\n\nFreshness is a feature, not a chore: `make check` runs weekly and flags any GCP doc that has drifted since it was last captured, so the plugin never quietly rots.\n\n---\n\n## About the author\n\nCreated and maintained by **Jaroslav Pantsjoha (JP)** — Technical Director and Enterprise Agent Solution Architect at Cognizant, Google Developer Expert (Google Cloud), speaker, and author of *Building the Agentic Enterprise on Google Cloud* (Packt).\n\nI built this to make my own Google Cloud work repeatable, then to share it. The model is the easy part; the durable engineering is the harness around it — the skills, rules, MCP servers, gates, and evals. GCP patterns outlast the week's model release, so they are worth encoding once and reusing. This plugin is that baseline aimed squarely at Google Cloud — the GCP companion to my [`join-the-team`](https://github.com/jpantsjoha/ai-native-developer-experience) harness. Part of the **#HarnessEngineering** body of work — the engineering discipline behind the Agentic Enterprise.\n\n- LinkedIn: [uk.linkedin.com/in/johas](https://uk.linkedin.com/in/johas)\n- Google Developer Expert: [me.developers.google.com/u/jpantsjoha](https://me.developers.google.com/u/jpantsjoha)\n\n---\n\n## Licence\n\nOpen source under the [MIT License](LICENSE) — free for personal and commercial use, modification, and redistribution.\n\n---\n\n*This is an independent, community project. It is not affiliated with, sponsored by, or endorsed by Google LLC. \"Google Cloud\", \"GCP\", \"Gemini\", \"Vertex AI\", and related names are trademarks of Google LLC, used here only to describe what the plugin works with.*\n",
"bytes": 11875,
"sha": "09795c0bae643c9d1585eaba8eefd6ae0ddfee6cae3aef353831b1be054180f4",
"repo_slug": "jpantsjoha/googlecloud-plugin",
"fonte": "repo",
"truncated": false,
"api": "https://agentalog.com/api/listings/plg_jpantsjoha_googlecloud_plugin_d1373915/readme"
}
![\"googlecloud-plugin](\"assets/images/googlecloud-plugin-by-jp.png\")
\n![\"googlecloud-plugin](\"assets/images/googlecloud-plugin-antigravity-demo.png\")
\n