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
+```
 
 ## Плагины