diff --git a/docs/db-guide.md b/docs/db-guide.md
index c48be112..be5e1468 100644
--- a/docs/db-guide.md
+++ b/docs/db-guide.md
@@ -159,6 +159,28 @@ PowerShell не умеет собирать массив из отдельных
 - параметр «не своего» движка (`-AdditionalV8Arguments` при выбранном `ibcmd`). Ключи из
   `.v8-project.json` в этом случае просто не применяются — реестр проекта может описывать оба движка.
 
+## Что печатает навык
+
+Порядок один и тот же в обоих портах и на обоих движках:
+
+1. `Running: …` — командная строка запуска (секреты замаскированы, см. ниже);
+2. результат операции одной строкой;
+3. `--- Log ---` … `--- End ---` — журнал платформы из `/Out` (у `ibcmd` его нет);
+4. `--- Вывод платформы ---` … `--- End ---` — то, что платформа написала в консоль.
+
+Четвёртый блок появляется, только если платформа что-то написала. В пакетном режиме
+`1cv8` пишет в `/Out` и молчит в консоли, поэтому обычно блока нет; он всплывает при
+аварийном завершении, когда сообщение проходит мимо `/Out`. `ibcmd`, наоборот, весь свой
+вывод (`[INFO] …`) шлёт именно туда.
+
+Кодировка определяется по факту: UTF-8, при неудаче — cp866. Гадать нельзя — `ibcmd`
+пишет UTF-8, а аварийный текст `1cv8` приходит в OEM.
+
+Путевые параметры прощают обрамляющие кавычки, пробелы по краям и хвостовой разделитель.
+Навыки, работающие с готовой базой, проверяют её наличие до запуска и говорят
+«information base not found at X» вместо платформенного «Неверные или отсутствующие
+параметры соединения».
+
 В строке `Running: …` значения секрето-опасных ключей (`/P`, `/UC`, `--password`, `--token`)
 заменяются на `***`. Ограничения разбора, о которых стоит знать: