AI постійно робить не те? Як перестати пояснювати одне й те саме

Коротко: якщо AI постійно робить «майже те, але не те», причина часто не в моделі, а в неповному брифі. Grilling - це текстова інструкція, яка змушує Claude Code або Codex спочатку поставити Вам запитання по одному, знайти приховані припущення й уточнити межі задачі. Лише після цього AI переходить до виконання.

Ви описуєте задачу. AI впевнено видає результат. Ви дивитесь - і це «майже те, але не те». Пояснюєте вдруге. Потім втретє. Додаєте приклад, уточнюєте формулювання, але знову отримуєте роботу, яку треба переробляти.

Знайома ситуація? Найчастіше проблема не в моделі, а в брифі. Половина задуму залишається у Вас у голові: для кого результат, що саме вважати успіхом, чого не можна робити і що робити у виняткових випадках. Для AI це не очевидність, а прогалина, яку він заповнює власним припущенням.

Grilling змінює порядок роботи: спочатку AI ставить запитання, а вже потім виконує задачу.

Що таке Grilling простими словами

Grilling - це коротка інструкція у файлі SKILL.md. Вона описує, як AI має поводитися перед складною або неоднозначною задачею:

• ставити одне питання за раз;
• чекати Вашої відповіді;
• знаходити приховані припущення;
• уточнювати крайні випадки;
• пропонувати рекомендований варіант відповіді;
• не починати роботу, доки спільне розуміння не підтверджене.

Тобто AI перестає бути виконавцем, який одразу вгадує Ваш задум, і спочатку стає інтерв'юером. Ви відповідаєте на питання, а він поступово перетворює нечітку ідею на зрозумілий план.

Як виглядає процес

1. Ви даєте задачу.
2. AI ставить одне уточнювальне питання.
3. Ви відповідаєте.
4. AI ставить наступне питання з урахуванням попередньої відповіді.
5. Коли прогалин не залишилося, AI коротко переказує спільне розуміння.
6. Після Вашого підтвердження він переходить до виконання.

Це схоже на бриф із хорошим спеціалістом: спочатку він перевіряє, що саме треба зробити, а не відкриває редактор після першого речення.

Кому Grilling допомагає найбільше

Скіл особливо корисний, якщо Ви:

• кілька разів пояснюєте AI одну й ту саму задачу;
• отримуєте впевнений, але неправильний результат;
• бачите, що AI сам додумує важливі деталі;
• працюєте над текстом, стратегією, архітектурою або кодом;
• не хочете писати довге технічне завдання наперед.

Для простої задачі на кшталт «переклади це речення» Grilling може бути зайвим. Його сила - у задачах, де неправильне припущення коштує переробки.

Що таке grilling і grill-me

У репозиторії Matt Pocock Skills є два пов'язані файли:

• `grilling/SKILL.md` - основна інструкція для допиту й узгодження плану;
• `grill-me/SKILL.md` - коротка обгортка, яка просить запустити /grilling.

Тобто це не дві різні технології. grilling містить основну логіку, а grill-me допомагає викликати її вручну.

Безпека: що саме встановлюється

Цей пункт важливіший за саму команду встановлення.

Що безпечно у самому скілі

SKILL.md - це Markdown-файл, тобто звичайний текст з інструкціями для AI. Сам по собі він:

• не запускає код;
• не змінює файли;
• не підключається до сервера;
• не читає паролі, API-ключі чи cookies;
• не виконує команди безпосередньо.

Його завдання - змінити порядок діалогу: спочатку поставити питання, потім виконувати Вашу задачу.

Де виникає ризик

Ризик починається не в тексті SKILL.md, а під час завантаження файлів командою інсталятора. Тому:

1. Перевіряйте точну адресу офіційного репозиторію.
2. Не копіюйте команди зі випадкових постів і скриншотів.
3. Перед запуском команди прочитайте, що саме вона завантажує і куди записує.
4. Якщо не впевнені, спочатку попросіть AI пояснити команду простими словами.
5. Після встановлення перегляньте створені файли й перевірте, чи скіл справді підхопився.

Універсальний CLI skills також має власні правила телеметрії - у його README зазначено, що він збирає анонімні дані використання. Це окремий фактор, який варто врахувати, якщо для Вас важливий режим без телеметрії.

Порівняння способів встановлення

Як встановити в Claude Code

Варіант 1 - вибрані скіли через Agent Skills

Це найзручніший варіант, якщо Вам потрібні саме grilling і grill-me, а не весь набір автора:

npx skills@latest add mattpocock/skills \
  --skill grilling \
  --skill grill-me \
  --agent claude-code \
  --global

Після встановлення відкрийте Claude Code у новій або поточній сесії та перевірте виклик:

/grilling

Персональні скіли Claude Code зберігаються у ~/.claude/skills/<skill-name>/SKILL.md. Для одного проєкту використовуйте .claude/skills/<skill-name>/SKILL.md.

Варіант 2 - native plugin Claude Code

Офіційний README автора також описує plugin-спосіб:

claude plugin marketplace add mattpocock/skills
claude plugin install mattpocock-skills@mattpocock

Після цього один раз запустіть:

/setup-matt-pocock-skills

Цей спосіб встановлює керований пакет скілів автора. Якщо Вам потрібен тільки grilling, краще використати перший спосіб і вибрати конкретні скіли.

Як встановити в Codex

Для Codex використовуйте той самий Agent Skills-інсталятор, але вкажіть інший агент:

npx skills@latest add mattpocock/skills \
  --skill grilling \
  --skill grill-me \
  --agent codex \
  --global

Codex підтримує два основні способи підключення:

• user scope: ~/.agents/skills/<skill-name>/SKILL.md;
• repository scope: .agents/skills/<skill-name>/SKILL.md у Вашому проєкті.

Для командної роботи краще repository scope: скіл лежить поруч із проєктом і його бачить команда. Для особистого використання з різними проєктами зручніший user scope.

Після встановлення Codex може побачити скіл автоматично. Якщо він не з'явився у списку, перезапустіть Codex. Для явної перевірки згадайте скіл у запиті через $grilling або відкрийте список доступних скілів.

Універсальний спосіб через npx

Інсталятор Vercel Labs Skills підтримує Claude Code, Codex та інші сумісні Agent Skills-інструменти. Загальна форма команди:

npx skills@latest add mattpocock/skills \
  --skill grilling \
  --skill grill-me \
  --agent <agent-name> \
  --global

Замість <agent-name> підставте, наприклад, claude-code або codex. Перед запуском перевірте актуальні назви агентів у README інсталятора.

Варіант без --global встановлює скіл на рівні поточного проєкту. Це зручно, якщо скіл потрібен тільки в одному репозиторії.

Ручне завантаження скілу

Це найпрозоріший спосіб: Ви спочатку читаєте весь текст, а потім самі копіюєте його у потрібну папку.

1. Відкрийте основний `grilling/SKILL.md`.
2. Відкрийте обгортку `grill-me/SKILL.md`.
3. Перевірте YAML-заголовок і текст інструкції.
4. Створіть папки grilling і grill-me у потрібному scope.
5. Збережіть відповідні файли під назвою SKILL.md.
6. Перезапустіть агент, якщо він не побачив нову папку.

Для Claude Code це буде:

~/.claude/skills/grilling/SKILL.md
~/.claude/skills/grill-me/SKILL.md

Для Codex у user scope:

~/.agents/skills/grilling/SKILL.md
~/.agents/skills/grill-me/SKILL.md

Як перевірити, що скіл працює

Дайте AI не маленьку команду, а навмисно неповну задачу, наприклад: «Зроби мені лендинг для послуги».

Скіл працює, якщо AI не починає одразу писати сторінку, а питає:

• для кого лендинг;
• яка головна дія відвідувача;
• що станеться, якщо користувач не заповнить форму;
• які обмеження та матеріали вже є.

Питання мають з'являтися по одному. Якщо AI одразу видав готовий результат, перевірте, чи файл лежить у правильній папці, чи правильний scope обрано і чи агент бачить оновлений список скілів.

Чесні обмеження

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

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

FAQ

Це скіл тільки для програмістів?

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

Чи гарантує Grilling ідеальний результат?

Ні. Він зменшує ризик непорозуміння на вході, але фінальну перевірку все одно робите Ви.

Чи запускає SKILL.md код?

Ні. Сам файл є текстовою інструкцією Markdown. Окремо треба оцінювати безпеку команди, якою Ви його завантажуєте.

Чим grill-me відрізняється від grilling?

grilling - основна інструкція. grill-me - коротка обгортка, яка запускає /grilling.

Що вибрати: Claude Code чи Codex?

Використовуйте той інструмент, у якому Ви вже працюєте. Логіка скілу однакова, а відрізняються переважно команда встановлення, папка та спосіб явного виклику.

Чи можна нічого не встановлювати?

Так. Завантажте SKILL.md, прочитайте його і вставте текст у свій AI-діалог як інструкцію. Це ручний, але повністю прозорий спосіб.

Висновок

Якщо Ви втретє пояснюєте AI одне й те саме, спробуйте змінити порядок: нехай спочатку він поставить питання Вам.

Grilling не замінює Ваше рішення і не скасовує перевірку результату. Але він допомагає дістати з голови ті деталі, які зазвичай з'являються лише після першої невдалої спроби.

Більше практичних розборів AI для роботи й бізнесу - у Telegram-каналі AIevgen CREATOR.