From a63fe67b1bbb396a1c357d2d8da307d3266759cc Mon Sep 17 00:00:00 2001
From: Simon KP <simon@keeperhub.com>
Date: Thu, 26 Mar 2026 15:52:01 +1100
Subject: [PATCH] chore: tighten README setup instructions

Consolidate the three setup steps (marketplace add, plugin install,
login) into a single code block so users see the full flow at a
glance. Trim verbose prose and shorten example prompts.
---
 README.md                   | 35 ++++++++++++++++-------------------
 plugins/keeperhub/README.md |  9 ++-------
 2 files changed, 18 insertions(+), 26 deletions(-)

diff --git a/README.md b/README.md
index fd677a6..b67920f 100644
--- a/README.md
+++ b/README.md
@@ -2,37 +2,34 @@
 
 Claude Code plugin marketplace by KeeperHub.
 
-## Install
+## Setup
 
 ```
 /plugin marketplace add KeeperHub/claude-plugins
+/plugin install keeperhub@keeperhub-plugins
+/keeperhub:login
 ```
 
-## Available Plugins
+Run `/keeperhub:status` to verify the connection.
 
-### keeperhub
+## Plugins
 
-Build and manage automation workflows from Claude Code. Create workflows that monitor smart contracts, track on-chain events, run scheduled tasks, and send notifications across Discord, Telegram, email, and webhooks. Connects to KeeperHub's remote MCP server with OAuth browser authentication. Includes 4 skills and 2 slash commands.
+**keeperhub**
 
-```
-/plugin install keeperhub@keeperhub-plugins
-```
+Build and manage automation workflows from Claude Code. Monitor smart contracts, track on-chain events, run scheduled tasks, and send notifications across Discord, Telegram, email, and webhooks. Connects to KeeperHub's remote MCP server with OAuth browser authentication.
 
-After install, run `/mcp` in Claude Code and authorize the keeperhub server via browser.
+**Try it:**
 
-**Commands:**
-- `/keeperhub:login` -- setup guide for connecting to KeeperHub MCP
-- `/keeperhub:status` -- check MCP connection status
+- "Create a workflow that monitors a smart contract event and sends a Telegram alert"
+- "Show me workflow templates for on-chain monitoring"
+- "Why did my last workflow fail?"
+- "What KeeperHub plugins are available?"
+
+**Commands:** `/keeperhub:login` | `/keeperhub:status`
 
 **Skills (activate automatically):**
+
 - **workflow-builder** -- create workflows from natural language
-- **template-browser** -- browse and deploy pre-built workflow templates
+- **template-browser** -- browse and deploy pre-built templates
 - **execution-monitor** -- monitor runs and debug failures
 - **plugin-explorer** -- discover available plugins and integrations
-
-**Example use cases:**
-- "Create a workflow that monitors a smart contract event every 15 minutes and sends a Telegram alert when a specific condition is met"
-- "Show me available workflow templates for on-chain event monitoring"
-- "Why did my last workflow execution fail? Show me the logs"
-- "What KeeperHub plugins and integrations are available?"
-- "Set up an automation that runs a scheduled check hourly and sends a Discord notification when a threshold is crossed"
diff --git a/plugins/keeperhub/README.md b/plugins/keeperhub/README.md
index bb06f13..33ef377 100644
--- a/plugins/keeperhub/README.md
+++ b/plugins/keeperhub/README.md
@@ -4,20 +4,15 @@ Build and manage automation workflows from Claude Code. Monitor smart contracts,
 
 ## Quick Start
 
-**1. Install the plugin**
-
 ```
 /plugin marketplace add KeeperHub/claude-plugins
 /plugin install keeperhub@keeperhub-plugins
+/keeperhub:login
 ```
 
-**2. Authorize**
-
-Run `/mcp` in Claude Code, find "keeperhub" in the server list, and authorize via browser. That's it.
-
 For headless/CI environments, set `KH_API_KEY` with an organization API key (`kh_` prefix) instead.
 
-**3.** Try asking Claude to "create a workflow that monitors a smart contract event" or run `/keeperhub:status` to verify.
+Run `/keeperhub:status` to verify, then try "create a workflow that monitors a smart contract event".
 
 ## Commands