From 1432d925a8ac02267dc51004813ef98d14f29477 Mon Sep 17 00:00:00 2001
From: Anton Vakhrushev <anwinged@ya.ru>
Date: Fri, 24 Jul 2026 08:55:07 +0300
Subject: [PATCH] =?UTF-8?q?docs:=20README=20=E2=80=94=20=D1=83=D1=81=D1=82?=
 =?UTF-8?q?=D0=B0=D0=BD=D0=BE=D0=B2=D0=BA=D0=B0=20=D0=BF=D0=BB=D0=B0=D0=B3?=
 =?UTF-8?q?=D0=B8=D0=BD=D0=B0=20=D0=BD=D0=B0=20=D1=83=D1=80=D0=BE=D0=B2?=
 =?UTF-8?q?=D0=BD=D0=B5=20=D0=BF=D1=80=D0=BE=D0=B5=D0=BA=D1=82=D0=B0?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Ведущий способ подключения — через .claude/settings.json проекта
(extraKnownMarketplaces + enabledPlugins по git-URL), чтобы плагин был активен
у всех, кто открывает репозиторий. Интерактивная установка через /plugin —
как разовая альтернатива. Локальный путь заменён на реальный remote.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
---
 README.md | 32 ++++++++++++++++++++++++++++----
 1 file changed, 28 insertions(+), 4 deletions(-)

diff --git a/README.md b/README.md
index ddbd282..9d80ae1 100644
--- a/README.md
+++ b/README.md
@@ -5,12 +5,36 @@
 
 ## Подключение
 
-```
-/plugin marketplace add /home/av/projects/private/dev-skills
-/plugin install av-dev-backlog@av-dev-skills
+Типичный способ — подключить плагин **на уровне проекта**, чтобы он был активен у
+всех, кто открывает репозиторий. В `.claude/settings.json` проекта (коммитится в
+репозиторий) объявляем маркетплейс и включаем плагин:
+
+```json
+{
+  "extraKnownMarketplaces": {
+    "av-dev-skills": {
+      "source": {
+        "source": "url",
+        "url": "ssh://git@git.vakhrushev.me:2222/av/dev-skills.git"
+      }
+    }
+  },
+  "enabledPlugins": {
+    "av-dev-backlog@av-dev-skills": true
+  }
+}
 ```
 
-Маркетплейс можно добавить и по git-URL, если репозиторий будет опубликован.
+При первом открытии проекта Claude Code попросит доверять воркспейсу; после
+подтверждения маркетплейс и включённые плагины подгружаются автоматически. Ключ
+включения — `"<плагин>@<маркетплейс>": true`.
+
+Разово для себя, без правки настроек проекта — интерактивно:
+
+```
+/plugin marketplace add ssh://git@git.vakhrushev.me:2222/av/dev-skills.git
+/plugin install av-dev-backlog@av-dev-skills
+```
 
 ## Плагины