From 9b4720491353a91f80faea6589537e6afeba2a81 Mon Sep 17 00:00:00 2001
From: Austin Schaefer <55203603+austin-schaefer@users.noreply.github.com>
Date: Thu, 2 Apr 2026 16:16:26 -0700
Subject: [PATCH 1/2] Enhance README with installation and feature details

---
 README.md | 41 ++++++++++++++++++++++++++++++++++++++---
 1 file changed, 38 insertions(+), 3 deletions(-)

diff --git a/README.md b/README.md
index 619e093..2dd0c96 100644
--- a/README.md
+++ b/README.md
@@ -1,7 +1,42 @@
 # Shopify AI Toolkit
 
-This repository hosts AI coding agent plugins.
+Connect your AI tools to the Shopify platform. 
 
-## Plugins
+The Toolkit gives your agent access to Shopify's documentation, API schemas, and code validation for building apps, and store management through the CLI's store execute capabilities.
 
-- [shopify-plugin](plugins/shopify-plugin/) — Shopify developer tools for Claude Code, Cursor, Gemini CLI, and Codex
+## Install
+
+* **For Claude Code**: Run these two commands in a chat:
+
+    ```
+    /plugin marketplace add Shopify/shopify-ai-toolkit
+    /plugin install shopify-plugin@shopify-ai-toolkit
+    ```
+
+* **For Cursor**: Install from the [Cursor Marketplace](https://cursor.com/marketplace/shopify).
+* **For Gemini CLI**: Run this command in your terminal:
+
+    ```
+    gemini extensions install https://github.com/Shopify/shopify-ai-toolkit
+    ```
+
+* **For VS Code**: Open the Command Palette (`CMD+SHIFT+P`) and run **Chat: Install Plugin From Source**. 
+
+    Then paste:
+
+    ```
+    https://github.com/Shopify/shopify-ai-toolkit
+    ```
+
+## What you get
+
+- **Docs and API schemas**: Search Shopify's documentation and API schemas without leaving your editor
+- **Code validation**: Validate GraphQL queries, Liquid templates, and UI extensions against Shopify's schemas
+- **Store management**: Manage your Shopify store through the CLI's store execute capabilities
+- **Auto-updates**: The plugin updates automatically as new capabilities are released
+
+## Other install methods
+
+If your platform doesn't support plugins, you can install agent skills or the Dev MCP server directly. 
+
+For full documentation, see [shopify.dev/docs/apps/build/ai-toolkit](https://shopify.dev/docs/apps/build/ai-toolkit).

From ee52c7b1e90941c20228608a2e0c156590bedc5c Mon Sep 17 00:00:00 2001
From: Austin Schaefer <55203603+austin-schaefer@users.noreply.github.com>
Date: Thu, 2 Apr 2026 17:53:31 -0700
Subject: [PATCH 2/2] Clarify docs links

---
 README.md | 6 ++----
 1 file changed, 2 insertions(+), 4 deletions(-)

diff --git a/README.md b/README.md
index 2dd0c96..fac32eb 100644
--- a/README.md
+++ b/README.md
@@ -2,7 +2,7 @@
 
 Connect your AI tools to the Shopify platform. 
 
-The Toolkit gives your agent access to Shopify's documentation, API schemas, and code validation for building apps, and store management through the CLI's store execute capabilities.
+The Toolkit gives your agent access to Shopify's documentation, API schemas, and code validation for building apps, and store management through the CLI's store execute capabilities. For more info, [see the docs](https://shopify.dev/docs/apps/build/ai-toolkit).
 
 ## Install
 
@@ -37,6 +37,4 @@ The Toolkit gives your agent access to Shopify's documentation, API schemas, and
 
 ## Other install methods
 
-If your platform doesn't support plugins, you can install agent skills or the Dev MCP server directly. 
-
-For full documentation, see [shopify.dev/docs/apps/build/ai-toolkit](https://shopify.dev/docs/apps/build/ai-toolkit).
+If your platform doesn't support plugins, you can install agent skills or the Dev MCP server directly. For instructions, see [shopify.dev/docs/apps/build/ai-toolkit](https://shopify.dev/docs/apps/build/ai-toolkit).