Skip to content

Commit 317e96f

Browse files
authored
docs: update readme to connect with antigravity (#111)
1 parent 8ce80d0 commit 317e96f

2 files changed

Lines changed: 69 additions & 38 deletions

File tree

.lycheeignore

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,2 +1,3 @@
11
https://github.com/gemini-cli-extensions/dataplex/compare/
22
https://github.com/gemini-cli-extensions/knowledge-catalog/compare/
3+
https://www.npmjs.com/package/skills

README.md

Lines changed: 68 additions & 38 deletions
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@
33
> [!NOTE]
44
> Currently in beta (pre-v1.0), and may see breaking changes until the first stable release (v1.0).
55
6-
This repository provides a set of agent skills to interact with [Knowledge Catalog](https://cloud.google.com/dataplex/docs) (formerly known as Dataplex) instances. These skills can be used with various AI agents, including [Gemini CLI](https://google-gemini.github.io/gemini-cli/), Claude Code, and Codex, to discover, manage, monitor, and govern data and AI artifacts across your data platform using natural language prompts.
6+
This repository provides a set of agent skills to interact with [Knowledge Catalog](https://cloud.google.com/dataplex/docs) (formerly known as Dataplex) instances. These skills can be used with various AI agents, including [Antigravity](https://antigravity.google/), [Claude Code](https://claude.com/product/claude-code) and [Codex](https://developers.openai.com/codex), to discover, manage, monitor, and govern data and AI artifacts across your data platform using natural language prompts.
77

88
> [!IMPORTANT]
99
> **We Want Your Feedback!**
@@ -19,10 +19,9 @@ This repository provides a set of agent skills to interact with [Knowledge Catal
1919
- [Getting Started](#getting-started)
2020
- [Configuration](#configuration)
2121
- [Installation & Usage](#installation--usage)
22-
- [Gemini CLI](#gemini-cli)
22+
- [Antigravity](#antigravity)
2323
- [Claude Code](#claude-code)
2424
- [Codex](#codex)
25-
- [Antigravity](#antigravity)
2625
- [Usage Examples](#usage-examples)
2726
- [Supported Skills](#supported-skills)
2827
- [Additional Agent Skills](#additional-agent-skills)
@@ -39,10 +38,11 @@ This repository provides a set of agent skills to interact with [Knowledge Catal
3938
Before you begin, ensure you have the following:
4039

4140
- One of these AI agents installed
42-
- [Gemini CLI](https://github.com/google-gemini/gemini-cli) version **v0.6.0** or higher
43-
- [Claude Code](https://claude.com/product/claude-code) version **v2.1.94** or higher
44-
- [Codex](https://developers.openai.com/codex) **v0.117.0** or higher
45-
- [Antigravity](https://antigravity.google) **v1.14.2** or higher
41+
- Antigravity
42+
- [Antigravity CLI](https://github.com/google-gemini/gemini-cli) version **v1.6.0** or higher
43+
- [Antigravity 2.0](https://antigravity.google/product/antigravity-2) version **v2.0.0** or higher.
44+
- [Claude Code](https://claude.com/product/claude-code) version **v2.1.94** or higher.
45+
- [Codex](https://developers.openai.com/codex) **v0.117.0** or higher.
4646
- A Google Cloud project with the **Dataplex API** enabled.
4747
- Ensure [Application Default Credentials](https://cloud.google.com/docs/authentication/gcloud) are available in your environment.
4848
- IAM Permissions:
@@ -68,29 +68,73 @@ For the latest version, check the [releases page][releases].
6868
<!-- {x-release-please-start-version} -->
6969

7070
<details open>
71-
<summary id="gemini-cli">Gemini CLI</summary>
71+
<summary id="antigravity">Antigravity</summary>
72+
73+
You can use either of these two agents for Antigravity:
74+
- [Antigravity CLI](https://github.com/google-gemini/gemini-cli) version **v1.6.0** or higher
75+
- [Antigravity 2.0](https://antigravity.google/product/antigravity-2) version **v2.0.0** or higher.
76+
77+
<blockquote>
78+
💡 <strong>Tip — Migrating from Gemini CLI?</strong><br>
79+
If you previously installed this extension with <code>gemini extensions install</code>, you can convert it to an Antigravity plugin instead of reinstalling from scratch:
80+
<ul>
81+
<li><strong>On first launch of Antigravity CLI</strong>, accept the Migration Options prompt to automatically convert your installed Gemini CLI extensions to Antigravity plugins.</li>
82+
<li><strong>Or, from your terminal</strong>, run:
83+
<pre><code class="language-bash">agy plugin import gemini</code></pre>
84+
</li>
85+
</ul>
86+
See <a href="https://antigravity.google/docs/gcli-migration">Migrating from Gemini CLI</a> for details on plugins, context files (<code>GEMINI.md</code> / <code>AGENTS.md</code>), and MCP server config differences.
87+
</blockquote>
88+
89+
#### Antigravity 2.0 (IDE)
90+
91+
**1. Clone the Repo:**
92+
93+
```bash
94+
git clone --branch 0.5.1 https://github.com/gemini-cli-extensions/knowledge-catalog.git
95+
```
96+
97+
**2. Install the skills:**
7298

73-
**1. Install the extension:**
99+
Choose a location for the skills:
100+
- **Global (all workspaces):** `~/.gemini/antigravity/skills/`
101+
- **Workspace-specific:** `<workspace-root>/.agents/skills/`
102+
103+
Copy the skill folders from the cloned repository's `skills/` directory to your chosen location:
74104

75105
```bash
76-
gemini extensions install https://github.com/gemini-cli-extensions/knowledge-catalog
106+
cp -R knowledge-catalog/skills/* ~/.gemini/antigravity/skills/
77107
```
78108

79-
During the installation, enter your environment vars as described in the [configuration section](#configuration).
109+
**3. Set env vars:**
110+
Set your environment vars as described in the [configuration section](#configuration).
111+
112+
_(Tip: Antigravity 2.0 automatically discovers skills in these directories at the start of a session. You can verify they are active by running the `/skills` command in your active session.)_
113+
114+
#### Antigravity CLI
115+
116+
**1. Clone the Repo:**
117+
118+
```bash
119+
git clone --branch 0.5.1 https://github.com/gemini-cli-extensions/knowledge-catalog.git
120+
```
80121

81-
**2. (Optional) Manage Configuration:**
82-
To view or update your configuration in Gemini CLI:
122+
**2. Install the skills:**
83123

84-
- Terminal: `gemini extensions config knowledge-catalog [setting name] [--scope <scope>]`
85-
- Gemini CLI: `/extensions list`
124+
Choose a location for the skills:
125+
- **Global (all workspaces):** `~/.gemini/antigravity-cli/skills/`
126+
- **Workspace-specific:** `<workspace-root>/.agents/skills/`
86127

87-
**3. Start the agent:**
128+
Copy the skill folders from the cloned repository's `skills/` directory to your chosen location:
88129

89130
```bash
90-
gemini
131+
cp -R knowledge-catalog/skills/* ~/.gemini/antigravity-cli/skills/
91132
```
92133

93-
_(Tip: Run `/extensions list` to verify your configuration and active extensions.)_
134+
**3. Set env vars:**
135+
Set your environment vars as described in the [configuration section](#configuration).
136+
137+
_(Tip: Antigravity CLI automatically discovers skills in these directories at the start of a session. You can verify they are active by running the `/skills` command in your active session.)_
94138

95139
</details>
96140

@@ -170,35 +214,21 @@ Enter your environment vars as described in the [configuration section](#configu
170214
_(Tip: Run `codex plugin list` or use the `/plugins` interactive menu to verify your installed plugins.)_
171215

172216
</details>
217+
## Installing using [open agent skills tool](https://github.com/vercel-labs/skills)
173218

174-
<details>
175-
<summary id="antigravity">Antigravity</summary>
219+
You can install skills using the `npx skills` command.
176220

177-
**1. Clone the Repo:**
221+
Run the following command in your terminal to automatically download and register the skills:
178222

179223
```bash
180-
git clone --branch 0.5.1 https://github.com/gemini-cli-extensions/knowledge-catalog.git
224+
npx skills add https://github.com/gemini-cli-extensions/knowledge-catalog/tree/0.5.1
181225
```
182226

183-
**2. Install the skills:**
184-
185-
Choose a location for the skills:
186-
- **Global (all workspaces):** `~/.gemini/antigravity/skills/`
187-
- **Workspace-specific:** `<workspace-root>/.agents/skills/`
188-
189-
Copy the skill folders from the cloned repository's `skills/` directory to your chosen location:
190-
191-
```bash
192-
cp -R knowledge-catalog/skills/* ~/.gemini/antigravity/skills/
193-
```
227+
For detailed info check out the [Skills npm package](https://www.npmjs.com/package/skills).
194228

195-
**3. Set env vars:**
229+
**2. Set env vars:**
196230
Set your environment vars as described in the [configuration section](#configuration).
197231

198-
_(Tip: Antigravity automatically discovers skills in these directories at the start of a session.)_
199-
200-
</details>
201-
202232
<!-- {x-release-please-end} -->
203233

204234
## Usage Examples

0 commit comments

Comments
 (0)