docs: comment out unpublished plugin install paths

AGENTS.md

@@ -63,12 +63,17 @@ This kit is distributed as an installable plugin/extension for every major codin
 
 | Agent | Install command | Update command | Manifest |
 |---|---|---|---|
+| Skills only (any agent) | `npx skills add Azure/documentdb-agent-kit` | re-run `npx skills add Azure/documentdb-agent-kit` (preferred) or `npx skills update` | walks `skills/` directly (no MCP server) |
+
+> ⚠️ Per-agent plugin install paths are not yet published — see the commented-out rows below for the planned commands.
+
+<!--
 | Claude Code | `/plugin marketplace add Azure/documentdb-agent-kit` then `/plugin install documentdb` | `/plugin update documentdb@azure-documentdb` | [`.claude-plugin/`](.claude-plugin/) |
 | Cursor | `/add-plugin azure/documentdb-agent-kit` | re-run `/add-plugin azure/documentdb-agent-kit` | [`.cursor-plugin/`](.cursor-plugin/) |
 | Codex | `codex plugin marketplace add azure/documentdb-agent-kit` | `codex plugin update documentdb` | [`.codex-plugin/`](.codex-plugin/) + [`.agents/plugins/marketplace.json`](.agents/plugins/marketplace.json) |
 | Gemini CLI | `gemini extensions install https://github.com/Azure/documentdb-agent-kit` | `gemini extensions update documentdb-agent-kit` | [`gemini-extension.json`](gemini-extension.json) + [`GEMINI.md`](GEMINI.md) |
 | GitHub Copilot CLI | `/plugin install https://github.com/Azure/documentdb-agent-kit.git` | `/plugin update https://github.com/Azure/documentdb-agent-kit.git` | this `AGENTS.md` + [`mcp.json`](mcp.json) |
-| Skills only (any agent) | `npx skills add Azure/documentdb-agent-kit` | re-run `npx skills add Azure/documentdb-agent-kit` (preferred) or `npx skills update` | walks `skills/` directly (no MCP server) |
+-->
 
 All paths share the same `skills/` tree. Claude / Cursor / Codex / Copilot also share the root [`mcp.json`](mcp.json); Gemini inlines the same MCP config in its own manifest.
 

README.md

@@ -10,6 +10,9 @@ Skills follow the [Agent Skills](https://agentskills.io/) format and the kit shi
 
 The plugin bundles the [DocumentDB MCP server](https://github.com/microsoft/documentdb-mcp) (`documentdb-mcp-server` on npm — Node.js 20+) together with all skills under `skills/`.
 
+> ⚠️ **Plugin install paths are not yet published.** The per-agent plugin/marketplace commands below are commented out until the plugin lands in each agent's registry. In the meantime, use the [skills-only one-liner](#universal-one-liner--skills-only-no-mcp-server) to install the skill catalog.
+
+<!--
 ### Claude Code
 
 Inside a Claude Code session:
@@ -45,6 +48,7 @@ gemini extensions install https://github.com/Azure/documentdb-agent-kit
 ```
 
 Then restart Copilot CLI to activate the MCP server. For Copilot in the IDE, [`AGENTS.md`](AGENTS.md) at the repo root is read automatically — no extra wiring.
+-->
 
 ### Universal one-liner — skills only (no MCP server)
 
@@ -60,14 +64,22 @@ This drops the rule docs into your agent's skill directory but **does not** inst
 
 New skills, rule fixes, and MCP-server updates are released on `main`. Installs do **not** auto-update — each install path has its own refresh command. Run these when you want to pull in new features or fixes:
 
+| Install path | Update command |
+|---|---|
+| Skills only (skills.sh CLI) | re-run `npx skills add Azure/documentdb-agent-kit` |
+
+<!--
+Per-agent update commands (will be uncommented once plugin install paths are published):
+
 | Install path | Update command |
 |---|---|
 | Claude Code | `/plugin update documentdb@azure-documentdb` |
 | Cursor | re-run `/add-plugin azure/documentdb-agent-kit` |
 | Codex | `codex plugin update documentdb` |
 | Gemini CLI | `gemini extensions update documentdb-agent-kit` |
 | GitHub Copilot CLI | `/plugin update https://github.com/Azure/documentdb-agent-kit.git` (or uninstall + reinstall) |
-| Skills only (skills.sh CLI) | re-run `npx skills add Azure/documentdb-agent-kit` |
+-->
+
 
 > **Skills CLI note:** `npx skills update` exists but is unreliable for GitHub-sourced skills on the current `skills` CLI release. **Re-running `npx skills add Azure/documentdb-agent-kit` is the recommended refresh path** — it re-fetches the latest `main` and overlays the updated rule files. Add `--all` if you originally installed with `--all`.