Anthropic передала стандарт Agent Skills до Linux Foundation

Anthropic передала стандарт Agent Skills до Linux Foundation — того самого фонду, якому раніше передали MCP.

З моменту запуску стандарту в жовтні минулого року опубліковано 1 мільйон скилів, які встановили майже 280 мільйонів разів. Сьогодні Agent Skills підтримують понад 70 платформ для ШІ-агентів, зокрема ChatGPT, Cursor, GitHub Copilot і VS Code.

За останній рік сформувався єдиний підхід до створення скилів. Офіційне керівництво з їх розробки також передано фонду.

Шість найкорисніших правил із цього керівництва:

1. Спочатку виконайте задачу разом з агентом. Лише після цього перетворюйте успішні кроки, внесені вами виправлення, формати вхідних і вихідних даних, а також додатковий контекст на скил. Якщо модель пише скил, покладаючись лише на загальні знання, результат буде сповнений непотрібних рекомендацій на кшталт «належно обробляйте помилки».

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

3. Особливу увагу приділяйте опису скила. Під час запуску агент читає лише назву й опис, тому саме опис визначає, чи буде скил взагалі використано. Формулюйте його як «Використовуй цей скил, коли...», робіть достатньо наполегливим, перелічуйте ситуації, які користувачі можуть не вказувати напряму, і вкладайтеся в 1024 символи.

4. Не перевантажуйте SKILL.md. Обмежте його 500 рядками та 5000 токенів. Подробиці виносьте в каталог references/, вказуючи, коли агенту слід читати кожен файл.

5. Розділяйте жорсткі інструкції та рекомендації. Для дій, у яких особливо легко допустити помилку, вказуйте точні команди. Там, де потрібне самостійне рішення, пояснюйте причини вибору. Якщо задачу можна виконати кількома способами, запропонуйте один варіант за замовчуванням.

6. Складайте список типових помилок (gotchas). У багатьох скилах саме він виявляється найкориснішою частиною. Щоразу, коли вам доводиться виправляти помилку агента, додавайте відповідне зауваження до списку.

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

Приклад промпту:

Дотримуючись керівництва Agent Skills Best Practices, перетвори задачу, яку ми щойно виконали, на скил.

Використовуй лише ті кроки, які успішно спрацювали в цій сесії, мої виправлення та пов’язані з ними рішення з файлів CLAUDE.md, AGENTS.md й історії Git. Не заповнюй прогалини загальними знаннями.

Сформулюй опис у форматі «Використовуй цей скил, коли...». Додай ситуації, які я не згадував напряму, але в яких скил має активуватися. Довжина опису не повинна перевищувати 1024 символи.

Обмеж розмір SKILL.md 500 рядками. Подробиці винось у каталог references/, зазначивши, у яких випадках агенту слід звертатися до кожного файлу.

Виділи окремий розділ із типовими помилками та підводними каменями.

Для назви скила використовуй лише малі латинські літери, цифри й дефіси. Назва має збігатися з іменем каталогу.

На завершення створи 2–3 реальні тестові сценарії у файлі evals/evals.json, вказавши для кожного промпт і очікуваний результат. Запусти всі тести, покажи їхні результати та опиши виконані дії.