Що таке Claude Skills і навіщо вони потрібні

Claude Skills — це модульні пакети інструкцій, які навчають Claude виконувати конкретні задачі на професійному рівні. Кожен Skill — це папка з файлом SKILL.md, який містить YAML-метадані та Markdown-інструкції. Anthropic представила цей формат у жовтні 2025 і опублікувала як відкритий стандарт у грудні 2025.

Ключова ідея: замість одного гігантського system prompt, Claude завантажує тільки потрібні інструкції. На старті сесії він бачить лише назви і описи Skills (~100 токенів на Skill). Коли задача відповідає певному Skill — завантажуються повні інструкції. Це економить токени та підвищує якість.

Вбудований Skill Що робить Формат виходу
pdf Генерує PDF-звіти з правильним форматуванням .pdf
docx Створює Word-документи зі стилями та структурою .docx
pptx Будує презентації зі слайдами та дизайном .pptx
xlsx Генерує таблиці з формулами та форматуванням .xlsx
frontend-design Створює веб-компоненти та UI .html/.jsx
data-analysis Аналізує дані та будує графіки .html/.png

Підключивши будь-який із цих Skills до n8n workflow, ви отримуєте автоматичну генерацію документів через веб-форму із завантаженням на Google Drive.

Чим Skills відрізняються від Projects у Claude?

Projects зберігають контекст в одному місці для одного користувача. Skills — портативні та модульні: ви створюєте Skill один раз, і він працює скрізь — у Claude.ai, Claude Code, через API, і навіть у сторонніх інструментах (Cursor, Codex). Плюс Skills можна ділитися з командою та спільнотою.

Архітектура workflow: від промпту до файлу

📋
Form
Trigger
→
🔀
Switch
File Type
→
🤖
Anthropic
API + Skill
→
📝
Code
Extract ID
→
📥
Files API
Download
→
☁️
Google
Drive

Як це працює:

  • Form Trigger — веб-форма, де користувач вводить промпт і обирає тип документа (PDF/DOCX/PPTX/XLSX)
  • Switch — маршрутизує запит до відповідної ноди з правильним system prompt та skill_id
  • Anthropic API — HTTP Request до Messages API з Code Execution та вказаним Skill
  • Code Node — рекурсивно шукає file_id у відповіді (вкладена структура)
  • Files API — завантажує згенерований файл за file_id
  • Google Drive — автоматично зберігає файл у вказану папку

Налаштовуємо Anthropic API у n8n

Claude Skills працюють через Anthropic Messages API з увімкненим Code Execution. Стандартна нода «Anthropic» в n8n не підтримує Skills — тому ми використовуємо HTTP Request.

У n8n переходимо в Settings → Credentials і створюємо новий credential типу HTTP Header Auth:

Name: x-api-key Value: sk-ant-api03-ваш-ключ-тут

У кожному HTTP Request до Anthropic додаємо обов'язкові заголовки:

anthropic-version: 2023-06-01 anthropic-beta: code-execution-2025-05-14 Content-Type: application/json
Важливо: beta-заголовок

Без заголовка anthropic-beta: code-execution-2025-05-14 Skills не працюватимуть. Code Execution — це бета-функція, яка дозволяє Claude запускати Python-код у ізольованому контейнері для генерації файлів. Перевіряйте актуальну версію beta у документації Anthropic.

Form Trigger + Switch: маршрутизація за типом документа

Додаємо ноду Form Trigger з двома полями:

Field 1: Type: Text (multiline) Label: "Опишіть документ, який потрібно створити" Field 2: Type: Dropdown Label: "Тип файлу" Options: - PPTX (Презентація) - PDF (Звіт) - DOCX (Документ) - XLSX (Таблиця)

Після Form Trigger додаємо ноду Switch, яка маршрутизує запит за значенням поля «Тип файлу»:

Rule 1: {{ $json.file_type }} contains "PPTX" → Output 1 (Presentation node) Rule 2: {{ $json.file_type }} contains "PDF" → Output 2 (PDF node) Rule 3: {{ $json.file_type }} contains "DOCX" → Output 3 (Document node) Rule 4: {{ $json.file_type }} contains "XLSX" → Output 4 (Spreadsheet node)

Кожен Output веде до окремої HTTP Request ноди з власним system prompt, оптимізованим під конкретний формат. Це ключова деталь: промпти для презентацій, звітів і таблиць суттєво відрізняються.

Підключаємо Claude зі Skills та Code Execution

Кожна гілка Switch веде до HTTP Request ноди, яка викликає Anthropic Messages API. Ось приклад body-запиту для генерації PDF:

{ "model": "claude-sonnet-4-20250514", "max_tokens": 16000, "tools": [{ "type": "code_execution", "name": "code_execution" }], "system": "Ти — професійний дизайнер документів. Створюй PDF-звіти з чіткою структурою, типографікою та візуальною ієрархією. Використовуй Python-бібліотеки для генерації.", "messages": [{ "role": "user", "content": {{ $json.prompt }} }] }

Для PPTX system prompt буде іншим — з акцентом на слайди, візуальний дизайн та структуру презентації. Для XLSX — на формули, форматування комірок та діаграми.

Як Claude використовує Skills під капотом

Коли ви передаєте code_execution у tools, Claude отримує доступ до ізольованого Python-контейнера. Він пише код (наприклад, з використанням python-pptx, reportlab, openpyxl), виконує його, і результат — готовий файл — зберігається у Files API Anthropic з унікальним file_id. Саме цей file_id ми витягуємо на наступному кроці.

Опціонально: вказати конкретний Skill

Якщо ви хочете використати конкретний custom skill, додайте поле "skills" з масивом skill_id у body запиту. Для вбудованих Skills (pdf, docx, pptx, xlsx) це не обов'язково — Claude автоматично знаходить потрібний Skill за контекстом задачі.

Витягуємо файл та завантажуємо на Google Drive

Відповідь Anthropic API — це масив content blocks різних типів: text, code_execution, tool_use, tool_result. File_id може бути глибоко вкладеним. Тому потрібен рекурсивний пошук через Code Node:

function findFileId(obj) { if (!obj || typeof obj !== 'object') return null; // Шукаємо поле file_id if (obj.file_id) return obj.file_id; // Рекурсивно обходимо вкладені об'єкти for (const key of Object.keys(obj)) { const result = findFileId(obj[key]); if (result) return result; } // Масиви теж обходимо if (Array.isArray(obj)) { for (const item of obj) { const result = findFileId(item); if (result) return result; } } return null; } const response = items[0].json; const fileId = findFileId(response); if (!fileId) throw new Error('File ID not found'); return [{ json: { file_id: fileId } }];

Далі додаємо HTTP Request для завантаження файлу з Anthropic Files API:

Method: GET URL: https://api.anthropic.com/v1/files/{{ $json.file_id }}/content Headers: x-api-key: {{ $credentials.anthropicApi.apiKey }} anthropic-version: 2023-06-01 anthropic-beta: files-api-2025-04-14 Response: File (binary)

Останній крок — нода Google Drive (Create File), яка завантажує бінарний файл у вказану папку:

Operation: Upload File Name: {{ $json.file_name || "document" }}.pdf Parent Folder: ID вашої папки Google Drive Input Data: Binary (з попередньої ноди)
Google Drive OAuth2 — обов'язкове налаштування

Створіть OAuth2 credential для Google Drive в n8n: Settings → Credentials → Google Drive OAuth2. Потрібен Google Cloud проєкт з увімкненим Drive API та налаштованим OAuth consent screen. Redirect URI: https://ваш-n8n.com/rest/oauth2-credential/callback.

Створення власних Skills

Вбудовані Skills — це лише початок. Ви можете створювати власні Skills для будь-яких задач: генерація контрактів за шаблоном, звіти з корпоративним брендингом, специфічні формати для вашої галузі.

Структура SKILL.md

Мінімальний приклад Skill'у для корпоративних звітів:

--- name: brand-report description: Генерує PDF-звіти у корпоративному стилі з логотипом, кольорами бренду та стандартними шаблонами заголовків/футерів. --- # Brand Report Generator ## Коли використовувати Тригер: користувач просить створити звіт, аналітику або документ у корпоративному стилі. ## Інструкції 1. Використовуй кольори бренду: #1A1A2E, #E94560 2. Шрифти: заголовки — Montserrat Bold, текст — Open Sans Regular 3. Логотип завжди у верхньому правому куті 4. Футер: "© 2026 CompanyName. Конфіденційно." ## Python-залежності - reportlab - Pillow

Skills можна зберігати у GitHub-репозиторії та підтягувати в n8n через GitHub API. Це дає версіонування, спільний доступ і можливість оновлювати Skills без зміни workflow.

Де зберігати Skills Плюси Мінуси
GitHub repo Версіонування, спільна робота, CI/CD Потрібен додатковий API-виклик
Claude.ai Settings Працює «з коробки», зручний UI Тільки для Claude.ai, не API
Локальна папка Швидко, без залежностей Тільки для Claude Code
n8n Static Data Все в одному workflow Складно підтримувати

Тестуємо та запускаємо

Перед запуском протестуйте кожен сценарій:

  • Form Trigger відкривається за URL і приймає промпт + тип файлу
  • Switch коректно маршрутизує запити (перевірте кожну гілку)
  • Anthropic API повертає відповідь з content blocks (перевірте Executions)
  • Code Node знаходить file_id у відповіді
  • Files API повертає бінарний файл (не помилку 404)
  • Google Drive отримує файл із правильним ім'ям та розширенням
  • Документ відкривається і має коректне форматування
Типові помилки

401 від Anthropic — перевірте x-api-key. Files API 404 — file_id витягнутий неправильно; перевірте рекурсивну функцію. Порожній файл — Claude не зміг виконати код; перевірте system prompt та переконайтесь, що beta-заголовок правильний. Google Drive 403 — OAuth2 credential потребує переавторизації.

Часті питання

Що таке Claude Skills?

Claude Skills — це модульні інструкції у форматі SKILL.md, які Claude завантажує за потребою. Кожен Skill містить YAML-метадані і Markdown-інструкції. Anthropic представила формат у жовтні 2025 і опублікувала як відкритий стандарт у грудні 2025. Підтримується Claude Code, Claude.ai, API, а також OpenAI Codex, Cursor, Gemini CLI.

Скільки коштує генерація документів?

Оплата за токени Anthropic API. На моделі Claude Sonnet 4 — ~$3/1M input, $15/1M output. Один документ (PDF/DOCX) зазвичай споживає 2000–5000 токенів input + 3000–8000 output. Вартість: ~$0.05–0.15 за документ. Code Execution входить у вартість API. n8n self-hosted — безкоштовний.

Чи можна використовувати свої Python-бібліотеки?

Code Execution контейнер Anthropic має набір передвстановлених бібліотек: reportlab, python-pptx, openpyxl, Pillow, matplotlib, pandas та інші. Встановити довільні pip-пакети не можна — контейнер ізольований. Але для більшості задач з генерації документів цього достатньо.

Чи працюють Skills з іншими AI?

Так. Anthropic опублікувала Agent Skills як відкритий стандарт на agentskills.io. Той самий формат SKILL.md підтримується Claude Code, Claude.ai, Claude API, OpenAI Codex, Cursor, Gemini CLI, Antigravity та Windsurf. Ви створюєте Skill один раз — і використовуєте скрізь.

Чим це відрізняється від звичайного промпту в OpenAI?

Три ключові відмінності: Skills завантажуються прогресивно (економія токенів); Code Execution дозволяє Claude запускати Python і генерувати реальні бінарні файли (не просто текст); Skills портативні та модульні — ви можете будувати бібліотеку спеціалізацій, яка масштабується без зростання system prompt.