diff --git a/.claude-plugin/marketplace.json b/.claude-plugin/marketplace.json
new file mode 100644
index 0000000..6b48a90
--- /dev/null
+++ b/.claude-plugin/marketplace.json
@@ -0,0 +1,16 @@
+{
+  "name": "makingchatbots-genesys-cloud-architect",
+  "owner": {
+    "name": "Lucas Woodward",
+    "url": "https://makingchatbots.com/"
+  },
+  "description": "Plugins for the full life-cycle of creating Genesys Cloud Architect flows with Claude Code",
+  "plugins": [
+    {
+      "name": "genesys-cloud-architect",
+      "source": "./",
+      "description": "Create, test, and debug Genesys Cloud Architect flows",
+      "version": "1.0.0"
+    }
+  ]
+}
diff --git a/README.md b/README.md
index f34d307..0a4508b 100644
--- a/README.md
+++ b/README.md
@@ -1,19 +1,31 @@
 # Genesys Cloud Architect Claude Code Plugin
 
-## Development
-
-Test the plugin locally:
+Create, debug and test Genesys Cloud Architect Flows using Claude Code.
 
-```shell
-CLAUDE_PLUGIN_ROOT=$(pwd) claude --plugin-dir .
-```
+**This is under heavy development. Feedback is welcome!**
 
-To aid in the development of the MCP server install the MCP Server Skill:
+## Installation
 
 ```
-npx skills add https://github.com/anthropics/claude-plugins-official/tree/main/plugins/mcp-server-dev/skills/build-mcp-server
+# Add the marketplace
+/plugin marketplace add MakingChatbots/genesys-cloud-architect
+
+# Install the plugin
+/plugin install genesys-cloud-architect@makingchatbots
 ```
 
-Claude Code plugin for developing plugins
+## Getting Started
+
+Once you've installed the plugin you can start working with Claude Code to create your Architect flows.
+
+Try some of the following examples:
+
+> Create a Digital Chatbot that asks the customer for their name, then welcomes them by their name.
+
+
+## Development
+
+Docs to help understand how this works, or contribute:
 
-https://github.com/anthropics/claude-code/tree/main/plugins/plugin-dev
\ No newline at end of file
+* [docs/development.md](docs/development.md)
+* [docs/architecture.md](docs/architecture.md)
diff --git a/docs/architecture.md b/docs/architecture.md
new file mode 100644
index 0000000..f2569bf
--- /dev/null
+++ b/docs/architecture.md
@@ -0,0 +1 @@
+# Architecture
\ No newline at end of file
diff --git a/docs/development.md b/docs/development.md
new file mode 100644
index 0000000..64cd4c3
--- /dev/null
+++ b/docs/development.md
@@ -0,0 +1,23 @@
+# Development
+
+Test the plugin locally:
+
+```shell
+CLAUDE_PLUGIN_ROOT=$(pwd) claude --plugin-dir .
+```
+
+Debug the plugin:
+
+```shell
+CLAUDE_PLUGIN_ROOT=$(pwd) claude --plugin-dir . --debug
+```
+
+To aid in the development of the MCP server install the MCP Server Skill:
+
+```
+npx skills add https://github.com/anthropics/claude-plugins-official/tree/main/plugins/mcp-server-dev/skills/build-mcp-server
+```
+
+Claude Code plugin for developing plugins
+
+https://github.com/anthropics/claude-code/tree/main/plugins/plugin-dev