Посібник із Claude Skills: створіть свій перший SKILL.md за 10 хвилин (2026)

Посібник із Claude Skills: створіть свій перший SKILL.md за 10 хвилин (2026)

Skills — це, мабуть, найважливіша функція Claude Code, яку ви ще не використовуєте. Claude skill — це папка з файлом SKILL.md, яку Claude автоматично завантажує щойно ваш промпт збігається з її описом: жодного копіювання промптів, жодного роздутого CLAUDE.md, жодного запам'ятовування, який шаблон узяти. Ми додали 4 skills у папку .claude/skills/agent/ цього репозиторію, і з виходом Skills 2.0 та Anthropic Marketplace на початку 2026 року цей формат нарешті виходить на повну потужність. Ось шаблон, який працює, коли минеш усі підводні камені.

Ключові висновки

• Claude skill — це папка, що містить файл SKILL.md із YAML-фронтматером, який Claude автоматично завантажує, коли це доречно.
• Skills зберігаються в ~/.claude/skills/ (особисті) або .claude/skills/ (проєктні); Claude сканує обидва під час запуску.
• Використовуйте Skills для повторюваних робочих процесів; MCP — для актуальних зовнішніх даних; субагентів — для багатокрокового планування; хуки — для детермінованих подій.
• Найшвидший шлях до вашого першого skill — попросити Claude викликати свій власний skill-creator skill; він сам напише SKILL.md за вас.

Що таке Claude Skills?

Claude skill — це папка, що містить файл SKILL.md із YAML-фронтматером (name, description, необов’язковий allowed-tools), який Claude Code автоматично завантажує в контекст, коли ваш запит відповідає опису. Skills пакують багаторазові робочі процеси, як-от /commit чи /explain-code, не роздуваючи ваш системний промпт.

Згідно з офіційною документацією Anthropic, кожна папка skill містить три речі: обов’язковий SKILL.md, необов’язкові вбудовані скрипти (від Python-хелпера до JSON-конфігу) та необов’язкові довідкові документи, що завантажуються разом із тілом. Ось і все. Жодного кроку збірки, жодного встановлення, жодного маніфесту.

Розумна частина — це прогресивне розкриття. Під час запуску Claude сканує лише поле description кожного skill. Тіло, інструкції, приклади, патерни викликів інструментів залишаються на диску, доки ваш запит фактично не збіжиться. Тож ви можете мати 50 встановлених skills і не платити жодного токена, доки один із них не спрацює.

Уявіть skills як рецепти з кулінарної книги, до яких Claude гортає, коли бачить інгредієнти у вашому запиті. Skill — це папка, яку Claude читає на вимогу, а не промпт, який ви пам’ятаєте вставляти. У цьому вся ідея.

Мінімальний SKILL.md виглядає так:

---
name: Summarize file
description: Use when the user asks for a 3-sentence summary of a file or function.
---

Read the file at $ARGUMENTS. Summarize purpose, key dependencies, and the
single most surprising thing about it. Three sentences max.

Десять рядків. Справжній skill. Готовий до запуску.

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

Щоб створити свій перший скіл Claude за 10 хвилин: (1) створіть ~/.claude/skills/explain-code/, (2) додайте файл SKILL.md із полями name, description і тілом робочого процесу, (3) перезапустіть Claude Code, щоб він просканував новий каталог, (4) активуйте його промптом, який відповідає опису.

Ось повний процес.

Крок 1: Створіть каталог

mkdir -p ~/.claude/skills/explain-code

Особисті навички (лише для вас) розміщуються в ~/.claude/skills/. Проєктні навички (спільні з командою через git) розміщуються в .claude/skills/ у корені вашого репозиторію. Обирайте особисті для щоденних робочих процесів; обирайте проєктні, коли хочете, щоб кожен учасник репозиторію успадкував їх.

Крок 2: Напишіть SKILL.md

Помістіть цей файл за шляхом ~/.claude/skills/explain-code/SKILL.md:

---
name: Explain code
description: Use when the user asks for a plain-English walkthrough of a code snippet, function, or file. Use $ARGUMENTS for the path or snippet.
---

You are explaining code to a developer who is new to this codebase.

1. Read the file or snippet at $ARGUMENTS.
2. State the file's purpose in one sentence.
3. Walk through the control flow line by line in plain English.
4. Flag any non-obvious dependencies or side effects.
5. End with one question the reader should ask before changing this code.

Це і є весь скіл. Frontmatter — це контракт; тіло — це інструкція.

Крок 3: Перезапустіть Claude Code

Live discovery — це функція Skills 2.0, тож старішим версіям Claude Code потрібен свіжий запуск, щоб підхопити новий каталог. Якщо ви не впевнені, якою версією користуєтесь, одноразовий перезапуск нічого не коштує.

Крок 4: Запустіть її

Відкрийте проєкт і введіть запит:

walk me through what auth/middleware.ts does

Claude зіставляє ваш запит із полем description, знаходить explain-code і непомітно завантажує вміст SKILL.md у контекст. У журналі інструментів ви побачите «Using skill: explain-code». Готово.

Порада: Не хочете писати файл самотужки? Відкрийте Claude Code і скажіть Use the skill-creator skill to scaffold an explain-code skill for me. Вбудований skill-creator від Anthropic — це метанавичка, яка ставить вам запитання, підбирає розумні allowed-tools і записує SKILL.md у потрібну папку. Найшвидший шлях до вашої першої навички, і крапка.

Ось і вся 10-хвилинна обіцянка: п'ять хвилин друку, одне перезавантаження, один тестовий запит.

Усередині SKILL.md: довідка з фронтматеру

Фронтматер SKILL.md — це YAML, обгорнутий у роздільники ---. Обов'язковими є два поля: name (≤64 символи, використовується як назва слеш-команди) та description (тригерний текст, за яким Claude зіставляє ваш запит). Необов'язкові поля керують доступом до інструментів, викликом моделі, файловими глобами та контекстом виконання.

Ось повна довідка, отримана з документації Anthropic щодо навичок:

Рядок context: fork заслуговує на окрему увагу. Це примітив Skills 2.0, який запускає навичку всередині ізольованого контекстного вікна — корисно для тривалих дослідницьких навичок або будь-чого, що генерує багато проміжних токенів, якими ви не хочете забруднювати основний потік. Якщо ця ідея для вас нова, наш посібник з інженерії контексту розглядає компроміси. Максималістичний frontmatter SKILL.md, заповнені всі поля:

---
name: Deploy preview
description: Use when the user wants to deploy a preview build of the current branch to staging.
allowed-tools: ["Bash(git status:*)", "Bash(npm run build:*)", "Bash(vercel:*)"]
disable-model-invocation: true
user-invocable: true
argument-hint: <branch-name or 'current'>
model: claude-opus-4-7
context: fork
globs: ["package.json", "vercel.json"]
references: ["./deploy-runbook.md"]
bundled-files: ["./scripts/preflight.sh"]
tags: ["deploy", "vercel", "preview"]
---

Порада професіонала: Найбільша помилка в description: писати його для людей. Пишіть його для Claude — конкретні тригерні фрази, а не маркетинговий текст. Погано: «Потужна навичка автоматизації Git.» Добре: «Використовуйте, коли користувач хоче закомітити зміни, написати повідомлення коміту або відкрити PR.»

Дві реальні навички, від початку до кінця

Два патерни навичок покривають 80% реального використання: (1) навичка /commit, яку викликає користувач, з disable-model-invocation: true та allowed-tools: Bash(git *) для детермінованих дій; (2) навичка /explain-code, яка викликається автоматично, зі стандартним фронтматером — Claude запускає її, коли запити відповідають її опису.

Більшість туторіалів показують лише фрагменти. Ось два повні файли, які ви можете скопіювати в ~/.claude/skills/ просто зараз.

Навичка /commit (викликається користувачем)

---
name: Commit
description: Use when the user wants to stage and commit code changes with an AI-written conventional-commit message.
disable-model-invocation: true
user-invocable: true
allowed-tools:
  - "Bash(git status:*)"
  - "Bash(git diff:*)"
  - "Bash(git add:*)"
  - "Bash(git commit:*)"
---

1. Run `git status` and `git diff` to see what's staged and unstaged.
2. Group changes into one logical commit. If there are multiple unrelated
   changes, ask the user which to include.
3. Draft a Conventional Commits message: `type(scope): subject` (≤72 chars),
   blank line, body explaining *why*, not *what*.
4. Show the message to the user. Ask "Commit this?" Wait for explicit yes.
5. On confirmation, run `git add` for the included files and `git commit -m`.
6. Print the resulting commit hash.

Тестовий запит: /commit

Що відбувається: Claude перевіряє стан git, складає повідомлення, просить вас підтвердити — і лише потім виконує git commit. Параметр disable-model-invocation: true означає, що навижка ніколи не запускається автоматично у відповідь на розмитий запит на кшталт «збережи мої зміни»; вона спрацьовує лише тоді, коли ви вводите /commit. Білий список allowed-tools обмежує її підкомандами git — вона фізично не здатна виконати rm -rf чи надіслати зміни у віддалений репозиторій. Саме цю навижку ми використовуємо у власному пайплайні.

Для детермінованих дій після коміту (запуск lint, повторна генерація типів, надсилання запиту до вебхука Slack) краще скористайтеся хуками Claude Code: навижки мають імовірнісну природу, а хуки спрацьовують щоразу без винятку.

Навичка /explain-code (викликається моделлю)

---
name: Explain code
description: Use when the user asks for a plain-English walkthrough of a code snippet, function, or file. Use $ARGUMENTS for the path or snippet.
argument-hint: <file path or pasted snippet>
model: claude-opus-4-7
---

1. Read the file or snippet at $ARGUMENTS. If $ARGUMENTS is empty, ask
   the user which file to explain.
2. State the file's purpose in one sentence.
3. Walk through the control flow line by line in plain English.
4. Flag any non-obvious dependencies, side effects, or hidden assumptions.
5. End with one question the reader should ask before modifying this code.

Тестовий запит: walk me through what auth/middleware.ts does

Що відбувається: зверніть увагу, що користувач не вводив /explain-code. Claude зіставляє "walk me through" із полем description, знаходить навичку й автоматично її викликає. У цьому й полягає магія — маршрутизацію виконує поле description. Поле model: claude-opus-4-7 закріплює цю навичку за Opus незалежно від того, яку модель ви встановили як типову, тож детальні розбори коду завжди отримують розумнішу модель. (Докладніше про запуск Claude Code з різними моделями.)

Навіщо два підходи? Навичка №1 викликається користувачем + прив'язана до конкретних інструментів, передбачувана, безпечна, ідеальна для git чи деплоїв. Навичка №2 викликається автоматично + має відкритий характер — це магія навичок, але покладайтеся на своє поле description. Навички, що викликаються користувачем, дають передбачуваність; навички, що викликаються моделлю, дають магію. Обирайте для кожної навички окремо, а не для всього репозиторію.

Щоб побачити більше реальних прикладів навичок, перегляньте офіційний репозиторій anthropics/skills та підтримуваний спільнотою список awesome-claude-skills.

Навички проти MCP проти субагентів проти хуків: коли що використовувати

Використовуйте навички для повторно використовуваних робочих процесів, які Claude має запускати автоматично або які ви викликаєте як слеш-команди. Використовуйте MCP-сервери, коли вам потрібні живі зовнішні дані (бази даних, API, файлові системи за межами робочого каталогу). Використовуйте субагентів для багатокрокових планів, які Claude має делегувати в новий контекст. Використовуйте хуки для детермінованих подій (pre-commit, post-tool-use), які мають спрацьовувати завжди, а не ймовірнісно.

Швидке розмежування: навички — це робочі процеси, Model Context Protocol — це дані, субагенти — це плани, хуки — це події. Кожен із них перебуває на окремому шарі Claude Code, і неправильний шар означає неправильний інструмент. Згідно з власною публікацією Anthropic Skills explained, саме таке розмежування вони хочуть, щоб ви засвоїли.

Вони поєднуються. Навичка може викликати інструмент MCP через allowed-tools. Хук може спрацювати після завершення навички. Субагент може використовувати навички, до яких йому надали доступ. Найчистіша ментальна модель: спершу оберіть правильний шар, а потім дозвольте їм накладатися. Навички — це примітив контекстної інженерії, до якого ви звертаєтеся, коли хочете робочий процес, який Claude може обирати; ви автоматизуєте за допомогою хуків, коли хочете щось, що Claude не може пропустити. Найгірші способи неправильного використання кожного з них: Skills для даних у реальному часі (використовуйте MCP); MCP для одноразових шаблонів промптів (використовуйте Skills); субагенти для детермінованого редагування файлів (використовуйте хуки); хуки для розгалуженої логіки (використовуйте Skills). Skills — це робочі процеси, MCP — це дані, субагенти — це плани, хуки — це події. Обирайте за шаром, а не за модним словом.

Де зберігаються скіли: особисті, проєктні, плагінні, корпоративні

Скіли Claude встановлюються в чотирьох областях: особисті (~/.claude/skills/, лише для вас), проєктні (.claude/skills/ у корені репозиторію, ваша команда через git), плагінні (поширюються через Anthropic Marketplace або будь-який URL плагіна) та корпоративні (розгортаються IT-відділом через MDM/адміністративні політики). Claude сканує всі чотири під час запуску.

Пакетні скіли документів легко забути, Claude Code уже постачає скіли pdf, docx, pptx та xlsx з коробки, а також невелику бібліотеку /debug, /simplify та подібних вбудованих команд. (Споріднений інструмент Claude Design постачає власні пакетні скіли робочих процесів для генерації дизайну; та сама модель, інша сфера.)

Коли варто поширювати через плагін, а не через проєкт? Плагіни виграють, коли той самий робочий процес корисний для кількох репозиторіїв: скіл /release, який ви використовуєте у п'яти клієнтських кодових базах, має бути в плагіні, а не скопійований у .claude/skills/ кожного репозиторію. Проєктні скіли виграють для конвенцій, специфічних для кодової бази (PR-шаблон вашої команди, ваш власний ранер тестів). Anthropic Marketplace, а також /plugin install з будь-якого URL, роблять плагіни правильним рішенням для повторного використання між репозиторіями. Згідно з документацією по плагінах, виявлення та оновлення обробляються автоматично.

Розширені патерни: $ARGUMENTS, динамічне впровадження в оболонку, context: fork

Найважливішими є три розширені патерни скілів: $ARGUMENTS дозволяє користувачам передавати параметри скілам, які викликає користувач (/translate $ARGUMENTS); динамічне впровадження в оболонку (з allowed-tools: Bash(...)) дозволяє скілу виконувати скрипти та передавати їхній вивід у контекст; а context: fork (Skills 2.0) запускає скіл в ізольованому контекстному вікні. Whitepaper «Complete Guide» від Anthropic є канонічним джерелом щодо context: fork станом на травень 2026 року.

$ARGUMENTS для параметризованих навичок

---
name: Translate
description: Translate the most recent message into the target language.
user-invocable: true
argument-hint: <target-language, e.g. spanish, japanese, brazilian portuguese>
---

Translate the user's previous message into $ARGUMENTS. Preserve tone,
preserve markdown formatting, return only the translation.

Тестовий запит: /translate spanish. Claude підставляє spanish замість $ARGUMENTS під час виконання. Найпростіший спосіб зробити навичку універсальною без написання варіантів.

Динамічне впровадження команд оболонки через allowed-tools

---
name: Review last commit
description: Use when the user wants a code review of the last git commit.
allowed-tools: ["Bash(git diff HEAD~1:*)", "Bash(git log -1:*)"]
---

Run `git diff HEAD~1` and `git log -1`. Review the diff for bugs, security
issues, and style violations. Output a 5-bullet review.

Скіл виконує команди в оболонці, передає diff у контекст і перевіряє його. Обмежуйте allowed-tools конкретними командами (Bash(git diff HEAD~1:*)), і ніколи — голим Bash: дозвіл на голий Bash є тим варіантом цього патерну, що вистрілює вам у ногу з погляду безпеки.

context: fork (Skills 2.0)

---
name: Deep research
description: Use when the user wants a multi-source research summary on a topic.
context: fork
---

Research the topic in $ARGUMENTS using available web tools. Produce a
2-page summary with citations. Do not pollute the main thread.

Форкінг надає навичці власне контекстне вікно, тож 50 тисяч токенів проміжних дослідницьких нотаток не перетікатимуть у вашу основну сесію. Корисно для тривалих досліджень, планування великих рефакторингів або будь-якої роботи, що породжує багато одноразових токенів. Лише для Skills 2.0 — старіші версії Claude Code ігнорують це поле.

Усунення несправностей: чому ваш навик не спрацьовує

Навики зазвичай не спрацьовують з однієї з чотирьох причин: (1) description занадто загальний, щоб Claude міг зіставити його з вашим запитом, (2) каталог розташований за неправильним шляхом (.claude/skills/, а не claude/skills/), (3) Claude Code не було перезапущено після додавання навика (лише для версій до Skills 2.0), або (4) назва навика конфліктує з вбудованим або вищим за пріоритетом навиком. Згідно з найпопулярнішими запитами в Google щодо типових збоїв у трекері проблем Claude Code на GitHub, ці чотири причини охоплюють приблизно 95% звітів у стилі «чому це не працює».

Режим збою 1: «Мій навик взагалі не відображається»

Найпоширеніша причина — неправильний шлях: .claude/skills/ (з крапкою) проти claude/skills/ (без крапки) — це одруківка, яку ми всі робили о першій ночі. Виконайте ls -la ~/.claude/skills/, щоб переконатися, що каталог існує саме з крапкою. Якщо він там є, а Claude досі його не бачить, перезапустіть Claude Code один раз. Версії до Skills 2.0 сканують лише під час запуску.

Режим збою 2: «Claude не викликає мій скіл автоматично»

Поле description надто розмите або написане для людей, а не для Claude. Перепишіть його, використавши конкретні тригерні фрази, які віддзеркалюють те, як користувачі насправді формулюють запити. Створивши 4 скіли для цього репозиторію, я натрапив на пастку, залишивши описи на кшталт «Корисний скіл для SEO.» Марно. Перепишіть так: «Використовуйте, коли користувач хоче додати JSON-LD схему, мета-теги або SEO frontmatter до допису в Markdown.» Точність спрацьовування зросла з ~30% до ~95%. Точність спрацьовування цілком залежить від поля description. Пишіть його для Claude, а не для свого резюме.

Режим збою 3: «Опис обрізається в палітрі слеш-команд»

Або ваш description перевищує 1024 символи, або ваш name — 64 символи. Обидва мають жорсткі обмеження. Виправлення: розділіть навичку на дві вужчі або перенесіть довгі деталі в тіло SKILL.md. Frontmatter призначений для маршрутизації, а не для документації.

Режим збою 4: «Автоматичне виявлення змін не працює»

Claude Code версії до Skills 2.0 потребує повного перезапуску після будь-якого редагування SKILL.md. Якщо ви ітеративно доопрацьовуєте навичку, а зміни не застосовуються, ймовірно, ви користуєтеся застарілою збіркою. Або оновіть Claude Code до версії, що включає Skills 2.0 (автоматичне виявлення), або візьміть за звичку перезапускати після кожного збереження. Дратує, але обходиться дешево.

Навички за межами Claude: відкритий стандарт Agent Skills

Так, навички — це відкритий стандарт. Стандарт Agent Skills на agentskills.io визначає формат SKILL.md незалежно від будь-якого постачальника. Codex CLI та ChatGPT Desktop від OpenAI ухвалили цей стандарт у грудні 2025 року; той самий SKILL.md, який ви пишете для Claude Code, працює в Codex із незначними змінами у фронтматері.

Ось матриця підтримки між інструментами станом на травень 2026 року: Claude Code має повну підтримку Agent Skills (еталонна реалізація). Codex CLI від OpenAI має повну підтримку. ChatGPT Desktop має часткову підтримку: name, description та тіло працюють, але паритету щодо allowed-tools ще немає. Gemini CLI оголосив про підтримку на початку 2026 року, але на момент написання цієї статті ще не випустив її. Cursor — виняток: він використовує власний формат правил Cursor і нативно не читає SKILL.md, хоча існують шими від спільноти.

Що писати сьогодні, щоб ваші навички пережили цей рік: тримайте name та description чистими й незалежними від інструменту. Якщо ви орієнтуєтеся на кілька інструментів, ізолюйте будь-який специфічний для постачальника фронтматер за неймспейсом (claude: або codex:). Портативна поверхня — name, description, тіло, $ARGUMENTS — працює всюди; розширені поля, як-от context: fork, є специфічними для Claude, доки інші постачальники не випустять аналоги. Anthropic також просуває глибшу інтеграцію з маркетплейсом згідно зі злитою дорожньою картою Claude Code, тож портативність ставатиме лише простішою.

Три місця, де можна шукати приклади навичок: anthropics/skills (офіційний), awesome-claude-skills (від спільноти) та agentskills.io (сторінка специфікації стандарту). Навички більше не є функцією Claude. Це відкритий стандарт, який Claude випустив першим.

Поширені запитання

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

Навичка Claude — це файл SKILL.md з інструкціями щодо робочого процесу, який Claude завантажує, коли ваш запит відповідає його опису. Сервер MCP — це окремий процес, який Claude викликає для отримання актуальних даних (баз даних, API, файлових систем за межами робочого каталогу). Використовуйте навички для робочих процесів; використовуйте MCP для даних. Вони поєднуються: навички можуть викликати інструменти MCP.

Чи безкоштовні Claude skills?

Так, Skills — це вбудована функція Claude Code, без додаткової плати. Ви платите лише за токени моделі, використані під час запуску skill. Skills, встановлені з Anthropic Marketplace, можуть бути платними (наразі це рідкість), але офіційний репозиторій anthropics/skills та спільнотні awesome-списки повністю безкоштовні для копіювання та використання.

Де встановлюються навички Claude?

Особисті навички зберігаються в ~/.claude/skills/{skill-name}/, навички проєкту — у .claude/skills/{skill-name}/ у корені репозиторію. Навички плагінів встановлюються через /plugin install <url> і розташовуються у каталозі плагінів. Корпоративні навички розгортаються ІТ-відділом вашої організації через керовані налаштування. Claude Code сканує всі чотири області під час запуску.

Як створити скіл Claude з нуля?

Створіть папку в ~/.claude/skills/, додайте файл SKILL.md із YAML-фронтматером (name, description), після якого йдуть інструкції робочого процесу, і перезапустіть Claude Code. Найшвидший шлях: відкрийте Claude Code і попросіть його викликати вбудований скіл skill-creator — він згенерує структуру SKILL.md для вас менш ніж за хвилину.

Чому не спрацьовує мій скіл Claude?

Чотири найпоширеніші причини: (1) description занадто розмитий, щоб Claude міг зіставити його з вашим запитом, — перепишіть його з конкретними тригерними фразами; (2) скіл розташовано за неправильним шляхом (.claude/skills/, а не claude/skills/); (3) Claude Code потребує перезапуску у версіях до Skills 2.0; (4) назва скілу конфліктує з вбудованим скілом. Перевірте командою ls -la ~/.claude/skills/.

Чи можуть ChatGPT або Cursor використовувати навички Claude?

ChatGPT Desktop і Codex CLI підтримують той самий стандарт Agent Skills, що й Claude — той самий SKILL.md працює в обох із незначними змінами у фронтматері. Cursor використовує власний формат правил Cursor і не читає SKILL.md нативно. Gemini CLI оголосив про підтримку на початку 2026 року, але станом на травень 2026 року ще не випустив її.

Що таке навичка skill-creator?

skill-creator — це метанавичка, що входить до репозиторію anthropics/skills і допомагає Claude створювати для вас нові файли SKILL.md. Просто розкажіть Claude, що має робити навичка; skill-creator розпитає вас, щоб скласти опис, підбере доречні allowed-tools і запише SKILL.md у потрібну папку. Найшвидша можлива заготовка.

Що робить disable-model-invocation?

Якщо встановити disable-model-invocation: true у фронтматері вашого скілу, Claude не зможе автоматично запускати скіл на основі збігів із запитом. Скіл стає доступним лише для виклику користувачем: він з’являється в палітрі слеш-команд як /skill-name і запускається тільки тоді, коли його викликають явно. Використовуйте це для деструктивних або детермінованих дій, як-от /commit чи /deploy.

Створіть кілька скілів, випустіть їх у проєкті й подивіться, що приживеться. Якщо ваша команда стикається з цілим набором типових проблем «скіл не запускається» у кількох репозиторіях і вам потрібен свіжий погляд на налаштування .claude/skills/, звертайтеся — залюбки все розберемо.