Anthropic, компанія, що створила Claude, оприлюднила внутрішній плейбук того, як її команди будують та використовують Claude Skills — від інженерів до маркетологів і юристів. Підприємець і розробник Остін Марчезе проаналізував інтерв’ю, блоги й офіційні документи Anthropic і показав, що базове уявлення про «скіли як markdown-файли» виявляється хибним. Насправді для продакшн-команд Claude Skill — це повноцінна папка з кодом, шаблонами та налаштуваннями, які роблять робочі процеси стабільнішими й дешевшими.
Claude Skill як папка, а не текстовий файл
Одне з ключових непорозумінь навколо Claude Skills пов’язане з тим, як їх уявляють. Багато хто вважає, що це просто один markdown-файл з інструкціями. Anthropic прямо називає це «поширеною хибною думкою».
У внутрішньому підході компанії skills — це не «просто текстові файли». Вони розглядаються як папки, які можуть містити скрипти, асети, дані та інші допоміжні матеріали. Агент Claude здатен ці файли «відкривати, досліджувати та змінювати» в межах цього робочого простору.
У підсумку, за формулюванням з плейбуку Anthropic, skill — це папка з набором компонентів. Саме композиція цих компонентів, а не один описовий промпт, визначає, наскільки потужним та надійним буде інструмент.
Такий підхід від самого початку віддаляє Claude Skills від класичного «довгого системного промпта». Йдеться не про одну гігантську інструкцію, а про структурований, файловий артефакт, який можна розвивати, версіонувати, тестувати і поступово ускладнювати.
Скрипти як «мотор» скіла: менше імпровізації, більше повторюваності
У цій файловій структурі Anthropic виділяє кілька ключових компонентів, без яких навряд чи варто говорити про продуманий skill. Перший і, за оцінкою компанії, один з найпотужніших — це скрипти.
Скрипт у цьому контексті — це просто комп’ютерний код, який виконує конкретне завдання. Anthropic формулює це дуже жорстко: один з найсильніших інструментів, які можна дати Claude, — це саме код. Якщо Claude отримує готові скрипти й бібліотеки, модель витрачає свої «ходи» на композицію, планування та ухвалення рішень, а не на відтворення шаблонного коду з нуля.
За таким підходом повторювані, добре визначені операції виносяться у скрипти, а сам Claude працює як оркестратор: вирішує, що саме запустити, як поєднати окремі частини, де потрібен додатковий аналіз чи креатив.
Критичний момент — поділ детермінованих і недетермінованих робочих процесів. Anthropic пропонує чітко відрізняти:
-
детерміновані workflows, де однаковий вхід завжди дає однаковий вихід (як «2 + 2 = 4»). Ці задачі ідеально підходять для скриптів, бо їх поведінка стабільна й передбачувана;
-
недетерміновані workflows, де один і той самий запит може породжувати різні коректні відповіді. Це типовий простір для LLM: формулювання тексту, варіанти пояснень, креативні рішення.
Чим більше детермінованої логіки перенесено в код, тим менше модель «імпровізує» там, де імпровізація не потрібна. У плейбуці це зводиться до простої тези: що більше функціоналу винесено у скрипти, то більш повторюваним буде результат і тим менше токенів знадобиться для досягнення того ж ефекту.
Для команд, які рахують гроші й борються за стабільність продакшн-виходів, цей баланс між «те, що повинен робити код» і «те, що повинен вирішувати Claude» стає одним із головних інженерних параметрів при проєктуванні skills.
Шаблони й асети: робити «як минулого разу», але автоматично
Другий «силовий» компонент, на який Anthropic окремо звертає увагу, — це асети й шаблони. Йдеться про файли, які завантажуються всередину skills-папки і служать цільовими формами вихідного результату.
У межах Claude Skill можна додати конкретні файли як шаблони бажаного аутпуту. Якщо очікується, що результатом роботи буде, скажімо, презентація, до папки додається попередній файл-зразок. Він потрапляє до каталогу assets і стає базовою формою, яку Claude заповнює новими даними.
З практичної точки зору це означає, що шаблон стає «каркасом» для нескінченної кількості звітів чи документів. Змінюється шаблон — автоматично змінюється й форма всіх наступних виходів, які генерує skill.
Anthropic підкреслює, що логіка тут така сама, як і зі скриптами: йдеться про поступове відмовляння від імпровізації. Мета — щоб skill припинив щоразу «вигадувати» структуру з нуля і почав послідовно відтворювати один і той самий формат.
Для команд це не лише про бренд-буки чи візуальний стиль. Навіть у суто технічних пайплайнах стабільні шаблони виводу — спосіб уніфікувати формати, спростити подальшу обробку й інтеграцію в інші системи.
Setup-промпти: скіли мають бути зрозумілими не лише для Claude
Третій ключовий елемент всередині папки — так звані setup-промпти та супровідні файли конфігурації, які роблять skills зрозумілими й керованими для людей, а не тільки для моделі.
Anthropic апелює до відомого принципу програмування: будь-хто може написати код, який зрозуміє комп’ютер, але хороші розробники пишуть код, який зрозумілий людям. У світі skills це транслюється у формулу: будь-хто може написати інструкцію, яку зрозуміє Claude; найкращі пишуть skills так, щоб їх легко читали й використовували люди.
Щоб цього досягти, у плейбуку пропонують кілька технічних прийомів.
По-перше, створити файл config.json. Він працює як система первинної ініціалізації: під час першого запуску, якщо бракує критичного параметра, skill не намагається «здогадатися», а явно запитує саме цю інформацію. Введені значення зберігаються, тож надалі їх не потрібно повторювати. Це дозволяє скілу «пам’ятати» налаштування задачі й скорочувати тертя при повторному використанні.
По-друге, активно використовувати вбудований механізм «ask user question». У Anthropic пропонують у skill.md визначати, де Claude має не просто чекати вільного тексту, а показувати структуровані варіанти відповіді — наприклад, у вигляді множинного вибору. Це наближає досвід роботи зі skill до «інтерв’ю-флоу», де користувача крок за кроком проводять через чітку послідовність рішень.
По-третє, на самому початку файлу skill.md рекомендується оголошувати поле arguments. Воно слугує пам’яткою: коли хтось викликає цей skill, arguments прямо показує, які саме вхідні дані потрібні для коректного запуску. Це не стільки інструкція для Claude, скільки підказка для колег чи для самого автора через рік-два, коли деталі забудуться.
Anthropic наголошує: будуючи skills, варто орієнтуватися не на себе «сьогодні», а на себе через один-три роки. Системи, що накопичують цінність з часом, вимагають інвестицій у читабельність, прозорість і самодокументованість.
Як технічна архітектура skills економить токени й нерви
Якщо звести підхід Anthropic до Claude Skills в одну лінію, він впирається в дуже інженерну оптику: skill — це не магічний промпт, а невеликий застосунок у вигляді папки.
Скрипти відділяють детерміновану логіку від креативної, зменшуючи потребу в довгих промптах і повторній генерації «бойлерплейту». Шаблони й асети фіксують формат результатів, знімаючи з Claude тягар проєктування структури кожного разу. Setup-промпти, config.json, arguments і «опитування користувача» роблять skills придатними для тривалої, спільної експлуатації без постійного заглиблення у вихідний код.
Anthropic прямо пов’язує обсяг логіки, винесеної в ці компоненти, із двома ключовими метриками: повторюваністю виходів і кількістю використаних токенів. Чим більше інструкцій та обчислень зашито у файли всередині папки, тим рідше Claude доводиться генерувати зайвий текст, відтворювати однотипні фрагменти чи «вигадувати» механіку процесу.
Для команд, які будують на Claude реальні робочі процеси, це змінює саме мислення про skills. Замість того, щоб сприймати їх як «розумні markdown-и», Anthropic пропонує бачити в них маленькі, еволюційні програмні модулі, де кожен файл — це частина системи: код, форма виходу, конфігурація чи інтерфейс взаємодії з людиною.
Висновок: від промптів до системи папок
Внутрішній плейбук Anthropic показує, що Claude Skills проектуються радше як набір компонентів в одній папці, ніж як один довгий текстовий опис. Папка зі скриптами, шаблонами, конфігураціями та setup-промптами дозволяє відокремити стабільну, детерміновану логіку від змінних і креативних частин, знизити витрати токенів і зробити виходи відтворюваними.
Для продакшн-команд це означає, що робота зі skills наближається до звичної інженерної практики: проєктування структури, інкапсуляція логіки в код, використання шаблонів, документування аргументів і налаштувань. У такій моделі Claude залишається тим, чим найкраще вміє бути, — універсальним композитором і координатором, який працює поверх надійної файлової основи.