diff --git a/README.md b/README.md
index 9d80ae1..2fbdf39 100644
--- a/README.md
+++ b/README.md
@@ -6,8 +6,24 @@
 ## Подключение
 
 Типичный способ — подключить плагин **на уровне проекта**, чтобы он был активен у
-всех, кто открывает репозиторий. В `.claude/settings.json` проекта (коммитится в
-репозиторий) объявляем маркетплейс и включаем плагин:
+всех, кто открывает репозиторий. Флаг `--scope project` пишет прямо в
+`.claude/settings.json` проекта (коммитится в репозиторий) — из интерактивной
+сессии Claude Code:
+
+```
+/plugin marketplace add ssh://git@git.vakhrushev.me:2222/av/dev-skills.git --scope project
+/plugin install av-dev-backlog@av-dev-skills --scope project
+```
+
+…или те же команды из терминала:
+
+```
+claude plugin marketplace add ssh://git@git.vakhrushev.me:2222/av/dev-skills.git --scope project
+claude plugin install av-dev-backlog@av-dev-skills --scope project
+```
+
+Обе формы дописывают в `.claude/settings.json` ровно то, что можно внести и
+руками — маркетплейс в `extraKnownMarketplaces`, плагин в `enabledPlugins`:
 
 ```json
 {
@@ -29,7 +45,8 @@
 подтверждения маркетплейс и включённые плагины подгружаются автоматически. Ключ
 включения — `"<плагин>@<маркетплейс>": true`.
 
-Разово для себя, без правки настроек проекта — интерактивно:
+Без `--scope project` те же команды пишут в user-конфиг — разовая установка
+только себе, настройки проекта не трогаются:
 
 ```
 /plugin marketplace add ssh://git@git.vakhrushev.me:2222/av/dev-skills.git