Як написати скіл для Claude. Робочий приклад у двох файлах і перший тест

Пишемо з нуля невеликий скіл, який перетворює нотатки із зустрічі на підсумок за шаблоном фірми. Показуємо SKILL.md, допоміжний файл, тест у Claude Code і правила Anthropic, завдяки яким Claude бере скіл саме тоді, коли треба.

Частина посібникаClaude Code, повний посібник. Від встановлення до власних скілів і плагінів

У цьому тексті
  1. Як написати скіл крок за кроком
  2. Як протестувати скіл у Claude Code
  3. Правила Anthropic, які дають найбільшу різницю
  4. Skill-creator, скіл для написання скілів

Коротко

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

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

Спираємося на документацію скілів Claude Code і на поради Anthropic щодо написання скілів, станом на 10 листопада 2026. Якщо ще не знаєте, що таке скіл, почніть зі статті що таке скіл у Claude. Увесь цикл збирає наш посібник з Claude Code.

Як написати скіл крок за кроком

У скіла буде два файли. SKILL.md з інструкцією і shablon.md з шаблоном підсумку. Робимо його в Claude Code як особистий скіл, тобто такий, що працює в усіх ваших проєктах.

  1. Створіть папку скіла командою mkdir -p ~/.claude/skills/pidsumok-zustrichi у терміналі.
  2. Збережіть у ній файл SKILL.md з текстом нижче.
  3. Поруч збережіть файл shablon.md із шаблоном.
  4. Запустіть claude у будь-якій папці і протестуйте скіл так, як описано далі.
SKILL.md
---
name: pidsumok-zustrichi
description: Перетворює сирі нотатки із зустрічі на підсумок за шаблоном фірми. Використовуй, коли вставляють нотатки із зустрічі, просять підсумок розмови з клієнтом або список домовленостей і завдань.
---

Зроби підсумок зустрічі за файлом shablon.md.

Правила
- Пиши лише те, що є в нотатках. Не додавай домовленостей чи дат.
- Кожне завдання має відповідальну особу і строк. Якщо строку немає, напиши без строку.
- Суми й дати переписуй точно так, як вони є в нотатках.
- Наприкінці випиши питання, на які нотатки не відповідають.
shablon.md
# Зустріч з КЛІЄНТ, ДАТА

Присутні
Домовленості
Завдання, особа, строк
Відкриті питання

Назва в полі name може містити лише малі латинські літери, цифри й дефіси, не більше 64 символів, і не може мати слів anthropic чи claude. У Claude Code поле name навіть необов'язкове, бо тоді назвою стає назва папки. Ми його задаємо, бо той самий скіл згодом може потрапити в застосунок Claude.

Файл shablon.md не займає місця в розмові, доки скіл його не потребує. Claude його відкриває, бо SKILL.md прямо його називає. Так працює кожен допоміжний файл, і скрипт теж, з якого в розмову потрапляє тільки результат.

Як протестувати скіл у Claude Code

Спершу перевірте, чи Claude взагалі бачить скіл. Введіть /skills або просто спитайте, які скіли доступні. Потім протестуйте двома способами. Перший раз вставте нотатки і звичайними словами напишіть, що хочете з них підсумок. Claude має сам узяти скіл, бо прохання підходить до опису. Другий раз введіть /pidsumok-zustrichi і вставте нотатки.

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

Якщо скіл не спрацьовує, проблема майже завжди в полі description. У ньому бракує слів, якими ви насправді просите це завдання. Коли в заголовку синтаксична помилка, скіл і далі запускається через скісну риску, але Claude не бачить опису і сам його не візьме. Команда claude plugin validate ~/.claude/skills у звичайному терміналі перевіряє заголовки всіх особистих скілів, починаючи з версії 2.1.233.

Правила Anthropic, які дають найбільшу різницю

Опис пишіть від третьої особи і конкретно. Він має казати, що скіл робить і коли його використовувати, словами, якими ви користуєтеся щодня. Як поганий приклад Anthropic наводить опис на кшталт допомагає з документами.

Пишіть коротко. Anthropic виходить з того, що Claude і так дуже здібний, тому в скілі має бути лише те, чого Claude не знає. Ваш шаблон, ваші правила, ваші винятки. Текст SKILL.md варто тримати в межах 500 рядків, а довші матеріали винести в окремі файли, на які веде пряме посилання з SKILL.md, без ланцюжка від файлу до файлу.

Найважливіші правила ставте нагору. Коли розмову стискають, щоб звільнити місце, Claude Code залишає з кожного використаного скіла лише перші 5000 токенів. Шляхи пишіть із прямою скісною рискою, навіть на Windows.

Скіл, який щось змінює назовні, наприклад надсилає повідомлення чи публікує сторінку, краще запускати тільки вручну. Для цього є рядок disable-model-invocation: true у заголовку. Тоді Claude не запустить його сам, навіть якщо вирішить, що він підходить.

Якщо той самий скіл має працювати в застосунку Claude, пам'ятайте про ліміт, який називає довідковий центр. Опис там може мати не більше 200 символів.

Skill-creator, скіл для написання скілів

Anthropic пропонує skill-creator, який допомагає писати й покращувати скіли. У Claude Code його встановлюють як плагін з офіційного маркетплейсу.

/plugin install skill-creator@claude-plugins-official

Після встановлення досить попросити Claude оцінити наявний скіл. Skill-creator зберігає тестові випадки у файлі evals/evals.json, запускає кожен у чистому контексті зі скілом і без нього, порівнює результати і пропонує кращий опис, якщо скіл спрацьовує не на ті прохання. Як працюють плагіни, пояснюємо в статті плагін у Claude Code, а готові скіли для прикладу є в статті про офіційні скіли.

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

Документація до теми

Що хочете змінити у своїй фірмі?

Залиште номер. Поговоримо про ваш процес і перевіримо, чи можемо допомогти. Перша розмова безкоштовна.

Коли зручно зателефонувати?
Адміністратор: Oleksandr Bondarenko (BondSoft)Політика конфіденційностіРегламент
Юридичні деталі

Адміністратором даних є Oleksandr Bondarenko, що веде господарську діяльність під фірмою Oleksandr Bondarenko Software Solutions (BondSoft), ul. Jana Heweliusza 11, 80-890 Gdańsk, NIP 5833576264, e-mail: office@bondsoft.pl.

Дані обробляємо виключно з метою контакту у справі вашого запиту та надання пропозиції — на підставі вашої згоди (ст. 6 ч. 1 п. a RODO та ст. 398 закону Prawo komunikacji elektronicznej) і нашого правомірного інтересу, що полягає в опрацюванні запиту (ст. 6 ч. 1 п. f RODO).

Надання даних добровільне, але необхідне для зворотного контакту. Згоду можете відкликати будь-коли, написавши на office@bondsoft.pl — це не впливає на законність обробки до відкликання.

Ви маєте право на доступ до даних, їх виправлення, видалення, обмеження обробки, перенесення, а також на скаргу до Голови Управління охорони персональних даних.

Повна інформація: Політика конфіденційності.

Напишіть на пошту

Послуга, про яку цей текст

Автоматизація та AI / OCR

Автоматизація переписування документів, OCR і правила перевірки, а дані лишаються у вас.