Внутрішня документація · Fortunatos

Як зробити гарний звіт

Інструкція для команди - як користуватись скілом pretty-report у Claude Code, щоб перетворити сирі дані (Excel, скріни, CSV) у клієнтський HTML-звіт і задеплоїти його на Cloudflare.

1.Що потрібно встановити один раз

Це робиться один раз на кожному робочому ноутбуці, не перед кожним звітом.

  1. 1
    Claude Code Якщо ще не встановлено - звернутись до Артема, потрібна ліцензія/акаунт агенції.
  2. 2
    Python 3 і дві бібліотеки Потрібні для читання Excel-файлів і стиснення скріншотів перед вставкою у звіт. 
    pip3 install openpyxl Pillow
  3. 3
    Wrangler (деплой на Cloudflare Pages) Достатньо запускати через npx, окрема інсталяція не обов'язкова - але потрібен Node.js. 
    npx wrangler login
⚠️
Питання команді: логінитись у Cloudflare своїм акаунтом чи агенційним спільним? Це впливає на те, хто бачить/може видаляти чужі задеплоєні звіти. Вирішити разом з Артемом до першого запуску.
···

2.Як отримати сам скіл

Скіл поки живе локально в Артема - перед першим використанням треба скопіювати файли собі.

Файли кладуться у папку скілів Claude Code на вашому ноутбуці:

~/.claude/skills/pretty-report/

Попросити в Артема архів папки (або, якщо буде спільний приватний GitHub-репо - клонувати його). Після копіювання Claude Code підхоплює скіл автоматично, нічого додатково активувати не треба.

···

3.Як користуватись

Відкрити Claude Code у терміналі, дати команді сирі дані і сформулювати запит своїми словами - скіл підхоплюється автоматично.

"зроби красивий звіт з цього" "оформи це в звіт для клієнта" "нужен отчёт для клиента" "перетвори ці таблиці на презентабельну сторінку"
💬
Приклад запиту: "Ось вивантаження з GSC і Ahrefs за червень (два файли), зроби красивий SEO-звіт для agromat.ua і задеплой на Cloudflare."
···

4.Що підготувати заздалегідь

Що датиНавіщо
Excel/CSV вивантаженняGSC, Ahrefs, Ads-платформи - будь-що з цифрами за період
Скріншоти дашбордівЯкщо є графік, якого немає в цифрах (наприклад тренд у GSC) - краще прикласти скрін
Період звітуОдним реченням - "червень 2026" тощо, це стає заголовком
Назва клієнтаВикористовується для назви папки і Cloudflare-проєкту
···

5.Що вийде на виході

···

6.Брендинг Fortunatos

Якщо звіт подається від імені агенції (не white-label під клієнта) - попросити явно.

🎨
Фраза-тригер: "зроби у стилі агенції" / "додай наше лого". Скіл вже знає фірмову палітру (#FF4D37), шрифт і має логотип Fortunatos у вигляді SVG - не потрібно нічого прикладати вручну.
···

7.Перед відправкою клієнту

Клод перевіряє це сам, але добре тримати в голові при фінальному погляді.