Agent Skills: як пакувати повторно використовувані можливості без перевантаження контексту

Коли обов’язки агента розширюються, йому можна щоразу давати більший system prompt. Цей підхід працює, доки інструкції не стають складними для пошуку, підтримки й тестування. Agent Skills пропонують модульніший варіант: процедури, скрипти та довідкові матеріали пакуються як можливості, які можна завантажувати за потреби.

Відкрита специфікація Agent Skills визначає skill як каталог із файлом SKILL.md, що містить metadata та інструкції. Додаткові папки можуть зберігати скрипти, довідкові матеріали й assets. Anthropic описує цей патерн як progressive disclosure: спочатку агент бачить стислі metadata, завантажує основні інструкції лише за відповідності завданню та відкриває допоміжні ресурси тільки тоді, коли вони потрібні. OpenAI документує сумісність із тим самим відкритим форматом для agent sandboxes і workflows на основі shell.

Що має входити до skill

Корисний skill містить процедурні знання для повторного використання: як перевірити PDF, підготувати release checklist, виконати конкретний аналіз або створити документ у затвердженому форматі.

Додайте:

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

Не перетворюйте skill на сховище всіх політик компанії. Глобальні правила безпеки й повноважень мають бути в довіреному harness або інструкціях верхнього рівня. Факти про проєкт мають залишатися у відповідному source of truth.

Skills та інструменти — не одне й те саме

Інструмент надає інтерфейс до дії або даних. Skill пояснює агенту, як і коли поєднувати дії, джерела й перевірки. Інструмент «створити рахунок» може приймати структуровані поля. Skill для роботи з кредиторською заборгованістю може пояснювати, які записи перевірити, який інструмент використати, коли потрібне погодження та як задокументувати винятки.

Skill може викликати інструменти, але не має непомітно розширювати їхні дозволи. Відповідальність за авторизацію залишається за runtime.

Проєктуйте для progressive disclosure

Пишіть metadata для пошуку й вибору, а не для маркетингу. Якщо опис нечіткий, агент пропустить skill або активує його для стороннього завдання. Основні інструкції мають бути достатньо компактними, щоб сприйматися як одна процедура. Докладні таблиці, шаблони та профільні довідки виносьте в окремі файли зі зрозумілими назвами.

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

Безпека та ризики supply chain

Skill може містити виконуваний код та інструкції, що впливають на використання інструментів. Ставтеся до недовіреного skill як до програмної залежності, яка ще не пройшла перевірку. Переглядайте скрипти, мережеві виклики, додані assets, кроки встановлення й запитувані інструменти. Фіксуйте або закріплюйте версії. Тестуйте в обмеженому середовищі до прийняття в робочий процес.

Оцінюйте і вибір skill, і результат

Тестування skill має відповідати на два окремі запитання: чи обрано правильний skill? Чи отримано потрібний результат без шкоди для іншої поведінки? Додайте завдання, для яких skill потрібний, схожі завдання, для яких він не має завантажуватися, та regression cases для наявних workflows.

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

Продовжуйте з матеріалами Context Engineering, «Інструменти AI-агентів і MCP» та Continual Improvement.

Першоджерела

• Agent Skills specification
• Anthropic: Equipping agents with Agent Skills
• OpenAI: Skills

Примітка про адаптацію: статтю підготовлено з урахуванням концепцій модульних можливостей з AI Agents in Depth: Design Principles and Engineering Practice авторства Bojie Li та співавторів, Apache License 2.0. Структуру й рекомендації незалежно розроблено на основі наведених специфікацій та інженерних джерел.