zaDojo
Уся документація

Скіл SEO Report для HTML-звітів

Як скіли zaDojo передають результати: один автономний HTML-звіт у твоєму проєкті, готовий до читання, друку чи надсилання за посиланням. Без кредитів.

SEO Report це скіл, яким інші скіли zaDojo передають свої результати. Коли агент завершує аудит, дослідження ключових слів чи аналіз конкурента, цей скіл пояснює йому, як оформити висновки як одну HTML-сторінку й зберегти її в проєкті zaDojo. Сторінка з'являється на сторінці Reports проєкту, де команда може читати її в застосунку, на телефоні чи на папері.

Ідея в тому, щоб завершена робота не губилася в прокручуванні чату. Звіт має назву, дату, сталу структуру й місце в проєкті, тож ти й наступний агент знайдете його й через місяць.

Як ним користуватися

Здебільшого ти його не викликаєш. Попроси потрібний процес, і звіт прийде разом із ним:

/zadojo:keyword-research Знайди ключові слова для нашої сторінки цін.

Його можна викликати напряму, коли потрібен звіт, якого не покриває жоден інший скіл, наприклад коротке зведення виконаної за місяць роботи чи звіт за одним зі збережених шаблонів:

Через seo-report напиши для клієнта підсумок змін позицій за цей місяць на одну сторінку.

Що робить агент, коли зберігає звіт

  1. Спершу він викликає list_reports. Якщо звіт на ту саму тему й за той самий період уже існує, агент виправляє власну роботу, тож замінює цей звіт, а не додає майже копію. Новий місяць, новий конкурент чи інший скіл дають новий звіт.
  2. Він пише стисло. Спочатку висновок і те, що він означає для бізнесу. Кожна рекомендація каже, що не так (з доказами), що змінити і що це може покращити, разом із тим, наскільки агент упевнений. Для чисел вказано, чи їх дав інструмент, чи їх перевірено вручну.
  3. Він створює одну автономну сторінку. Усі стилі всередині файлу. Немає вебшрифтів, скриптів і зображень з інших сайтів, тож сторінка всюди виглядає однаково й чисто друкується. Графіки це вбудований SVG або прості смуги, завжди з числами поруч.
  4. Останній розділ, «How this report was made», називає скіл, який створив звіт, посилається на сторінку цього скіла в цій документації і каже, які інструменти дали які числа і що агент перевірив сам.
  5. Разом зі сторінкою save_report зберігає короткий підсумок, який повертає list_reports, щоб наступна сесія могла продовжити роботу, не відкриваючи весь HTML.
  6. Відповідь у чаті лишається короткою: щонайбільше три пункти (висновок, головна рекомендація й те, що тобі треба зробити), а потім посилання.

Де знайти звіти

Відкрий сторінку Reports на бічній панелі проєкту. Назви звітів містять тип звіту чи його тему й повну дату створення. Назва не містить твого власного сайту, але містить інший домен, якщо звіт про чужий сайт. Звіт можна відкрити на весь екран, в окремій вкладці або надрукувати в PDF.

Збережений звіт не має історії версій. Коли агент виправляє звіт, нова версія замінює стару.

Кожен звіт спочатку доступний лише твоїй організації. Щоб поділитися ним:

  • попроси агента: «зроби цей звіт публічним і дай мені посилання», або
  • відкрий звіт, натисни Share й увімкни Public link.

Будь-хто з посиланням може читати звіт без акаунта zaDojo. Посилання завжди показує останню збережену версію, а сторінка просить пошукові системи її не індексувати. Вимкни перемикач, і посилання перестане працювати (вже відкрита сторінка може ще до хвилини довантажуватися). Якщо потім знову ввімкнути доступ, з'явиться нове посилання.

Агент публікує звіт, лише коли ти прямо про це просиш. Прохання про звіт, «готовий для клієнта», не робить його публічним.

Шаблони звітів

Шаблон це збережений бриф для певного типу звіту: хто його читає, які розділи й у якому порядку, тон і підпис. Шаблонами керують на сторінці Templates, куди можна перейти зі сторінки Reports. Шаблони належать одному проєкту. Щоб використати шаблон деінде, попроси агента знайти його в першому проєкті й зберегти копію в другому.

Агент дотримується шаблону, коли ти називаєш його або просиш звіт того типу, який він описує, наприклад «напиши щомісячний звіт для клієнта для example.com». Просте «зроби аудит цього сайту» все одно використовує звичайний формат скіла. Шаблон змінює розділи, аудиторію й тон. Він не може змінити спосіб побудови сторінки, тож звіт за шаблоном так само друкується й працює на телефоні. Твої вподобання щодо текстів у проєкті діють поверх нього, а шаблон перемагає лише там, де вони суперечать одне одному.

Скільки це коштує

Нічого. Написання, збереження, перегляд списку й поширення звітів не витрачають кредитів. Дослідження, яке йде у звіт, оплачується скілом, що його виконує.

Поради

  • Проси задачу, а не формат. «Зроби аудит example.com» і так дасть звіт.
  • Скажи, для кого звіт. Агент напише підпис і підлаштує мову під цього читача.
  • Якщо звіт треба виправити, попроси агента. Він оновить той самий звіт, а не створить другий.
  • Агенти редагують звіт за збереженим підсумком, бо повний HTML довгого звіту може бути завеликим, щоб прочитати його назад. Для великої зміни в старому звіті часто простіше перезапустити скіл.

Вихідний код

SKILL.md разом зі стартовим HTML-шаблоном, з якого будується кожен звіт:

Скіли, що звітують через нього