diff --git a/.wiki/log.md b/.wiki/log.md
index bc9a8a0..abc459a 100644
--- a/.wiki/log.md
+++ b/.wiki/log.md
@@ -29,3 +29,4 @@ Parseable: `grep "^## \[" .wiki/log.md | tail -20`.
 ## [2026-04-28] cleanup | removed stale `~/.claude/skills/{wiki-maintainer,task-status-wiki}/` installs (replaced by `using-wiki`/`using-tasks`); 16 skills installed, no duplicates; context7 plugin (mcp__plugin_context7_context7__*) confirmed live after restart
 ## [2026-04-28] decision | install-portability — `install.sh`/`build.sh` patched to drop `mapfile`+`find -printf`; stock macOS (bash 3.2 + BSD find) now works; verified on git-bash (16 skills discovered, sorted, installed; build.sh produces archive)
 ## [2026-04-28] decision | project-bootstrap@1.1.0 — added Step 5.6: detects `superpowers@claude-plugins-official` via `~/.claude/plugins/installed_plugins.json` and prints install command + upstream link if missing; chat-only, never auto-installs (slash commands aren't callable from a skill, and silent plugin install is overreach)
+## [2026-04-28] doc | README.md + README.ru.md — new "Using skills in projects" / "Использование в проектах" section after install quick-start; describes project-bootstrap workflow (git, .gitignore, README, .wiki/, .tasks/, CLAUDE.md, manifest, superpowers-plugin check) and the init/upgrade modes
diff --git a/README.md b/README.md
index f151ed0..97876d7 100644
--- a/README.md
+++ b/README.md
@@ -41,6 +41,25 @@ The install target can be overridden with `CLAUDE_SKILLS_DIR=/path bash scripts/
 
 > `install.sh` works on Windows under git-bash. A native `install.ps1` is on the task board but not yet implemented.
 
+### Using skills in projects
+
+Once the skills are installed, the easiest way to wire them into a new
+(or existing) project is the [`project-bootstrap`](skills/project-bootstrap/)
+skill. Tell the agent **"bootstrap"** or **"set everything up"** from the
+project's folder and it will, in one pass:
+
+- initialize `git` (if missing) and write a sane `.gitignore`
+- create a starter `README.md`
+- lay out `.wiki/` per the [Karpathy LLM Wiki pattern](https://gist.github.com/karpathy/442a6bf555914893e9891c11519de94f) (delegated to [`setup-wiki`](skills/setup-wiki/))
+- lay out `.tasks/` with the canonical task board (delegated to [`setup-tasks`](skills/setup-tasks/))
+- write `CLAUDE.md` with skill triggers (`use superpowers`, `use project wiki`, `use task management system`, `we're on Windows`)
+- record the skill versions used in `.wiki/concepts/bootstrap-manifest.md` so cross-project layout drift stays debuggable
+- check whether the official `superpowers@claude-plugins-official` plugin is installed and, if not, print the install command — the `use superpowers` trigger is a no-op without it
+
+Two modes, picked automatically: **init** for an empty folder, **upgrade**
+for an existing project (the skill only fills the gaps and never overwrites
+without explicit confirmation).
+
 ### Edit a skill
 
 ```bash
diff --git a/README.ru.md b/README.ru.md
index ee5d28a..3074f83 100644
--- a/README.ru.md
+++ b/README.ru.md
@@ -27,6 +27,25 @@ bash scripts/install.sh caveman wiki-maintainer
 
 Цель установки можно переопределить переменной `CLAUDE_SKILLS_DIR=/path bash scripts/install.sh`.
 
+### Использование в проектах
+
+Когда скиллы установлены, проще всего раскатить их на новый (или
+существующий) проект через скилл [`project-bootstrap`](skills/project-bootstrap/).
+Скажи агенту **«bootstrap»** или **«настрой проект»** в папке проекта — он
+за один проход:
+
+- инициализирует `git` (если ещё нет) и положит вменяемый `.gitignore`
+- создаст стартовый `README.md`
+- развернёт `.wiki/` по [паттерну Karpathy LLM Wiki](https://gist.github.com/karpathy/442a6bf555914893e9891c11519de94f) (делегируется в [`setup-wiki`](skills/setup-wiki/))
+- развернёт `.tasks/` с канонической доской задач (делегируется в [`setup-tasks`](skills/setup-tasks/))
+- запишет `CLAUDE.md` со скилл-триггерами (`use superpowers`, `use project wiki`, `use task management system`, `we're on Windows`)
+- зафиксирует версии использованных скиллов в `.wiki/concepts/bootstrap-manifest.md`, чтобы дрифт раскладки между проектами оставался отлаживаемым
+- проверит, установлен ли официальный плагин `superpowers@claude-plugins-official`, и если нет — выведет команду установки (без плагина триггер `use superpowers` мёртвый)
+
+Два режима, выбирается автоматически: **init** для пустой папки и **upgrade**
+для существующего проекта (скилл только дозаполняет пробелы и ничего не
+перезаписывает без явного подтверждения).
+
 ### Отредактировать скилл
 
 ```bash