From 7206dc0614e81a0d01994bcc141f0fbbb0c457f7 Mon Sep 17 00:00:00 2001
From: Haoyu Wang <whaoyu@google.com>
Date: Mon, 3 Aug 2026 14:40:51 -0400
Subject: [PATCH] feat(plugin): support agent plugin spec

---
 .claude-plugin/plugin.json | 16 +---------------
 .lycheeignore              |  1 +
 README.md                  | 15 +++++++++++++++
 plugin.json                | 18 ++++++++++++++++++
 release-please-config.json |  5 +++++
 5 files changed, 40 insertions(+), 15 deletions(-)
 create mode 100644 plugin.json

diff --git a/.claude-plugin/plugin.json b/.claude-plugin/plugin.json
index 7a39e94..3b3e423 100644
--- a/.claude-plugin/plugin.json
+++ b/.claude-plugin/plugin.json
@@ -9,19 +9,5 @@
   "homepage": "https://cloud.google.com/bigquery",
   "license": "Apache-2.0",
   "repository": "https://github.com/gemini-cli-extensions/bigquery-data-analytics",
-  "skills": "./skills/",
-  "userConfig": {
-    "bigquery_project": {
-      "title": "Project ID",
-      "description": "ID of the Google Cloud project",
-      "type": "string",
-      "sensitive": false
-    },
-    "bigquery_location": {
-      "title": "Location",
-      "description": "(Optional) Location of the BigQuery resources",
-      "type": "string",
-      "sensitive": false
-    }
-  }
+  "skills": "./skills/"
 }
diff --git a/.lycheeignore b/.lycheeignore
index 74412e7..43b7a6b 100644
--- a/.lycheeignore
+++ b/.lycheeignore
@@ -1,2 +1,3 @@
 https://github.com/gemini-cli-extensions/bigquery-data-analytics/compare/
 https://www.npmjs.com/package/skills
+https://agent-plugins.org/compatible-clients
diff --git a/README.md b/README.md
index 7934287..e6adafb 100644
--- a/README.md
+++ b/README.md
@@ -20,6 +20,8 @@ Developers can effortlessly connect, interact, and generate data insights with [
   - [Antigravity](#antigravity)
   - [Claude Code](#claude-code)
   - [Codex](#codex)
+- [Installing using open agent skills tool](#installing-using-open-agent-skills-tool)
+- [Installing via a compatible Agent Plugins client](#installing-via-a-compatible-agent-plugins-client)
 - [Usage Examples](#usage-examples)
 - [Supported Skills](#supported-skills)
 - [Additional Extensions](#additional-extensions)
@@ -200,6 +202,19 @@ For detailed info check out the [Skills npm package](https://www.npmjs.com/packa
 **2. Set env vars:**
 Set your environment vars as described in the [configuration section](#configuration).
 
+## Installing via a compatible Agent Plugins client
+
+This repository is a valid [Agent Plugins](https://github.com/agentplugins/agent-plugins-spec) (v1) plugin. Any [Agent Plugins–compatible client](https://agent-plugins.org/compatible-clients) can install it directly using its own built-in plugin command — no extra tooling required — by pointing at this repository:
+
+```
+https://github.com/gemini-cli-extensions/bigquery-data-analytics
+```
+
+Beyond harnesses covered by the native install above, compatible clients include VS Code, Cursor, GitHub Copilot, and Kiro. See your agent's documentation for its exact install command.
+
+**Set env vars:**
+Set your environment vars as described in the [configuration section](#configuration).
+
 <!-- {x-release-please-end} -->
 
 
diff --git a/plugin.json b/plugin.json
new file mode 100644
index 0000000..0cb339c
--- /dev/null
+++ b/plugin.json
@@ -0,0 +1,18 @@
+{
+  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
+  "name": "bigquery-data-analytics",
+  "version": "0.2.1",
+  "description": "Connect, query, and generate data insights for BigQuery datasets and data.",
+  "author": {
+    "name": "Google LLC",
+    "email": "data-cloud-ai-integrations@google.com"
+  },
+  "homepage": "https://cloud.google.com/bigquery",
+  "repository": "https://github.com/gemini-cli-extensions/bigquery-data-analytics",
+  "license": "Apache-2.0",
+  "keywords": [
+    "bigquery",
+    "data-analytics",
+    "database"
+  ]
+}
diff --git a/release-please-config.json b/release-please-config.json
index b470197..f956b39 100644
--- a/release-please-config.json
+++ b/release-please-config.json
@@ -39,6 +39,11 @@
           "path": ".claude-plugin/plugin.json",
           "jsonpath": "$.version"
         },
+        {
+          "type": "json",
+          "path": "plugin.json",
+          "jsonpath": "$.version"
+        },
         {
           "type": "json",
           "path": ".codex-plugin/plugin.json",