Що таке навичка агента (SKILL.md) і як її перевірити

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

Ви, напевно, зустрічали це слово в README: "встановіть навичку, потім попросіть агента...". Нічого загадкового тут немає. Далі: що всередині, коли вона потрапляє до контекстного вікна і як оглянути її, перш ніж пустити на свою машину.

Що таке навичка і чим вона відрізняється від промпту#

Документація Anthropic про Agent Skills (перевірено 30 жовтня 2026) описує навичку як багаторазовий ресурс на основі файлової системи: каталог із файлом SKILL.md, а також необов'язкові скрипти, шаблони та довідкові файли. SKILL.md починається з невеликого заголовка YAML (назва й опис) і продовжується звичайними інструкціями.

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

Два поля заголовка є обов'язковими, і формат має правила. У форматі Skills від Claude name має щонайбільше 64 символи: малі літери, цифри й дефіси, і не може містити слів "anthropic" або "claude". description не може бути порожнім, обмежений 1 024 символами і має казати і що робить навичка, і коли її використовувати.

Як навичка потрапляє до контекстного вікна#

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

• Рівень 1, завантажується завжди. Назва й опис кожної встановленої навички, близько 100 токенів на навичку.
• Рівень 2, коли спрацьовує. Тіло SKILL.md, менше ніж 5 000 токенів.
• Рівень 3, лише коли потрібно. Вбудовані файли та скрипти. Коли агент запускає скрипт, код скрипта не потрапляє до контексту, лише його вивід.

Цифри токенів — це приблизні оцінки з документації, а не точні підрахунки.

Ось чому це важливо для вашого рахунку. Скажімо, ви встановили 20 навичок. 20 × 100 = 2 000 токенів їдуть разом із першого повідомлення. Агент пересилає свій контекст на кожному кроці (приклад із 20 кроків показує чому), тож сесія з 50 кроків несе 50 × 2 000 = 100 000 вхідних токенів міток навичок. На DeepSeek-V4-Flash це $0.0015 за поточними цінами.

Тепер навпаки. Якби ті двадцять навичок були вставлені як один великий промпт, кожне тіло сиділо б у кожному запиті: до 20 × 5 000 = 100 000 токенів на запит, а не на сесію. Ця різниця і є суттю завантаження на вимогу. Якщо термін "контекстне вікно" досі нечіткий, це пояснення розповідає, що його заповнює.

Навички живуть у контексті, тож моделі за агентом потрібне місце для них. DeepSeek-V4-Flash на CheapTokens (id deepseek-ai/DeepSeek-V4-Flash-0731) має контекстне вікно 380K і до 32 768 вихідних токенів на відповідь, одну ціну будь-якої пори доби та API, сумісний з OpenAI і Anthropic. Для термінального агента дотримуйтеся як підключити Claude Code до CheapTokens; для будь-якого іншого інструмента почніть з документації. Сторінка самої моделі — тут.

Напишіть мінімальну навичку за дві хвилини#

Читати легше після того, як напишеш одну. Ця навичка змушує агента писати повідомлення комітів у фіксованому форматі. У Claude Code особисті навички живуть у ~/.claude/skills/, а навички проєкту — у .claude/skills/, тож навичка проєкту може подорожувати разом із репозиторієм.

mkdir -p ~/.claude/skills/commit-message-style
nano ~/.claude/skills/commit-message-style/SKILL.md   # or any editor

Вставте це у файл:

---
name: commit-message-style
description: Writes git commit messages in this project's format. Use when the user asks to commit, to write a commit message, or to summarize staged changes.
---

# Commit message style

1. Run `git diff --staged` and read it.
2. First line: `type(scope): summary`, at most 72 characters. Types: feat, fix, docs, refactor, test.
3. Blank line, then up to three bullets that say why the change was made, not what changed.
4. Do not put file names in the first line.

Тепер відкрийте агента в репозиторії з підготовленими змінами й попросіть: "напиши повідомлення коміту для того, що я підготував". Агент бачить опис, вирішує, що він збігається, читає чотири правила й дотримується їх. Якщо він ігнорує навичку, спершу подивіться на description: він має називати ситуацію, тут "commit", тими словами, які ви насправді вживаєте.

Одна зачіпка: навички не синхронізуються між claude.ai, API та Claude Code. Навичку, створену в одному місці, треба додати до інших окремо.

Skill, AGENTS.md, MCP: що є що#

Ці три постійно плутають. Файл правил, як-от AGENTS.md або CLAUDE.md, читається на початку сесії й містить факти про проєкт (як цей файл може зіпсуватися в теці Downloads). Сервер MCP дає агенту нові інструменти й дані, до яких можна дістатися (MCP простою мовою). Навичка — це процедура: як виконати один різновид роботи, завантажується, коли ця робота виникає.

Перевірте сторонню навичку перед встановленням#

Навичка — це текст, якого дотримується агент, а іноді й код, який агент запускає. Документація радить використовувати навички лише з надійних джерел, перевіряти кожен вбудований файл (SKILL.md, скрипти, ресурси) і шукати неочікувані мережеві виклики чи доступ до файлів. Навички, що завантажують зовнішні URL-адреси, ризикованіші. У Claude Code навичка має такий самий мережевий доступ, як будь-яка програма на вашому комп'ютері, тож ставтеся до встановлення як до встановлення програмного забезпечення.

Гарний зразок — universal-modder, набір інструментів для модифікації ігор. Його README (перевірено 30 жовтня 2026) описує набір навичок під ліцензією MIT у форматі Agent Skills, CLI на Python під назвою um, сервер MCP для генерації ресурсів через fal і спільну базу знань із польових нотаток. Головна навичка, mod-any-game, охоплює розвідку, зворотну розробку, генерацію ресурсів, тестування в грі та пакування. README перелічує Claude Code, Codex, Cursor, Gemini CLI, GitHub Copilot і OpenCode як підтримувані інструменти й каже, що набір відмовляється обходити античит або DRM. У Claude Code він встановлюється командою /plugin marketplace add rehan-remade/universal-modder, а генерація ресурсів потребує окремого ключа API fal.

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

Головне правило — у як безпечно зберігати ключ API. Сторінка репозиторію не показує дати останнього коміту, тож перевірте, наскільки недавно оновлювався проєкт, перш ніж покладатися на нього.