From 55b6be8945b6d2d6213f93dc6f477df31e7b84f2 Mon Sep 17 00:00:00 2001
From: sonpiaz <sonxpiaz@gmail.com>
Date: Tue, 19 May 2026 17:22:38 -0700
Subject: [PATCH] feat(phase-5): add .claude-plugin/marketplace.json + Claude
 Code install path
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Lets Claude Code users install watch-cli as a skill via:

  /plugin marketplace add sonpiaz/watch-cli
  /plugin install watch-cli@watch-cli

The marketplace.json points at the existing skills/watch-cli/SKILL.md
(symlinked from repo root). No new SKILL content — this is purely the
plumbing that makes the existing portable SKILL.md installable through
Claude Code's plugin manager without manual cp -r.

README install section gets a Claude Code subsection with the
two-line install. Removes the now-obsolete 'requires v0.3.0 to be cut
first' caveat since v0.3.0 has shipped.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
---
 .claude-plugin/marketplace.json | 22 ++++++++++++++++++++++
 README.md                       | 18 ++++++++++++++----
 2 files changed, 36 insertions(+), 4 deletions(-)
 create mode 100644 .claude-plugin/marketplace.json

diff --git a/.claude-plugin/marketplace.json b/.claude-plugin/marketplace.json
new file mode 100644
index 0000000..ae26f21
--- /dev/null
+++ b/.claude-plugin/marketplace.json
@@ -0,0 +1,22 @@
+{
+  "name": "watch-cli",
+  "owner": {
+    "name": "Son Piaz",
+    "email": "sonxpiaz@gmail.com"
+  },
+  "metadata": {
+    "description": "watch-cli skill marketplace — Claude Code users can /plugin install watch-cli.",
+    "version": "0.3.0"
+  },
+  "plugins": [
+    {
+      "name": "watch-cli",
+      "description": "Compose yt-dlp + ffmpeg + Whisper into a single command that hands an AI agent the raw materials to watch any social video — VIDEO + FRAMES + TRANSCRIPT, ready for an LLM to read frames as images and transcript as text.",
+      "source": "./",
+      "strict": false,
+      "skills": [
+        "./skills/watch-cli"
+      ]
+    }
+  ]
+}
diff --git a/README.md b/README.md
index 5ea9c3c..194bfa0 100644
--- a/README.md
+++ b/README.md
@@ -93,7 +93,7 @@ signup is enough to run the full pipeline end-to-end before you spend a cent.
 ## Install
 
 ```bash
-# macOS — Homebrew (recommended once v0.3.0 ships)
+# macOS — Homebrew (recommended)
 brew tap sonpiaz/tap
 brew install watch-cli
 
@@ -101,9 +101,19 @@ brew install watch-cli
 curl -fsSL https://github.com/sonpiaz/watch-cli/releases/latest/download/install.sh | bash
 ```
 
-> The Homebrew path requires the v0.3.0 release to be cut first.
-> Until then, use the curl one-liner above — it auto-falls-back to
-> `git clone` of `main` when no published release exists yet.
+> The curl one-liner auto-falls back to `git clone` of `main` if no
+> published release tarball is reachable.
+
+### Claude Code (skill marketplace)
+
+If you use Claude Code, install watch-cli as a skill:
+
+```
+/plugin marketplace add sonpiaz/watch-cli
+/plugin install watch-cli@watch-cli
+```
+
+The agent then picks up `watch <url>` as a first-class command.
 
 Pin a specific version: