brainstorm-companion 2.1.0 → 2.1.1

package/README.md

@@ -12,7 +12,11 @@ Zero dependencies. Node.js >= 18 only.
 npm install -g brainstorm-companion
 ```
 
-### Claude Code MCP Setup
+### Claude Code Setup
+
+Two parts: the **MCP server** (gives the agent tools) and the **skill** (teaches the agent how to use them well).
+
+#### Step 1: MCP Server
 
 Add to `~/.claude/.mcp.json` (create the file if it doesn't exist):
 
@@ -27,7 +31,7 @@ Add to `~/.claude/.mcp.json` (create the file if it doesn't exist):
 }
 ```
 
-Then restart Claude Code. The agent gets 5 tools (`brainstorm_start_session`, `brainstorm_push_screen`, `brainstorm_read_events`, `brainstorm_clear_screen`, `brainstorm_stop_session`) with full usage docs embedded — it knows how to use them immediately.
+This gives the agent 5 tools: `brainstorm_start_session`, `brainstorm_push_screen`, `brainstorm_read_events`, `brainstorm_clear_screen`, `brainstorm_stop_session`. Full usage docs are embedded in each tool description.
 
 **Alternative (no global install):** Use `npx` instead:
 ```json
@@ -41,6 +45,31 @@ Then restart Claude Code. The agent gets 5 tools (`brainstorm_start_session`, `b
 }
 ```
 
+#### Step 2: Skill (optional but recommended)
+
+The skill teaches the agent **when and how** to use the brainstorm tools — CSS classes, HTML patterns, workflow patterns, and best practices.
+
+Find the skill files path:
+```bash
+echo "$(npm root -g)/brainstorm-companion/skill"
+```
+
+Then install the skill in Claude Code:
+```bash
+# In Claude Code, run:
+/install-skill $(npm root -g)/brainstorm-companion/skill/SKILL.md
+```
+
+Or manually copy the skill into your project:
+```bash
+mkdir -p .claude/skills
+cp "$(npm root -g)/brainstorm-companion/skill/"*.md .claude/skills/
+```
+
+#### Step 3: Restart Claude Code
+
+Restart Claude Code for the MCP server and skill to take effect.
+
 ---
 
 ## Complete Usage Guide

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "brainstorm-companion",
-  "version": "2.1.0",
+  "version": "2.1.1",
   "description": "AI-assisted visual brainstorming companion",
   "type": "commonjs",
   "license": "MIT",

package/src/cli.js

@@ -192,10 +192,14 @@ Next steps:
   brainstorm-companion push --html '<h2>Your content</h2>'   Push content to browser
   brainstorm-companion push file.html --slot a --label "A"   Comparison mode
   brainstorm-companion events                                 Read user interactions
+  brainstorm-companion events --wait 120                      Wait for user's click
   brainstorm-companion stop                                   Stop when done
 
-Full docs: https://www.npmjs.com/package/brainstorm-companion
-Run: brainstorm-companion push --help    for all CSS classes and options`);
+Install skill for AI agents (teaches CSS classes, workflows, best practices):
+  /install-skill $(npm root -g)/brainstorm-companion/skill/SKILL.md
+
+Docs: https://www.npmjs.com/package/brainstorm-companion
+Help: brainstorm-companion push --help`);
 }
 
 function sleep(ms) {