SSD Nodes Learn Hosting plans →
Посібники Matt ConnorВід Matt Connor · Оновлено 2026-11-14

Що таке навички агентів і як вони працюють

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

Що насправді таке навичка агента

Навичка агента — це папка на диску з файлом SKILL.md усередині. Цей файл містить назву, короткий опис та інструкції у форматі звичайного Markdown. Агент завантажує опис під час запуску, а інструкції читає лише тоді, коли ваш запит відповідає цьому опису або ви викликаєте навичку за назвою. Майже все інше у навичках випливає з цих двох речень.

Папка може містити не лише один файл. Специфікація Agent Skills визначає три необов’язкові каталоги: scripts/ для коду, який запускає агент, references/ для документів, які він читає за потреби, і assets/ для шаблонів та даних. Жоден із них не є обов’язковим. Папка, у якій є лише SKILL.md, уже є повноцінною навичкою.

restore-drill/
  SKILL.md
  references/retention-policy.md
  scripts/verify_snapshot.sh

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

Чому skill майже нічого не коштує, доки його не використовують

Саме цей аргумент робить формат вартим розуміння. Він стосується контексту, а не функцій. Завантаження відбувається поетапно. У специфікації це називається progressive disclosure.

Під час запуску агент завантажує лише name і description кожного встановленого skill. Більше нічого він не завантажує. У специфікації Agent Skills зазначено, що це становить приблизно 100 токенів на один skill (опубліковані рекомендації станом на October 2026). Якщо встановити десяток skills, це займе приблизно стільки контексту, скільки один довгий абзац.

Коли запит відповідає опису, агент читає вміст лише цього SKILL.md. Специфікація рекомендує обмежувати вміст 5,000 токенами, а файл — 500 рядками. Файли в references/ і scripts/ на цьому етапі не споживають контекст. Reference file завантажується лише тоді, коли інструкції спрямовують до нього агента. Bundled script працює інакше: агент запускає його через shell, тому вихідний код script не потрапляє у вікно контексту, а потрапляє туди лише його вивід.

Тепер порівняймо це з тим, до чого люди звертаються насамперед, — з одним величезним prompt. За кожен рядок у system prompt або файлі інструкцій, який завжди активний, потрібно платити під час кожного запиту й у кожній сесії, незалежно від того, чи потрібен він для завдання. Крім того, він конкурує за увагу з фактичним запитанням. Десять тисяч токенів постійних інструкцій — це рахунок, який потрібно сплачувати навіть за запитання про поточний час. Дюжина skills до активації коштує приблизно 1,200 токенів, але завантажені інструкції можуть залишатися в контексті для наступних завдань у тій самій розмові. У цьому полягає весь аргумент на користь skills. Саме тому невелика бібліотека краща за довший prompt.

Є один нюанс, який часто стає несподіванкою. У Claude Code після завантаження skill його вміст залишається в розмові під час наступних ходів. Тому великий SKILL.md створює повторювані витрати, а не одноразові. Compaction може скоротити або видалити завантажений вміст skill. Перенесення деталей у references/ — це не питання охайності. Це передбачений механізм роботи формату.

Навичка агента — це не виклик інструмента

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

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

Коротко: інструмент надає агенту нову можливість, а навичка переважно допомагає йому приймати рішення щодо можливостей, які він уже має. Якщо навичка додає можливість, вона робить це через вбудований скрипт, який агент запускає за допомогою наявної shell. Якщо крок щоразу має створювати точний перевірений результат, потрібні інструмент або скрипт. Якщо крок вимагає стабільно застосовувати однаковий підхід, потрібна навичка. Навичка може складатися лише з правил прийняття рішень і водночас бути тією, до якої ви звертаєтеся найчастіше, як показує Ponytail, яка спонукає coding agent вносити найменшу працездатну зміну: вона не додає нових можливостей, а лише змінює спосіб використання агентом уже наявних. Це рішення може бути й протилежним: unlazy skill, яка проходить Depth Tree, щоб агент не оголошував завдання виконаним передчасно, застосовує той самий підхід для забезпечення ретельності, а не стриманості.

Навичка агента — це не MCP server

MCP (model context protocol) — це протокол для підключення агента до зовнішньої системи. MCP server — це процес, який працює, підтримує цей протокол і надає агенту інструменти. Зазвичай йому потрібні конфігурація, облікові дані та локальна команда або мережевий endpoint. Навичка — це каталог із markdown-файлом. У ній немає процесу, порту чи протоколу.

Витрати контексту відрізняються так само. Кожен інструмент, який надає MCP server, має назву, опис і схему аргументів. У клієнті, який завантажує їх заздалегідь, ці дані передаються в запиті протягом усієї сесії незалежно від того, використовуються вони чи ні. Claude Code більше не працює так за замовчуванням: станом на October 2026 його tool search увімкнено з коробки, тому на початку сесії завантажуються лише назви інструментів та інструкції server, а повні визначення надходять, коли Claude шукає їх. Навичка у стані спокою — це один рядок тексту.

Ці компоненти доповнюють один одного, і найкращі конфігурації використовують їх разом. MCP server надає доступ. Навичка описує процедуру: які з цих інструментів викликати для реального робочого процесу вашої команди, у якому порядку та яким має бути належний результат. Якщо ви розміщуєте власний server, матеріал про запуск MCP servers на VPS описує цю частину.

Навичка агента — це не системний промпт і не AGENTS.md

Обидва є інструкціями у форматі markdown, тому така плутанина зрозуміла. Відмінність полягає в моменті завантаження. Системний промпт і проектні інструкції, завантажені під час запуску, діють завжди; вкладені файли AGENTS.md і CLAUDE.md завантажуються, коли агент працює у відповідних каталогах. Навичка вмикається за потреби. Стилі виведення Claude Code належать до крайнього випадку постійно активних інструкцій, оскільки вибір стилю безпосередньо змінює системний промпт. Тому стиль впливає на кожну відповідь у сеансі, зокрема на ті, для яких жодна навичка не використовується.

Перевірка складається з одного запитання: чи буде помилкою проігнорувати цей абзац під час виконання завдання, яке з ним не пов’язане? Стиль оформлення, команда складання та правило іменування гілок застосовуються до кожного завдання, тому вони мають міститися у файлі, який завжди завантажується. Саме постійне завантаження в цьому випадку є метою. Контрольний список випуску, який ви запускаєте двічі на місяць, не застосовується до кожного завдання, тому його слід зберігати в навичці. Якщо розділ файлу, який завжди завантажується, перетворився на нумеровану процедуру, це сигнал перенести його.

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

Як виглядає мінімальний skill

У Claude Code персональні skills зберігаються в ~/.claude/skills/<name>/SKILL.md і застосовуються до всіх ваших проєктів на цій машині, але не в Cowork або хмарних сесіях. Skills проєкту зберігаються в .claude/skills/<name>/SKILL.md і додаються до git, тому їх також отримує команда; хмарні потоки в проєкті Claude їх не завантажують. GitHub Copilot і VS Code також читають skills проєкту з .github/skills/ і .agents/skills/, а також із .claude/skills/. Файл усередині — той самий файл.

mkdir -p ~/.claude/skills/restore-drill
---
name: restore-drill
description: Run a restic restore drill and report what was recovered. Use when the user asks to test backups, verify a restore, or check that a snapshot is readable.
---

# Restore drill

1. Run `restic snapshots` and pick the newest snapshot for the host in question.
2. Restore it into a scratch directory under `/tmp`, never over live data.
3. Compare the restored file count and total size against the snapshot summary.
4. Report the snapshot ID and anything that failed to restore.

If `restic snapshots` reports that it cannot open the config file, stop and report the full error instead of guessing the cause.

Це повний skill. Назва каталогу стає командою, яку ви вводите, тому в цьому випадку це /restore-drill. У Claude Code меню /skills містить список установлених skills. Це найшвидший спосіб перевірити, чи було файл завантажено. Якщо його немає в цьому меню, спочатку перевірте назви: файл має називатися SKILL.md, а специфікація Agent Skills вимагає, щоб назва складалася з малих літер, цифр і одиничних дефісів та збігалася з назвою каталогу. Ту саму процедуру, записану як інструкцію, яку агент може повторно виконати, зручно доповнює планове резервне копіювання за допомогою restic на VPS, оскільки виконання резервного копіювання не означає, що резервну копію можна відновити.

Коли навичку слід реалізувати як скрипт

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

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

По-друге, скрипт двічі дає однакову відповідь. Якщо під час кожного запуску просити модель заново виводити те саме правило аналізу журналу, у невдалому випадку результат трохи відрізнятиметься. Це можна помітити лише тоді, коли два числа вже не збігаються.

Тому розділяйте роботу за типом. «Розібрати CSV і вивести кожен рядок, у якому підсумок не відповідає окремим позиціям» — це завдання для скрипту. «Переглянути рядки, виведені скриптом, і пояснити, які з них схожі на помилку під час введення даних» — це інструкція для навички. Зберігати оцінювання в Markdown, а детерміновану логіку — у коді означає дотримуватися того самого принципу, що й створення циклу, який агент може виконувати без вашого нагляду.

Чому мій skill ніколи не активується?

Тому що його description описує, що робить skill, але не вказує, коли його потрібно використовувати. Саме цей рядок агент зіставляє з вашим запитом. «Допомагає працювати з базами даних» не відповідає жодному конкретному запиту. «Виконує міграцію схеми для staging-бази даних. Використовуйте, коли користувач просить перенести таблицю, додати стовпець або змінити схему» містить слова, які користувач фактично вводить, тому skill активується.

Протилежна проблема виникає зі skill, який активується постійно. Опис на кшталт «Використовуйте для будь-яких змін коду в цьому репозиторії» відповідає всім запитам. Тому вміст завантажується для кожного завдання й залишається в контексті під час наступних ходів. Звузьте опис до потрібного сценарію. У Claude Code також можна вказати disable-model-invocation: true у frontmatter. Це вимикає автоматичне завантаження, але залишає skill доступним, коли ви вводите його назву.

Третя проблема — skill дублює інструмент. Інструкції, які вказують агенту curl API, уже доступний через його MCP server, або виконувати пошук у файлах, коли harness має власний інструмент пошуку, створюють повільніший шлях і два набори інструкцій, які можуть суперечити один одному. Видаліть дубль і опишіть потрібний результат.

Не вгадуйте, яка з трьох проблем у вас виникла. Запустіть той самий prompt двічі в новій сесії: один раз із доступним skill і один раз із вимкненим. Потім порівняйте відповіді. Нова сесія важлива, оскільки сесія, у якій ви створювали skill, уже містить усе, що він описує. Це приховує прогалини в його тексті. Плагін Anthropic skill-creator автоматизує таке порівняння в Claude Code. Він також генерує prompts, які повинні або не повинні активувати skill, і вимірює частоту кожного результату. Якщо skill завантажується, але агент усе одно не виконує його вказівки, проблема не в описі. Тоді зверніться до причин, через які агент ігнорує інструкції, які вже прочитав.

Це формат одного постачальника чи стандарт?

Anthropic опублікувала цей формат наприкінці 2025 року, а потім випустила його як відкритий стандарт на agentskills.io. 22 жовтня 2026 року Anthropic оголосила про передачу Agent Skills до Agentic AI Foundation при Linux Foundation. Станом на жовтень 2026 року ця специфікація визначає обов’язкові поля name і description, необов’язкові поля license, compatibility, metadata і allowed-tools, три необов’язкові каталоги та поетапну поведінку завантаження. Також доступний еталонний валідатор, тому skills-ref validate ./my-skill перевіряє папку на відповідність специфікації перед тим, як надати до неї доступ.

Справжнім показником є список клієнтів. Ту саму папку читають, зокрема, Claude Code, Cursor, OpenAI Codex, Gemini CLI, GitHub Copilot, VS Code, Goose, OpenHands і opencode. Microsoft публікує власні skills у цьому форматі за адресою github.com/microsoft/skills, а також випускає desktop-інструмент Skill Recorder. Він стежить за виконанням завдання, відтворює його як намір із впорядкованими кроками та записує результат як skill. Якщо постачальник створює recorder, вихідний формат якого належить специфікації іншої компанії, це свідчить, що формат перестав бути функцією лише одного продукту.

Що написати спочатку

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

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

FAQ

У чому різниця між навичкою агента та MCP-сервером?

MCP (model context protocol) сервер — це запущений процес, який надає агенту інструменти через протокол. Тому йому потрібні конфігурація та облікові дані. Повні описи його інструментів займають контекст протягом усього сеансу, якщо клієнт не відкладає їх завантаження, як це тепер типово робить Claude Code. Навичка агента — це папка з файлом SKILL.md. Вона не містить процесу або протоколу та займає приблизно 100 токенів, доки агент не вирішить її прочитати. Використовуйте MCP-сервер, щоб надати агенту доступ до системи. Використовуйте навичку, щоб описати агенту правильний порядок роботи з цим доступом. У багатьох конфігураціях використовуються обидва компоненти.

Чи працюють навички агентів лише з Claude Code?

Ні. Anthropic розробила цей формат, а потім опублікувала його як відкритий стандарт на agentskills.io. Ту саму папку читають Cursor, OpenAI Codex, Gemini CLI, GitHub Copilot, VS Code, Goose, OpenHands та інші клієнти. Відрізняються розташування, у якому кожен клієнт шукає навички, і додаткові поля frontmatter, які він підтримує. Claude Code читає ~/.claude/skills/ і .claude/skills/, а GitHub Copilot та VS Code читають .github/skills/, .claude/skills/ або .agents/skills/ у репозиторії. Сам файл SKILL.md переноситься між ними без змін.

Скільки навичок можна встановити, перш ніж це сповільнить роботу?

Обмеження визначається бюджетом запуску, а не кількістю навичок. Кожна встановлена навичка додає своє ім’я та опис — приблизно 100 токенів відповідно до опублікованих рекомендацій специфікації. Тому 30 навичок займають близько 3,000 токенів ще до використання будь-якої з них. Першою погіршується не швидкість, а зіставлення: коли описи багатьох навичок перетинаються, моделі складніше вибрати потрібну. Пишіть описи без перетинів і видаляйте навички, якими більше не користуєтеся.

Цю інструкцію слід додати до навички чи до AGENTS.md?

Визначте, чи застосовується вона до кожного завдання в репозиторії. Команди складання, внутрішній стиль і правила іменування стосуються всіх завдань, тому їх слід зберігати у файлі, який завжди завантажується. Саме постійне завантаження є його призначенням. Процедура, яку ви виконуєте час від часу, наприклад контрольний список випуску або тренування відновлення, має бути навичкою. До її активації вона коштує лише опис в один рядок. Після завантаження в Claude Code її інструкції залишаються в діалозі під час наступних ходів, зокрема для завдань, не пов’язаних із початковим. Розділ AGENTS.md, який перетворився на нумеровані кроки, зазвичай є навичкою, яку час винести в окремий файл.

Чи була ця стаття корисною?