diff --git a/docs/uk/help/scripts.md b/docs/uk/help/scripts.md
index 387e5dc40..6d5baf42e 100644
--- a/docs/uk/help/scripts.md
+++ b/docs/uk/help/scripts.md
@@ -2,33 +2,59 @@
 read_when:
     - Запуск скриптів із репозиторію
     - Додавання або зміна скриптів у ./scripts
-summary: 'Скрипти репозиторію: призначення, область застосування та примітки щодо безпеки'
+summary: 'Скрипти репозиторію: призначення, сфера застосування та примітки з безпеки'
 title: Скрипти
 x-i18n:
-    generated_at: "2026-04-05T18:05:39Z"
+    generated_at: "2026-04-07T23:10:41Z"
     model: gpt-5.4
     provider: openai
-    source_hash: de53d64d91c564931bdd4e8b9f4a8e88646332a07cc2a6bf1d517b89debb29cd
+    source_hash: 3ecf1e9327929948fb75f80e306963af49b353c0aa8d3b6fa532ca964ff8b975
     source_path: help/scripts.md
     workflow: 15
 ---
 
 # Скрипти
 
-Каталог `scripts/` містить допоміжні скрипти для локальних робочих процесів і операційних завдань.
-Використовуйте їх, коли завдання явно пов’язане зі скриптом; в іншому разі віддавайте перевагу CLI.
+Каталог `scripts/` містить допоміжні скрипти для локальних робочих процесів та операційних завдань.
+Використовуйте їх, коли завдання явно пов’язане зі скриптом; в інших випадках віддавайте перевагу CLI.
 
-## Домовленості
+## Угоди
 
-- Скрипти **необов’язкові**, якщо на них немає посилання в документації або контрольних списках релізу.
+- Скрипти є **необов’язковими**, якщо на них немає посилання в документації або контрольних списках релізу.
 - Віддавайте перевагу поверхням CLI, коли вони існують (приклад: моніторинг автентифікації використовує `openclaw models status --check`).
-- Вважайте скрипти специфічними для хоста; перед запуском на новій машині прочитайте їх.
+- Вважайте, що скрипти залежать від хоста; перед запуском на новій машині ознайомтеся з ними.
 
 ## Скрипти моніторингу автентифікації
 
-Моніторинг автентифікації описано в [Authentication](/gateway/authentication). Скрипти в `scripts/` — це необов’язкові додатки для робочих процесів systemd/Termux на телефоні.
+Моніторинг автентифікації описано в [Автентифікація](/uk/gateway/authentication). Скрипти в `scripts/` — це необов’язкові додаткові інструменти для робочих процесів systemd/Termux на телефоні.
+
+## Допоміжний інструмент читання GitHub
+
+Використовуйте `scripts/gh-read`, коли хочете, щоб `gh` використовував токен встановлення GitHub App для викликів читання в межах репозиторію, водночас залишаючи звичайний `gh` на вашому особистому вході для дій запису.
+
+Обов’язкові env:
+
+- `OPENCLAW_GH_READ_APP_ID`
+- `OPENCLAW_GH_READ_PRIVATE_KEY_FILE`
+
+Необов’язкові env:
+
+- `OPENCLAW_GH_READ_INSTALLATION_ID`, якщо ви хочете пропустити пошук встановлення на основі репозиторію
+- `OPENCLAW_GH_READ_PERMISSIONS` як перевизначення підмножини дозволів на читання у форматі списку, розділеного комами
+
+Порядок визначення репозиторію:
+
+- `gh ... -R owner/repo`
+- `GH_REPO`
+- `git remote origin`
+
+Приклади:
+
+- `scripts/gh-read pr view 123`
+- `scripts/gh-read run list -R openclaw/openclaw`
+- `scripts/gh-read api repos/openclaw/openclaw/pulls/123`
 
 ## Під час додавання скриптів
 
-- Тримайте скрипти вузькоспрямованими й задокументованими.
-- Додайте короткий запис у відповідну документацію (або створіть її, якщо її бракує).
+- Підтримуйте скрипти сфокусованими та задокументованими.
+- Додайте короткий запис у відповідний документ (або створіть його, якщо його немає).