From ecd5634c4623d48e95650b29409b7cdb11e74141 Mon Sep 17 00:00:00 2001
From: Sanchit Mehta <sanchit.mehta@okta.com>
Date: Wed, 8 Jul 2026 16:47:22 +0530
Subject: [PATCH] docs: update Agent Integration for consolidated auth0 skill

The standalone auth0-cli skill was folded into a single consolidated
`auth0` skill that routes across all Auth0 SDKs, features, and tooling
(including the CLI). Point install instructions at the official Claude
Code plugins marketplace and the correct skill directory.
---
 README.md | 31 +++++++++++++++++++++----------
 1 file changed, 21 insertions(+), 10 deletions(-)

diff --git a/README.md b/README.md
index 7fcb36ccd..9c3227e83 100644
--- a/README.md
+++ b/README.md
@@ -332,38 +332,49 @@ setx EDITOR "code --wait"
 
 ## Agent Integration
 
-The CLI has an [AgentSkills-compatible](https://agentskills.io/) skill for AI agents (Claude Code, OpenClaw, etc.), available from the [Auth0 Agent Skills](https://github.com/auth0/agent-skills) repository.
+CLI guidance for AI agents (Claude Code, Cursor, OpenClaw, etc.) ships as part of the [AgentSkills-compatible](https://agentskills.io/) `auth0` skill in the [Auth0 Agent Skills](https://github.com/auth0/agent-skills) repository. The `auth0` skill routes across all Auth0 SDKs, features, and tooling — including this CLI.
 
 ### Install via Auth0 Agent Skills (Recommended)
 
-The `auth0-cli` skill is part of the [auth0/agent-skills](https://github.com/auth0/agent-skills) collection. Install the full Auth0 skills suite to get it along with other Auth0 skills:
-
-**Claude Code plugin marketplace:**
+**Claude Code (official plugins marketplace):**
 
 ```
-/plugin marketplace add auth0/agent-skills
-/plugin install auth0@auth0-agent-skills
+/plugin install auth0@claude-plugins-official
+```
+
+From the terminal (no session needed):
+
+```bash
+claude plugin install auth0@claude-plugins-official
 ```
 
-**Skills CLI:**
+**Any agent (Skills CLI):**
+
+The [Skills CLI](https://github.com/vercel-labs/skills) works with Claude Code, Cursor, Copilot, Codex, and [40+ other agents](https://agentskills.io/clients):
 
 ```bash
 npx skills add auth0/agent-skills
 ```
 
+Target specific agents with `--agent`:
+
+```bash
+npx skills add auth0/agent-skills --agent claude-code cursor
+```
+
 **Manual installation (Claude Code, OpenClaw):**
 
 ```bash
 git clone https://github.com/auth0/agent-skills.git
 
 # Claude Code
-cp -r agent-skills/plugins/auth0/skills/auth0-cli ~/.claude/skills/
+cp -r agent-skills/plugins/auth0/skills/auth0 ~/.claude/skills/
 
 # OpenClaw
-cp -r agent-skills/plugins/auth0/skills/auth0-cli ~/.openclaw/skills/
+cp -r agent-skills/plugins/auth0/skills/auth0 ~/.openclaw/skills/
 ```
 
-> **Note:** The `auth0` binary must be installed and available on your `$PATH` for agents to use this skill.
+> **Note:** The `auth0` binary must be installed and available on your `$PATH` for agents to use the CLI guidance in this skill.
 
 ## Anonymized Analytics Disclosure