Agent Skills стали відкритим стандартом: як написати свій перший SKILL.md

Коли якась технологія передається незалежному фонду, це зазвичай означає, що вона перестала бути експериментом однієї компанії. Саме це щойно сталося з Agent Skills — форматом, у якому AI-агентам описують робочі процедури. І якщо ви працюєте з Claude Code, Cursor або Copilot, це напряму впливає на те, як ви будете користуватися ними наступного року.

Що сталося 22 жовтня

Anthropic передала Agent Skills у Agentic AI Foundation (AAIF) — проєкт Linux Foundation, який Anthropic співзаснувала разом із Block та OpenAI. Раніше туди ж передали MCP (Model Context Protocol), тож тепер два базові формати агентної екосистеми живуть в одному нейтральному місці.

Передали не лише код, а й усе, що робить проєкт проєктом: назву й логотип, організацію на GitHub і домен agentskills.io, де опублікована специфікація. Підтримують стандарт інженери з Anthropic, Google, OpenAI та інших компаній — причому як окремі люди, а не представники роботодавців. Lead Maintainers — David Soria Parra і Mahesh Murag.

Кілька цифр, які показують масштаб. Стандарт опублікували в грудні 2025 року, і за цей час його інтегрували понад 70 агентних платформ, серед них ChatGPT, Cursor, GitHub Copilot і VS Code. Опубліковано близько мільйона скілів, а кількість встановлень — близько 280 мільйонів.

Важлива деталь для тих, хто насторожено ставиться до «відкритих» стандартів великих компаній: користуватися Agent Skills і робити внески можна без вступу у фонд. У заявленій дорожній карті — версіонування релізів, формальний процес пропозицій і окремі рекомендації з безпеки.

Що таке скіл насправді

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

Жодного нового формату даних, жодного SDK. Текстовий файл і папка.

Anthropic розробила цей формат, працюючи над Claude Code, і причина була конкретна: моделі добре знають мови програмування, але не знають вашого порядку дій. Як саме у вашій команді роблять code review. Які поля обов'язкові у вашому звіті. Що означає «готово» для вашої задачі. Це процедурні знання, і раніше їх доводилося щоразу переказувати в чаті.

Скіли проти MCP: у чому різниця

Це найчастіша плутанина, і її варто розвести одразу, бо обидва стандарти тепер у одному фонді.

• MCP відповідає на питання «до чого агент має доступ». Він підключає інструменти, джерела даних і зовнішні системи: базу, трекер задач, файли, API.
• Agent Skills відповідають на питання «як саме виконувати роботу». Це порядок кроків, критерії якості, типові помилки, межі задачі.

Коротка аналогія: MCP дає агенту руки, а скіл — інструкцію. Доступ до бази не підказує, як робити щомісячний звіт; опис процедури звіту не допоможе, якщо до бази немає доступу. На практиці вони працюють разом. Якщо MCP для вас нова тема, почніть зі статті що таке MCP або з короткого визначення в глосарії.

Пишемо перший SKILL.md

Найкращий спосіб зрозуміти формат — зробити скіл для власної рутинної задачі. Візьмемо реальну: перевірка Python-коду перед тим, як відкрити pull request.

Структура папки:

code-review-python/
  SKILL.md
  checklist.md

Сам SKILL.md — це текст із коротким заголовком-описом і тілом інструкції:

---
name: code-review-python
description: Перевіряє Python-код перед pull request за командним
  чеклистом. Використовувати перед створенням PR або коли просять
  "перевір мій код".
---

# Перевірка Python-коду перед PR

## Коли застосовувати
Перед відкриттям pull request або на прямий запит про перевірку коду.

## Порядок дій
1. Прочитай diff повністю, перед тим як комментувати хоч щось.
2. Пройди `checklist.md` по пунктах і для кожного дай вердикт:
   ок / проблема / не застосовується.
3. Для кожної проблеми вкажи файл і рядок, причину і конкретну
   пропозицію — не загальну пораду.
4. Окремо перевір тести: чи є вони на новий код і чи перевіряють
   поведінку, а не реалізацію.
5. Підсумуй трьома рядками: що блокує merge, що варто виправити
   зараз, що можна залишити на потім.

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

У checklist.md складаєте власні пункти: обробка помилок, валідація вхідних даних, логування без персональних даних, міграції БД, зворотна сумісність API — те, на чому ваша команда реально спотикається.

Точні поля специфікації й те, куди саме кладеться папка скіла, залежать від інструмента — дивіться документацію свого агента та специфікацію на agentskills.io. Але принцип однаковий: опис, за яким видно, коли застосовувати, і тіло з порядком дій.

Як писати скіли, які справді працюють

Кілька правил, які стають очевидними після першої спроби.

1. Опис важливіший за тіло. Саме за описом агент вирішує, чи брати скіл узагалі. «Перевірка коду» — поганий опис. «Перевіряє Python-код перед pull request за командним чеклистом» — робочий.
2. Один скіл — одна задача. Скіл «усе про наш проєкт» не застосується ніколи, бо незрозуміло, коли він потрібен.
3. Пишіть порядок, а не побажання. «Якісно перевір код» не є інструкцією. «Прочитай diff повністю, потім пройди чеклист по пунктах» — є.
4. Додайте розділ «чого не робити». Це економить більше часу, ніж будь-який інший розділ.
5. Виносьте деталі в окремі файли. Довгі чеклисти, приклади, довідники краще тримати поряд і згадувати у SKILL.md, а не вкладати все в один файл.
6. Перевірте на реальній задачі. Скіл, який жодного разу не застосовувався, майже завжди містить пропущений крок.

Безпека: чужі скіли — це чужий код

Мільйон опублікованих скілів означає, що більшість із них писали незнайомі вам люди. Скіл може містити скрипти, а отже встановлення чужого скіла — це те саме, що запуск чужого коду: його треба прочитати перед застосуванням.

Те, що в дорожній карті стандарту окремо заявлені рекомендації з безпеки для авторів і для тих, хто встановлює скіли, варто читати як визнання: проблема реальна і про неї думають на рівні стандарту. До появи цих рекомендацій правило просте — відкрийте SKILL.md і подивіться, що він просить зробити.

Що це означає для розробника

Передача стандарту у фонд — це сигнал, що формат не зникне разом зі зміною стратегії однієї компанії. Для вас це означає, що час, витрачений на розуміння формату, не пропаде.

Але є важливіший висновок. Коли агент уміє виконати процедуру, цінність зсувається до вміння цю процедуру сформулювати: розкласти роботу на кроки, визначити критерії готовності, назвати межі й типові помилки. Це та сама навичка, якої потребує робота в команді з людьми — писати зрозумілі задачі й чіткі визначення готовності. Просто тепер вона має ще одне застосування й помітний ефект.

Практичний крок на цей тиждень: візьміть одну задачу, яку ви робите щотижня руками, і опишіть її у SKILL.md. Навіть якщо ви не користуєтеся агентами щодня, сама спроба показує, наскільки добре ви розумієте власний процес.

Де навчитися працювати з AI-агентами

Якщо хочеться не лише прочитати, а й попрактикуватися:

• Claude Code: практичний курс для початківців — саме той інструмент, для якого формат скілів і створювався.
• Claude Chat для початківців — якщо ви ще не писали складних запитів до моделі.
• AI Automation — коли цікавить автоматизація процесів, а не лише код.

Корисні сусідні матеріали: повне керівництво по Claude Code і перший проєкт у вайб-кодингу.

Часті запитання

Що таке Agent Skills простими словами?

Це спосіб передати AI-агенту робочу процедуру. Скіл — це звичайна папка з файлом SKILL.md, у якому описано, як виконувати конкретну задачу, плюс будь-які скрипти чи довідкові матеріали, потрібні для неї. Агент читає цей файл і діє за описаним порядком, замість того щоб вигадувати підхід щоразу заново.

Чим Agent Skills відрізняються від MCP?

MCP відповідає на питання «до чого агент має доступ» — він підключає інструменти, дані й зовнішні системи. Agent Skills відповідають на питання «як саме виконувати роботу» — це процедурні знання: порядок кроків, критерії якості, типові помилки. MCP дає агенту руки, скіли дають йому інструкцію.

Де лежить файл SKILL.md і як агент його знаходить?

Скіл — це папка з файлом SKILL.md усередині; розташування папки залежить від конкретного інструмента, тому точні шляхи варто дивитися в документації свого агента. Специфікація самого формату опублікована на agentskills.io.

Чи безпечно встановлювати чужі скіли?

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

Чи потрібно вступати в Agentic AI Foundation, щоб користуватися стандартом?

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

Навіщо це людині, яка тільки вчиться програмувати?

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

Джерела

• Anthropic — Donating Agent Skills to the Agentic AI Foundation (22 жовтня 2026)
• agentskills.io — специфікація Agent Skills