Skip to content

v0.2.0 — Agent Plugins 1.0.0 & Agent Skills conformance

Latest
Latest

Choose a tag to compare

View all tags
@jpantsjoha jpantsjoha released this 07 Aug 11:21
· 13 commits to main since this release
v0.2.0
7315ebe
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

Standards release. googlecloud-plugin now conforms to Agent Plugins 1.0.0 and the Agent Skills specification — the open, vendor-neutral packaging standards co-maintained by Amazon, Cursor, Google, Microsoft, OpenAI and Vercel (announcement).

Why this matters

Before this release, a conformant Agent Plugins client would have loaded nothing from this plugin. Two independent fatal faults:

  1. plugin.json omitted the required $schema. The manifest schema is closed, so §5.2 makes the omission fatal — the client rejects the plugin outright.
  2. All 17 skills carried top-level frontmatter outside the closed Agent Skills field set. §6.1 requires clients to skip every non-conforming skill.

Standards adhered to

Standard Version Scope Enforced by
Agent Plugins 1.0.0 plugin.json, mcp.json, skills/ layout make spec
plugin.schema.json 1.0.0 root manifest, closed field set make spec
mcp.schema.json 1.0.0 MCP manifest, transport discriminator make spec
Agent Skills current all 17 SKILL.md make validate
Model Context Protocol stdio, 2025-06-18 mcp.json servers live handshake

Breaking — skill authors and downstream tooling

Frontmatter is now {name, description, license, metadata}. The top-level version, triggers, required_scopes, mcp_servers, persona, tier, gate and owns_eval fields are gone; the same data lives under metadata, namespaced, as string values:

metadata:
  "googlecloud-plugin/required-scopes": "run.services.create, run.services.get"

Split on ", ". Routing keywords moved into description — the only field a conformant client routes on.

No action for users. Existing installs are unaffected; the per-harness manifests are unchanged.

Verification

Check Result
skills-ref — official Agent Skills reference validator 17/17 valid
check-jsonschema vs both published schemas pass / pass
agy plugin validate — Antigravity loader 17 skills, 2 mcpServers, exit 0
Antigravity routing 17 visible, 6/6 correct
Kimi routing 17 loaded, 7/7 correct
Live MCP handshake gcloud-mcp-server v0.5.3, run_gcloud_command
make gate spec + validate + manifest + mermaid + 102 URLs + 195 tests

Verify it yourself, without trusting this repo's scripts:

uvx --from "git+https://github.com/agentskills/agentskills.git#subdirectory=skills-ref" skills-ref validate skills/cloud-run
uvx check-jsonschema --schemafile https://agent-plugins.org/schemas/1.0.0/plugin.schema.json plugin.json

Not verified: Codex (usage limit at release time) and the Toolbox MCP server (opt-in by design — it needs a user-specific tools.yaml).

Also in this release

  • New make spec conformance gate; tests 136 → 195
  • Eight skill descriptions gained boundary clauses after cross-harness routing tests found four ambiguous pairs
  • mcp.json declares no env — only \${PLUGIN_ROOT}/\${PLUGIN_DATA} expand, so \${GCP_PROJECT_ID} would have been passed through literally. Export it in your shell instead.
  • ADR-007 · CHANGELOG

Full changelog: v0.1.0...v0.2.0

Assets 2
Loading